logo

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

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

演示 EBT 模块 下载 EBT 模块

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

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

演示 EPT 模块 滚动

滚动
06/10/2025, by Ivan

现在,当你已经完成了 Drupal 8 的安装,你可以通过安装 模块 来为网站添加更多功能,或者通过 安装主题 来调整你的网站外观和样式。

标准的 Drupal 核心安装功能有限,外观也相对简单。然而,Drupal 的设计是模块化的,这意味着它可以通过模块和主题轻松扩展。

在 Drupal.org 上提供的众多模块和主题中,每一个都被称为“项目(project)”,并且它们都是免费的。这些项目通常被称为“contrib”(贡献项目),因为它们由像你一样的 Drupal 社区成员创建并贡献。

在很多情况下,你会发现有人已经编写并上传了正好提供你所需功能的项目。

查找并导入模块或主题到你的网站的过程基本相同。

模块

模块为网站提供功能,而标准安装中包含的“核心模块”提供了大多数网站所需的基本功能。

06/10/2025, by Ivan

要查找模块,请访问 模块主页。要查找主题,请从 主题主页 开始。

正如你所看到的,搜索选项很多,但最重要的是核心兼容性。请将其设置为 “8.x”,以便只显示适用于 Drupal 8 的模块。你也可以调整其他筛选条件,并在“搜索模块”文本框中输入关键字。默认的“排序依据”选项是“安装最多”,这意味着搜索结果将优先显示最受欢迎的模块。

在搜索结果页面上,每个模块(或主题)的“名称”都是指向其项目主页的链接。

模块项目页面

模块项目页面的详细程度各不相同,因为每个页面的内容都由模块开发者维护。

建议仔细阅读项目页面。

例如,如果模块依赖于其他模块或额外的“库”,相关信息会在页面中列出。不过,如果你忘记安装模块或库依赖,也不用担心 —— 当你尝试启用或使用该模块时,Drupal 会提示你缺少依赖项。

06/10/2025, by Ivan

Composer 是 PHP 的包管理器。它提供了与 Drupal 内置依赖管理和 Drush make 类似的功能,但适用于任何 PHP 项目,而不仅仅是 Drupal 模块。许多 Drupal 8 模块依赖于通用的 PHP 包,这些包需要通过 Composer 引入到网站的代码库中。

哪些模块具有 Composer 依赖项?

有几种方法可以判断模块是否具有 Composer 依赖项:

  • 在其项目页面或 README / INSTALL 文件中说明了相关依赖。
  • 模块的根目录中包含一个 composer.json 文件。
  • #2494073: 禁止安装缺少 Composer 依赖的模块 更新后,Drupal 核心会自动提示此类模块的依赖情况。

如何安装模块的 Composer 依赖项?

简而言之,始终使用 Composer 安装模块。运行以下命令:

06/10/2025, by Ivan

除了通过用户界面安装模块外,你还可以通过命令行下载并安装模块:

从命令行下载和安装模块是扩展你网站的最快方法。

Drush

在 Drush 8 中,你可以使用以下命令下载模块:

06/10/2025, by Ivan

大多数提供的模块都会定期更新,以修复安全问题、改进模块功能或添加新特性,甚至三者兼有。建议你定期检查所使用模块的新版本,并在新版本发布时及时更新。

模块更新的过程在用户指南中有详细说明,请阅读 第 13.6 章:“更新模块”

如果你使用 Composer 来管理网站,请阅读 通过 Composer 更新模块的说明

06/10/2025, by Ivan

进入“扩展”页面,如果你还未在该页面上。

在“扩展”页面中,表格的每一行对应一个模块,最左侧是一个复选框,右侧紧接着是模块名称。

在模块名称右侧的第三列是模块的描述。

如果你看不到描述

如果你看不到每个模块名称右侧的描述,那么说明你的管理主题的“响应式”设计隐藏了描述。

此问题及其解决方法已在 “显示‘扩展’页面上被隐藏模块描述的修复方法” 中详细讨论。以下是这些解决步骤的简要概述。

快速修复方案:显示“扩展”页面上被隐藏的描述

关闭左侧垂直管理菜单(如果已打开)。

如果仍然看不到描述,请执行以下三种操作之一,这些操作已在 “显示‘扩展’页面隐藏模块描述的修复方法” 中详细介绍。

“手风琴”描述切换按钮

06/10/2025, by Ivan

有些模块实际上不需要你执行任何操作,它们只是默默地在后台运行。然而,这些模块通常没有可配置的参数,或仅作为其他模块的依赖项存在。

多数情况下,你感兴趣的模块是可以配置权限和参数的模块。一些项目非常易用,也就是说,它们的使用是“直观的”,你可以很容易理解哪些选项可配置,以及如何实现你的目标。

如果你想要了解所有细节,以便更聪明地使用刚安装的模块,我能想到一些你可能需要知道的事情,或一些你可以查阅的地方。

以下建议按使用的简易程度排列。

对于像我们这样的新手终端用户来说,不幸的是,Drupal 仍在不断发展中。尽管我们很幸运能自由地受益于开发者的辛勤工作,但他们的时间有限,而且我敢说,最优秀的开发者往往不是最勤奋的文档编写者,否则你和我现在也不会在这里。

我建议你在学习使用 Drupal 的过程中记录并发布你的经验与困难,这将帮助未来几天、几个月、几年里成千上万与你处境相同的人。

我将此视为撰写这份文档的最终使命,尽管(或者说正因为)这意味着无尽的挫折与挑战——使用 Drupal 的新文档系统,并在一定程度上缓解学习和使用 Drupal 时的困难。如果早期有像你我这样的新手写下清晰的指导文档,我们就不会走这么多弯路。不过我很高兴,我的朋友,你将从中受益。

06/10/2025, by Ivan

这是一个临时占位内容。部分材料应从 安装 Drupal 8 模块 | Drupal.org 上的 Drupal 8 指南 中移到此处。

要删除未使用的模块,你必须确保该模块确实未在网站上使用,以免影响任何功能。
你可以使用 Drush 或管理界面来删除模块。

使用 Drush

前提条件:你的计算机上必须已安装 Drush。
要安装 Drush,请参阅 如何安装 Drush

运行以下 Drush 命令以删除模块:

drush pm-uninstall module_name

或使用 Drush 的简写命令:

drush pmu module_name

然后通过以下命令清除缓存: