logo

额外区块类型 (EBT) - 全新的布局构建器体验❗

额外区块类型 (EBT) - 样式化、可定制的区块类型:幻灯片、标签页、卡片、手风琴等更多类型。内置背景、DOM Box、JavaScript 插件的设置。立即体验布局构建的未来。

演示 EBT 模块 下载 EBT 模块

❗额外段落类型 (EPT) - 全新的 Paragraphs 体验

额外段落类型 (EPT) - 类似的基于 Paragraph 的模块集合。

演示 EPT 模块 滚动

滚动

安装 Drupal 8 模块

06/10/2025, by Ivan

安装一个或多个模块,以便通过附加功能修改、扩展或改进 Drupal。

必要的知识

步骤 1:获取模块

如果要安装的模块是 Drupal 核心的一部分,你可以直接跳到下一步。

要安装模块,首先需要获取模块的源代码。推荐的方式是使用 Composer 将模块作为依赖添加到你的项目中。这假设你已经在使用 Composer 管理你的项目

要添加一个 模块,请先确定它的机器名称。这是项目页面 URL 的最后一部分。例如,模块 Geofield 的地址为 https://www.drupal.org/project/geofield,其机器名称为 geofield

要下载该模块及其依赖项,请在网站根目录中运行以下命令(将 geofield 替换为你的模块名称):

composer require drupal/geofield

执行命令后,你将看到一条消息,表示模块已作为依赖项添加到 composer.json 文件中,并且相关代码已下载。

更多信息和视频演示请参阅:使用 Composer 下载和更新文件使用 Composer 下载模块和主题

其他获取模块的方式包括:

步骤 2:启用模块

使用 Drupal 界面:

  • 通过“管理”菜单进入“扩展”页面(/admin/modules)。
  • 找到要启用的模块,在每个模块旁勾选复选框。
  • 点击“安装”以启用新模块。

使用 Drush:

drush en geofield

更多信息和视频演示请参阅:从 Drupal.org 下载并安装模块通过命令行安装模块

附加信息

模块存放结构

Drupal 会在多个位置查找模块:推荐使用根目录下的 /modules 目录,或者 /sites/*/modules 目录。Drupal 会遍历这些目录中的所有子文件夹以查找模块。

通常的做法是:将从 Drupal.org 下载的所有模块放在 /modules/contrib 目录中,而将包含自定义代码的项目模块放在 /modules/custom 目录中。

单个项目包含多个模块

通常,一个项目(例如 https://drupal.org/project/devel)包含多个模块。每个模块都会在“扩展”页面上单独列出,并可以单独启用。

更多资源