
现在,当你已经完成了 Drupal 8 的安装,你可以通过安装 模块 来为网站添加更多功能,或者通过 安装主题 来调整你的网站外观和样式。
标准的 Drupal 核心安装功能有限,外观也相对简单。然而,Drupal 的设计是模块化的,这意味着它可以通过模块和主题轻松扩展。
在 Drupal.org 上提供的众多模块和主题中,每一个都被称为“项目(project)”,并且它们都是免费的。这些项目通常被称为“contrib”(贡献项目),因为它们由像你一样的 Drupal 社区成员创建并贡献。
在很多情况下,你会发现有人已经编写并上传了正好提供你所需功能的项目。
查找并导入模块或主题到你的网站的过程基本相同。
模块
模块为网站提供功能,而标准安装中包含的“核心模块”提供了大多数网站所需的基本功能。


要查找模块,请访问 模块主页。要查找主题,请从 主题主页 开始。
正如你所看到的,搜索选项很多,但最重要的是核心兼容性。请将其设置为 “8.x”,以便只显示适用于 Drupal 8 的模块。你也可以调整其他筛选条件,并在“搜索模块”文本框中输入关键字。默认的“排序依据”选项是“安装最多”,这意味着搜索结果将优先显示最受欢迎的模块。
在搜索结果页面上,每个模块(或主题)的“名称”都是指向其项目主页的链接。
模块项目页面
模块项目页面的详细程度各不相同,因为每个页面的内容都由模块开发者维护。
建议仔细阅读项目页面。
例如,如果模块依赖于其他模块或额外的“库”,相关信息会在页面中列出。不过,如果你忘记安装模块或库依赖,也不用担心 —— 当你尝试启用或使用该模块时,Drupal 会提示你缺少依赖项。


安装一个或多个模块,以便通过附加功能修改、扩展或改进 Drupal。
必要的知识
步骤 1:获取模块
如果要安装的模块是 Drupal 核心的一部分,你可以直接跳到下一步。


Composer 是 PHP 的包管理器。它提供了与 Drupal 内置依赖管理和 Drush make 类似的功能,但适用于任何 PHP 项目,而不仅仅是 Drupal 模块。许多 Drupal 8 模块依赖于通用的 PHP 包,这些包需要通过 Composer 引入到网站的代码库中。
哪些模块具有 Composer 依赖项?
有几种方法可以判断模块是否具有 Composer 依赖项:
- 在其项目页面或 README / INSTALL 文件中说明了相关依赖。
- 模块的根目录中包含一个 composer.json 文件。
- 在 #2494073: 禁止安装缺少 Composer 依赖的模块 更新后,Drupal 核心会自动提示此类模块的依赖情况。
如何安装模块的 Composer 依赖项?
简而言之,始终使用 Composer 安装模块。运行以下命令:


除了通过用户界面安装模块外,你还可以通过命令行下载并安装模块:
- 推荐的模块(和主题)下载方式是使用 Composer。不过,你仍然可以使用 Drush 8 或 Drupal Console 下载模块,但这种方式不会更新你的 composer.json 文件。
- Drush 和 Drupal Console 都可以为你安装模块和主题。(在 Drupal 8 中,安装和启用模块是同一个操作。)
从命令行下载和安装模块是扩展你网站的最快方法。
Drush
在 Drush 8 中,你可以使用以下命令下载模块:


Drupal 8 将所有核心主题放在 /core/themes 目录中,而所有自定义或贡献主题放在网站根目录下的 /themes 目录中。有关详细信息,请查看 /themes 目录中的 README.txt 文件。


大多数提供的模块都会定期更新,以修复安全问题、改进模块功能或添加新特性,甚至三者兼有。建议你定期检查所使用模块的新版本,并在新版本发布时及时更新。
模块更新的过程在用户指南中有详细说明,请阅读 第 13.6 章:“更新模块”。
如果你使用 Composer 来管理网站,请阅读 通过 Composer 更新模块的说明。


进入“扩展”页面,如果你还未在该页面上。
在“扩展”页面中,表格的每一行对应一个模块,最左侧是一个复选框,右侧紧接着是模块名称。
在模块名称右侧的第三列是模块的描述。
如果你看不到描述
如果你看不到每个模块名称右侧的描述,那么说明你的管理主题的“响应式”设计隐藏了描述。
此问题及其解决方法已在 “显示‘扩展’页面上被隐藏模块描述的修复方法” 中详细讨论。以下是这些解决步骤的简要概述。
快速修复方案:显示“扩展”页面上被隐藏的描述
关闭左侧垂直管理菜单(如果已打开)。
如果仍然看不到描述,请执行以下三种操作之一,这些操作已在 “显示‘扩展’页面隐藏模块描述的修复方法” 中详细介绍。
“手风琴”描述切换按钮


有些模块实际上不需要你执行任何操作,它们只是默默地在后台运行。然而,这些模块通常没有可配置的参数,或仅作为其他模块的依赖项存在。
多数情况下,你感兴趣的模块是可以配置权限和参数的模块。一些项目非常易用,也就是说,它们的使用是“直观的”,你可以很容易理解哪些选项可配置,以及如何实现你的目标。
如果你想要了解所有细节,以便更聪明地使用刚安装的模块,我能想到一些你可能需要知道的事情,或一些你可以查阅的地方。
以下建议按使用的简易程度排列。
对于像我们这样的新手终端用户来说,不幸的是,Drupal 仍在不断发展中。尽管我们很幸运能自由地受益于开发者的辛勤工作,但他们的时间有限,而且我敢说,最优秀的开发者往往不是最勤奋的文档编写者,否则你和我现在也不会在这里。
我建议你在学习使用 Drupal 的过程中记录并发布你的经验与困难,这将帮助未来几天、几个月、几年里成千上万与你处境相同的人。
我将此视为撰写这份文档的最终使命,尽管(或者说正因为)这意味着无尽的挫折与挑战——使用 Drupal 的新文档系统,并在一定程度上缓解学习和使用 Drupal 时的困难。如果早期有像你我这样的新手写下清晰的指导文档,我们就不会走这么多弯路。不过我很高兴,我的朋友,你将从中受益。


这是一个临时占位内容。部分材料应从 安装 Drupal 8 模块 | Drupal.org 上的 Drupal 8 指南 中移到此处。
要删除未使用的模块,你必须确保该模块确实未在网站上使用,以免影响任何功能。
你可以使用 Drush 或管理界面来删除模块。
使用 Drush
前提条件:你的计算机上必须已安装 Drush。
要安装 Drush,请参阅 如何安装 Drush。
运行以下 Drush 命令以删除模块:
drush pm-uninstall module_name
或使用 Drush 的简写命令:
drush pmu module_name
然后通过以下命令清除缓存:
