roundearth/drupal-civicrm-project

基于CiviCRM的Drupal项目模板

8.x-dev 2020-04-21 14:45 UTC

This package is auto-updated.

Last update: 2024-09-29 05:28:12 UTC


README

本项目模板为使用Composer管理Drupal 8和CiviCRM网站提供了一套启动工具。

它基于drupal/recommended-project,因此请参阅该文档以获取关于通过Composer管理Drupal的一般信息。

这里的文档将专注于CiviCRM!

用法

首先需要几个依赖项

请确保您有Composer的最新版本!有几个人尝试使用较旧版本的项目并遇到了问题。

然后您可以通过以下方式创建新项目

composer create-project roundearth/drupal-civicrm-project:8.x-dev some-dir --no-interaction

Drupal将被安装在web目录下,而vendor目录位于webroot之外。这遵循当前的最佳实践,但也意味着两件事

  • 您需要将您的web服务器指向web目录,而不是像您可能习惯于Drupal 7或非Composer Drupal 8站点中的顶级目录。
  • CiviCRM的网络资产被同步到web/libraries/civicrm目录,因此您需要配置CiviCRM的“资源URL”以指向将到达该目录的URL。

安装CiviCRM

使用上面的命令行获取代码并完成正常的Drupal 8安装后,执行以下步骤安装CiviCRM

  1. 确保web/sites/default目录可写。在命令行中

     chmod +w web/sites/default
    
  2. 启用CiviCRM模块。在命令行中

     drush en -y civicrm
    
  3. 如果您已经登录到Drupal站点,那么请注销并再次登录。这是为了解决CRM-19878错误。

它是如何工作的?

它基本上是“drupal/recommended-project”,增加了一个特殊的Composer插件,该插件为CiviCRM执行所有额外的步骤。因此,如果您想了解其行为或做出贡献,请参阅Composer插件

https://lab.civicrm.org/dev/civicrm-asset-plugin

参考资料