查找 Drupal 模块
要查找模块,请访问 模块主页。要查找主题,请从 主题主页 开始。
正如你所看到的,搜索选项很多,但最重要的是核心兼容性。请将其设置为 “8.x”,以便只显示适用于 Drupal 8 的模块。你也可以调整其他筛选条件,并在“搜索模块”文本框中输入关键字。默认的“排序依据”选项是“安装最多”,这意味着搜索结果将优先显示最受欢迎的模块。
在搜索结果页面上,每个模块(或主题)的“名称”都是指向其项目主页的链接。
模块项目页面
模块项目页面的详细程度各不相同,因为每个页面的内容都由模块开发者维护。
建议仔细阅读项目页面。
例如,如果模块依赖于其他模块或额外的“库”,相关信息会在页面中列出。不过,如果你忘记安装模块或库依赖,也不用担心 —— 当你尝试启用或使用该模块时,Drupal 会提示你缺少依赖项。
下载区域
项目页面始终包含指向该模块不同版本的下载链接。
“问题(Issues)”部分
模块项目页面始终包含标题为“问题(Issues)”的链接。这些链接位于浏览器窗口足够宽时的右侧栏中;如果窗口较窄,它们会显示在页面底部的“下载”和“维护者”部分之后。
“问题(Issues)”链接会跳转到该模块的“问题队列(issue queue)”。这是官方用于报告错误(“Bug report”)、请求支持(“Support request”)或提出新功能(“Feature request”)的地方。
因此,如果你在使用模块时遇到问题,请前往该模块的“问题队列”。如果你的问题尚未解决,请点击“创建新问题(Create a new issue)”提交反馈,社区成员会尝试帮助你。
资源(Resources)
在“问题(Issues)”部分下方的“资源(Resources)”区域中,我通常会寻找“阅读文档(Read documentation)”链接。此链接并非所有模块都具备,但如果有,它将指向开发者认为对用户最有帮助的文档。
“阅读文档”链接可能指向 drupal.org 的文档页面,也可能跳转到外部网站。
通常,每个贡献模块(contrib module)的顶级目录中都会包含 “README.txt” 和/或 “INSTALL.txt” 文件。你可以在下载模块后或导入网站后查看这些文件。
关于模块(或主题)的其他文档资源会在其他部分详细讨论。目前请注意,你可以按照下文“模块文档与帮助”部分的说明,在不下载模块的情况下查看任何项目的 README.txt 文件或文档。
理解模块的不同版本
在项目页面的“下载”部分,你会看到“推荐版本(Recommended releases)”、“其他版本(Other releases)”和“开发版本(Development releases)”等子标题。
下图为 Drupal 7 示例,但足以说明概念。
你选择的模块版本必须与你使用的 Drupal 核心版本兼容。既然你使用的是 Drupal 8,那么只能使用以 “8.x-...” 开头的版本。
推荐版本
找到针对 Drupal 8 的最新版本。这是最推荐的版本,通常位于“推荐版本(Recommended releases)”标题下,表示该版本足够稳定,适合在生产环境中使用。
其他版本
如果没有推荐版本,则可以尝试“其他版本(Other releases)”。
“其他版本”通常是未来即将成为“推荐版本”的候选版本。
但在少数情况下,“其他版本”可能是较旧的稳定版本,在重大更新发布前保留。保留旧版本的原因之一是某些依赖模块仍需使用旧版本才能正常运行。
开发版本
“开发版本(Development releases)”表示该模块仍处于开发阶段,开发者可能正在修复错误或添加新功能。
请注意,“开发版本”可能针对未来的 Drupal 核心版本。例如,即使当前推荐的核心版本是 Drupal 8.2,模块的开发版本可能是为未来的 8.3 准备的,其中可能包含当前核心版本中尚未存在的功能。
“版本”列
此列显示该模块的具体版本号。
有关版本编号规则的详细说明,请参阅“模块和主题的版本号含义”。
“下载”列
此列包含用于实际下载模块的链接。