安装Drupal 8模块

hrs 提交于 2019/07/25 - 21:52 , 周四

我建议如果您正在尝试以前没有使用过的模块,请一次只安装一个“new-to-you”模块。在您转到另一个模块之前,请根据需要彻底测试第一个模块,看看它如何改变您网站上的内容,特别是它是否会破坏已经正常工作的内容。

内容

  1. 代码库中新安装模块的位置

  2. 导入模块

  3. 启用模块

  4. 关于卸载Drupal 8模块与Drupal 7模块的说明

代码库中新安装模块的位置

您可以通过两个“自动”流程之一将新的Drupal模块安装到“本地”或“在线”网站,或者您可以“手动”执行此操作。

所有单个模块的文件和文件夹都将包含在该模块特有的单个“父文件夹”中。该父文件夹的命名方式与模块本身类似,使用小写字母字符,偶尔在多个单词之间使用下划线字符(“_”)。

自动导入位置

使用下面讨论的两个自动化过程之一将模块导入Drupal代码库时,模块将被放置在默认的建议位置:

[d8-root]/modules/*NEW-SINGLE-MODULE-FOLDER-HERE*/*MULTIPLE-MODULE-FILES-AND-FOLDERS-HERE*

手动导入位置

如果您“手动”导入模块,则应将模块放在相同的默认建议位置,* HERE *:

[d8-root]/modules/*HERE*

[主题:][d8-root]/themes/*HERE*

在手动提取* .tar.gz或* .zip文件后,请务必检查文件/文件夹结构,以确保模块的文件夹位于正确的位置,并且结构正确。这将在下面的手动提取后检查文件/文件夹结构中更详细地讨论

其他可能的位置

虽然可以使用模块的默认建议位置以外的位置,但您应该有一个非常具体的原因来使用任何其他位置。例如,在多站点配置中,您可能拥有仅用于特定站点的模块。有关多站点安装的说明,请参阅https://www.drupal.org/docs/8/multisite-drupal

不要使用核心'modules'文件夹

注意不要将Drupal核心'modules'文件夹用于新模块。

驻留在的“modules”文件夹是为Drupal核心模块(Drupal的原始下载附带的模块)保留的。您的contrib模块不应放在那里。他们可以去那里,但他们不应该。[d8-root]/core/modules

[为'核心'主题保留的文件夹:][d8-root]/core/themes

如果您保留了contrib模块,那么以后可以轻松更新您的站点,因为您可以删除整个文件夹,并将其替换为核心文件夹的更新版本。[d8-root]/core/modules[d8-root]/core/modules[d8-root]/core/modules

使用'modules'文件夹的子文件夹

一些高级用户打算修改contrib模块,或者创建自己的模块,或者只是拥有大量的contrib模块,将他们的非核心模块组织在contrib'modules'文件夹的子文件夹中。[d8-root]/modules

请记住,每个模块在用于其文件夹名称的“计算机名称”以及它在* .info.yml文件中使用的名称中必须是唯一的。

典型的组织方案可能是:

 

如果您在第一次使用它之前将新模块放入'module'文件夹的子文件夹中,那么您可以放心,Drupal将毫无问题地使用您的新模块。

移动已经开始使用的模块

如果要移动已经开始在您的站点上使用的模块,请参阅页面移动模块和主题[这是Drupal 7页面]⎘

  • [d8-root]/modules/contrib
    对于贡献模块的原始版本

  • [d8-root]/modules/custom
    适用于所有自定义模块

  • [d8-root]/modules/features
    对于使用“Features”contrib模块创建的模块⎘

导入模块

将新模块(或主题)导入您的站点可以通过多种方式完成。从初学者的角度来看,这三种方式是:

 - 使用URL 
 自动导入模块 - 自动模块导入本地文件
 - 手动模块导入

模块导入 - 概述

将模块放入代码库的过程有时会在其他地方称为“安装”模块。我使用'import'而不是'install'这个词,因为下面讨论的导​​入方法只是将模块放入你的代码库中。在您启用该模块之前,它处于休眠状态,并且未被您的站点使用。

这两种“自动”方法是使用您网站管理区域中的浏览器完成的,就像您在Drupal网站上执行的任何其他任务一样。这两种自动化方法可用于“本地”和“在线”站点,有时也称为使用Drupal站点的前端UI(用户界面)。

“自动”方法负责将模块放置在代码库中,并负责从* tar.gz或* .zip文件中提取模块的文件和文件夹。

自动导入过程将所有模块的文件和文件夹提取到您的代码库中

[d8-root]/modules/*NEW_MODULE_HERE--A_SINGLE_FOLDER*/*MULTIPLE_MODULE_FILES_AND_FOLDERS_HERE*

[主题:][d8-root]/themes/*NEW_THEME_HERE--A_SINGLE_FOLDER*/*MULTIPLE_THEME_FILES_AND_FOLDERS_HERE*

使用URL自动导入模块 - 概述

使用第一种自动方法,您可以转到drupal.org上的模块项目页面,并复制您要使用的模块版本的URL。您将该URL粘贴到站点相应页面上的相应框中,然后单击“安装”。

如果您的站点在线,此过程特别快,因为它涉及两个在线服务器相互通信,并双向通过您的个人计算机。而且,我的在线webhost服务器还提取文件的速度至少比家用电脑快十倍。

优点:您不必下载该模块,您没有提取它,并且您不必担心将其放在代码库中的位置。

自动模块导入本地文件 - 概述

使用第二种自动方法,您可以在计算机上的* .tar.gz或* .zip文件中开始使用该模块。

该文件通常是您从模块的项目页面下载的文件。

使用计算机上的* .tar.gz或* .zip文件,您可以转到Drupal站点上的相应页面,单击“浏览”按钮,然后导航到计算机上文件的位置。然后,单击“安装”。

优点:下载后你不必(通常)提取* tar.gz或* .zip文件,你不必担心模块在Drupal代码库中的位置。

手动模块导入 - 概述

“手动”方法相当于您手动将模块放在代码库中所属的位置。

这将在您的计算机本地,或通过您的webhost控制面板或SFTP上传它在在线站点。

此外,您必须在导入之前或之后手动从* .tar.gz或* .zip文件中提取模块的文件。

对计算机上运行的“本地”站点进行手动导入并不是一件很麻烦的事情,特别是如果您已经熟悉使用* .tar.gz或* .zip文件。

通过手动导入到“在线”站点,将模块作为单个* .tar.gz或* .zip文件上传速度要快得多,而不是从* .tar的提取中上传多个文件和文件夹。 .gz或* .zip文件。

此外,对于在线站点,如果您首先上传* .tar.gz或* .zip文件,则可以在两到三秒内使用您的webhost控制面板的“文件管理器”轻松提取它,方法是以下:

如何使用您的webhost控制面板提取在线* .tar.gz或* .zip文件

  1. 登录您的webhost控制面板。
  2. 转到“文件”>“文件管理器”。
  3. 导航到* .tar.gz或* .zip文件。
  4. 单击该文件一次以突出显示它。
  5. 单击页面顶部按钮“Extract”。

 

导入方法也适用于“主题”

值得注意的是,所有三种导入方法同样适用于contrib'主题'。

唯一的区别是contrib主题的推荐位置与推荐的modules文件夹不同。

主题使用'themes'文件夹,模块使用'modules'文件夹。这两个文件夹是彼此的“兄弟姐妹”,“兄弟姐妹”意味着它们在同一个父文件夹中。事实上,它们一起位于站点的Drupal 8根目录(文件夹)中。

  • 模块 - [d8-root]/modules/*NEW_MODULE_HERE--A_SINGLE_FOLDER*
  • 主题 - [d8-root]/themes/*NEW_THEME_HERE--A_SINGLE_FOLDER*

对于两个'自动'模块导入方法......

您可以使用“模块”页面顶部附近的“安装新模块”按钮,也可以使用“外观”页面顶部附近的“安装新主题”按钮导入模块或主题。

您将在浏览器的地址栏中看到的相应地址是 , 但两个页面基本相同,并且可以与模块或主题一起使用。
[d8-root]/admin/modules/install

[d8-root]/admin/appearance/install

但是,如果未启用Drupal核心模块“更新管理器”,则不会在“模块”或“外观”页面上看到“安装新模块”和“安装新主题”。这是下一节的主题。

启用Drupal核心模块“更新管理器”

这两种自动导入方法都要求您启用Drupal核心模块“更新管理器”。但是,出于安全原因,无论您是否打算使用这些导入方法,都应该启用它。

您的“更新管理器”可能已经启用了,但是当它被禁用时它不会被启用,并且如果在基于浏览器的Drupal站点安装过程中没有保留勾选标记,则不会启用它框“自动检查更新”。

通过转到“扩展”页面,检查是否启用了“更新管理器”。

在“扩展”页面,滚动到顶部“核心”的底部。如果您看到“更新管理器”框已选中,则表明已启用。

(当然,可能会检查“更新管理器”的框,但如果最近选中了标记框,则可能实际上没有启用它,而您忽略了单击页面底部按钮“安装”,并且您没有然后离开“扩展”页面。)

刷新“扩展”页面,然后再次检查复选标记。如果未选中“更新管理器”框,请在框中添加复选标记。滚动到页面底部,然后单击“安装”按钮。

启用“更新管理器”后,“安装新模块”仍未显示

在确定已启用“更新管理器”后,很可能您还没有看到“扩展”页面顶部的“安装新模块”按钮/链接。

我发现对于Drupal 8.3-dev,我还必须“运行更新脚本”或“清除所有缓存”以获得“安装新模块”按钮/链接以显示。('清除所有缓存'更容易)执行这两项操作的详细步骤如下:破碎站点问题 - 运行更新脚本和“清除所有缓存”⤵

注意:“清除所有缓存”更容易,更快速,并且对我有用,而无需“运行更新脚本”。

安全性:无论如何启用“更新管理器”

   | 此时的内容⤴  | 跳过这个⤵  | 

无论您是否打算使用其中一种自动方法导入模块,都应始终启用Drupal核心模块“更新管理器”。

当Drupal核心更新可用时,通知您“安全更新”,这一点非常重要,这样您就可以立即更新您的站点。

在基于浏览器的原始Drupal 8站点创建过程中,可能没有选中“更新通知”:“自动检查更新”的复选框。

或者,您可能已经取消安装了“更新管理器”,因为您不希望在电子邮件中看到有关可用更新的Drupal站点的每日通知。

将其设置为每周一次,如果是这种情况,请转到,您可以转到“管理”>“报告”>“可用更新”>点击子选项卡“设置”。在配置页面上,选择“每周”的单选按钮,而不是默认选项“每日”。[d8-root]/admin/reports/updates/settings

有关核心模块“更新管理器”可以执行的操作的更多信息,请参阅drupal.org页面更新管理器(和更新状态)⎘

模块导入 - 步骤

这些是使用三种不同方法导入模块的实际步骤。

如上所述,此时,您应该启用Drupal核心模块“更新管理器”模块,您应该看到“模块”页面顶部的“安装新模块”。实际上,这是下面讨论的两个“自动”模块导入方法所必需的。

此外,如上所述,某些服务器不允许导入模块的前两个“自动”方法,在某些情况下,某些服务器不允许这样做,因此需要第三种方法“手动”导入模块。

使用URL自动导入模块 - 步骤

这是最简单的使用方法。它适用于在您的计算机上运行的“本地”Drupal站点,以及用于webhost的“在线”站点。

这个自动导入过程会将所有模块的文件和文件夹提取到您的代码库中 [d8-root]/modules/*NEW-SINGLE-MODULE-FOLDER-HERE*

[主题:][d8-root]/themes/*NEW_THEME_HERE--A_SINGLE_FOLDER*/*MULTIPLE_THEME_FILES_AND_FOLDERS_HERE*

这种“自动”方法要求您启用Drupal核心模块“更新管理器”。跳转到启用Drupal核心模块“更新管理器”。⤴

转到“扩展”页面。

转到“扩展”页面,在页面顶部附近,在“扩展”一词下面,您应该看到按钮/链接“安装新模块”。

已移除图像。

如果您没有在“模块”页面顶部看到按钮/链接“安装新模块”,请返回上面的页面部分启用Drupal核心模块“更新管理器”⤴并仔细按照其中列出的所有步骤操作。

单击“安装新模块”。

您被带到的页面没有标题,但地址是 [d8-root]/admin/modules/install

转到模块的drupal.org项目页面,然后“复制”模块的下载链接

返回要安装的模块的项目页面,然后向下滚动到“下载”部分。

在“下载”列中,右键单击* .tar.gz文件或* .zip文件的文本链接。(Windows:使用* .zip)

在出现的下拉“上下文菜单”中,如果您使用:

返回您的网站

已移除图像。

将您已“复制”的网址粘贴到以下框中:“从网址安装”。

单击按钮/链接“安装”。

这个自动导入过程会将所有模块的文件和文件夹提取到您的代码库中 [d8-root]/modules/*NEW-SINGLE-MODULE-FOLDER-HERE*

“安装成功完成。” 

在加载的下一页上,您将看到“安装已成功完成”。

单击“启用新添加的模块”链接返回Drupal 8'Extend'页面。

不是我推荐它,而是如果你想让你的模块从当前位置移动到子文件夹,例如[d8-root]/modules/*NEW-SINGLE-MODULE-FOLDER-HERE*

[d8-root]/modules/contrib/*NEW-SINGLE-MODULE-FOLDER-HERE*

现在是开始使用它之前的理想时间,如上面在使用'modules'文件夹的子文件夹中所讨论的那样

自动模块导入本地文件 - 步骤

此方法用于从计算机上的* .tar.gz或* .zip文件自动将模块导入本地或在线站点。

这种“自动”方法要求您启用Drupal核心模块“更新管理器”。跳转到启用Drupal核心模块“更新管理器”。⤴

这个自动导入过程将把所有模块的文件和文件夹提取到你的代码库中
[d8-root]/modules/*NEW_MODULE_HERE--A_SINGLE_FOLDER*/*MULTIPLE_MODULE_FILES_AND_FOLDERS_HERE*

[主题:][d8-root]/themes/*NEW_THEME_HERE--A_SINGLE_FOLDER*/*MULTIPLE_THEME_FILES_AND_FOLDERS_HERE*

转到“扩展”页面。

转到“扩展”页面,靠近页面顶部,在“扩展”标题下,您应该看到按钮/链接“安装新模块”。

[如上所述,“安装新模块”按钮/链接也适用于主题。]

已移除图像。

如果您没有看到“安装新模块”按钮/链接,请仔细按照上面的“更新管理器”中的所有说明进行操作

点击“安装新模块”

您被带到的页面没有标题,但地址是 [d8-root]/admin/modules/install

从项目页面下载模块

返回drupal.org项目页面,查看要安装的模块。

向下滚动到“下载”部分。

在“下载”列中,找到要下载的版本。

单击* .tar.gz文件或* .zip文件的文本链接(Windows:使用* .zip)

通常,这将开始下载文件。

返回您的网站页面'延伸'

已移除图像。

在“上传要安装的模块或主题档案”标题下,单击“浏览”按钮。

在您的计算机上导航到您下载的* .tar.gz或* .zip模块文件的位置。

单击按钮/链接“安装”。

此自动导入过程将从存档/压缩的* .tar.gz或* .zip文件中提取所有文件和文件夹到您的代码库中 [d8-root]/modules/*NEW-SINGLE-MODULE-FOLDER-HERE*

[主题:][d8-root]/themes/*NEW-SINGLE-THEME-FOLDER-HERE*

“安装成功完成。” 

在加载的下一页上,您将看到“安装已成功完成”。

单击“启用新添加的模块”链接返回Drupal 7'Modules'页面。

[主题:点击“启用新添加的主题”链接,您将进入您网站的“外观”页面。]

不是我推荐它,但如果你想让你的模块从当前位置移动到......

[d7-root]/sites/all/modules/*NEW-SINGLE-MODULE-FOLDER-HERE*

...进入'modules'的子文件夹,例如,进入名为'contrib'的子文件夹,在......

[d8-root]/modules/contrib/*NEW-SINGLE-MODULE-FOLDER-HERE*

...然后现在是开始使用它之前的理想时间,如上面在使用'modules'文件夹的子文件夹中所讨论的那样

手动模块导入 - 步骤

使用这种导入模块的方法,您可以手动将模块放在“本地”或“在线”代码库中。您还必须在移动到代码库之前或之后从模块的* .tar.gz或* .zip文件中提取模块的文件和文件夹。

从项目页面下载模块

返回要安装的模块的项目页面。

向下滚动到“下载”部分。

在“下载”列中,找到要下载的版本。

单击* .tar.gz文件或* .zip文件的文本链接(Windows:使用* .zip)

通常,这将开始下载文件。

如果您需要帮助控制下载保存到计算机的确切位置,请在另一个drupal.org页面上查看此部分:了解浏览器的文件下载位置; 或更改浏览器的下载位置。~drupal.org/1248034#dl_location⎘

本地

如果您的站点在计算机上本地运行,请将下载的文件粘贴到。[d8-root]/modules/*HERE*

注意:有关使用* .tar.gz和* .zip文件的更多信息,包括在Linux,MAC和Windows上获取免费程序的位置,请参阅drupal.org页面(如上所述)标题* .tar.gz与* .zip⎘

通过执行以下操作将文件的内容解压缩到该文件夹​​中。

对于Windows,要提取* tar.gz或* .zip文件的内容,请右键单击该文件,然后在下拉上下文菜单中单击“Extract here”以使用内置Windows提取程序。或者更好的是,使用像7-zip~7-zip.org这样的程序

在现代Mac系统上,双击.tar.gz文件。

手动提取后检查文件夹的结构,以确保模块的文件夹位于正确的位置,并且结构正确。这将在下一节“ 手动提取后检查文件/文件夹结构”中进行更详细的讨论

您现在可以删除* .tar.gz或* .zip文件。

线上

如果您的站点是“在线”,请使用您的webhost控制面板上载文件,或使用SFTP(安全文件传输协议)。我强烈建议不要使用FTP,因为它不安全。

将* .tar.gz或* .zip文件放在。[d8-root]/modules/*HERE*

[主题:][d8-root]/themes/*HERE*

然后,您可以使用您的webhost控制面板“文件管理器”提取* .tar.gz或* .zip文件。导航到该文件,突出显示该文件,然后单击页面顶部按钮“Extract”。

或者,要在联机后提取它,您的SFTP程序可能具有完成该任务的功能。

您现在可以从您的网站删除* .tar.gz或* .zip文件,如果您愿意。

手动提取后检查文件/文件夹结构

在执行手动提取之后,应检查模块的文件和文件夹结构,以确保一切都在适当的位置。

在使用两个自动导入过程之一后,您不必检查导入的模块文件的结构,而是在手动提取* .tar.gz或*之后检查文件夹结构是否正确。您的计算机上或在线的zip文件。

问题在于模块的父文件夹可能被创建两次:一次作为父文件夹,再次作为该父文件夹的子文件夹,两个文件夹具有相同的名称。

该问题的可能性不仅限于,但例如,当您在Windows计算机上处​​理* .tar.gz文件时,这种情况很常见。

例如,使用模块“Token”,您不希望拥有的是父项,其子项都命名为“token”,如下所示:

[d8-root] / modules / token / token / * Multiple_folders_and_files *

如果你看到这种情况,可以通过将所有* Multiple_folders_and_files *向上移动一级来消除两个同名模块文件夹中的一个,这样你就可以得到这个(再次,使用'token'模块作为例子):

[d8-root] / modules / token / * Multiple_folders_and_files *

主题 - 同上:同样,以主题'Bootstrap'为例,您不希望在彼此内部有多个'bootstrap'文件夹,因此,如果您看到以下内容,则会出现问题:[d8-root]/themes/bootstrap/bootstrap/*Multiple folders and files*

启用模块

导入模块后,只占用空间。除存储空间外,它不会主动使用您的任何网站资源。只有在启用它之后它才会变为活动状态,如果禁用它,它将再次返回休眠状态,只占用空间,但不再影响您的站点。

要启用新模块,请转到您网站的“扩展”页面。

模块启用:匆忙?如果在“扩展”页面的模块框中放置复选标记,并滚动到页面底部并单击“安装”按钮,您将启用该模块。

'扩展'页面概述(第1部分,共2部分)

在“扩展”页面上,代码库中存在的每个模块在表的列表中都有自己的行。

表的顶部没有列的名称。

复选框列

左侧的第一列用于复选框。

如果未选中该复选框,则表示该模块未启用。如果您要检查它,并滚动到页面底部,然后单击“安装”按钮,即可“启用”该模块。

选中该复选框后,表示该模块已启用,因此在您的站点上“正常工作”。

名称列

复选框右侧是模块的“人类可读”名称。

说明栏(第1部分)

第三列是“描述”。

如果您“看到每个模块名称右侧的描述,那么您可以跳过下一部分,这是那些没有看到它们的人的'修复'。

以下“修复”部分包含主题的“外观”页面的概述,但是,如果您感兴趣。

修复以在“扩展”页面上显示隐藏的模块描述

如果您没有看到带有模块名称的列右侧的模块描述的列,而是您只看到右侧的复选框和模块名称列,那么您的浏览器窗口太窄了您当前用于网站管理页面的“响应式”主题。

换句话说,您的响应式“管理主题”隐藏了描述,因为您的浏览器太窄而无法在浏览窗口中显示它们。

要纠正这种情况,请先关闭垂直左侧管理菜单(如果已打开),方法是单击管理菜单项“管理”。

如果您仍未在其名称右侧看到每个模块的说明,请执行以下操作,尤其是第三项,将您的管理主题设置为“Stark”。

使用更大的浏览器窗口

使浏览器窗口更大。如果这不起作用,或者,如果这不可行,因为,例如,您在移动设备上...

使用较小的字体

尝试尽可能减小字体,但仍可使用。

核心主题Stark为'行政主题'

如果描述仍然没有显示,您可以转到主题的“外观”页面,并将主题“Stark”设置为“管理主题”。

“扩展”页面上的表格将不再是“响应式”,而是它的行将从屏幕的两侧延伸。

您必须从左到右,左右滚动,但至少您应该能够看到模块描述以进行更改。

'外观'页面概述

“Stark”主题附带Drupal核心,并将显示“描述”列,但您必须水平滚动(左 - 右)才能查看这些描述。

转到“外观”页面,找到主题“Stark”。

它很可能出现在“卸载的主题”部分。该部分更接近页面底部的“已安装主题”部分。默认情况下,在创建Drupal 8站点时未启用Stark。

'安装'与'安装并设置为默认值'

默认情况下,您网站的管理(管理)页面使用的主题与非管理页面不同。

'Bartik'是非管理页面的默认主题,但您在“外观”页面顶部看到的主题是当前用于非管理页面的主题。

'Seven'是管理页面的默认主题,但您想将Stark设置为管理主题,以便在管理页面'Extend'上使用。

在您将Stark设置为管理主题之前,必须启用它('Install'-ed)。

在“Stark 8 ...”的图像和名称下,您将看到文本链接“安装”和“安装并设置为默认”(或者,可能,这些链接可能在右侧)。

如果您为Stark单击“安装并设置为默认值”,则会启用它,但这也会将Stark设置为非管理页面的主题,这是您可能不希望发生的事情。此外,单击“安装并设置为默认值”不会立即将Stark设置为管理主题,因此,我建议“安装”。

如果单击“安装”为Stark,它将变为启用状态,之后您可以将其设置为管理主题,而不是使用“七”,或者您当前使用的任何主题都不允许您查看'扩展'页面。

安装主题Stark并将其设置为“管理主题”

因此,单击“安装”为Stark(除非您想要将Stark作为非管理页面的主题,在这种情况下,请单击“安装并设置为默认值”。)

在“外观”页面重新加载后,向下滚动到页面的最底部,再到“管理主题”部分。

提示:通过反复单击“管理主题”,您将切换此项目的所谓“手风琴”功能。具体来说,该部分将在“展开”和“折叠”之间切换。

在“管理主题”子标题下,单击右侧的向下箭头,以显示已启用主题的列表。

请注意:列表项“默认主题”表示要使用的管理主题应该只是当前用作非管理页面的“默认主题”的任何主题。因此,当前位于“外观”页面顶部的任何主题也将用作管理主题。如果您更改外观页面顶部的非管理页面的默认主题,那么从那时起,该“前端”非管理主题也将用作管理主题。

在“管理主题”的下拉菜单中,单击“Stark”,以便它显示在textarea框中。

单击页面底部按钮“保存配置”。

返回“扩展”页面。

'扩展'页面概述(续 - 第2部分,共2部分)

在“扩展”页面上,每个模块名称的右侧是该模块描述的第一行。

'Accordion'切换:通过反复单击描述的第一行,您将切换模块描述的所谓“手风琴”功能。具体来说,描述将在“扩展”和“折叠”之间切换。

单击您安装的模块行中“描述”的第一行,以完全展开描述。

机器名称:如果您正在查看所安装模块的“主”模块,则“机器名称”项将与模块的父文件夹名称相同。如果“机器名称”与模块的文件夹名称不匹配,那么您正在查找的模块不是主模块,而是可能是一组多个模块中的其他模块之一安装模块时

要求:如果此项存在,它将列出模块所依赖的所有模块。

其他列出的模块将需要存在于您的站点上,并且可以使您的模块正常工作。

在该列表中的每个模块之后,您将看到没有看到任何内容,或者您​​将看到“(已禁用)”或“(缺少)”。

“没什么”是好的。这意味着您的模块所需的模块已经在您的站点上并已启用。

'(已禁用)表示您网站上的其他模块,但未启用。您不必费心启用任何“(禁用)”模块,因为当您尝试启用模块时,系统将提示您让Drupal系统为您启用“(禁用)”模块。

'(缺失)'表示其他模块不在您的站点上(假设它是一个缺少的“模块”,而不是其他东西,如'库'),您将不得不去该模块的项目页面得到它的Drupal。

到达drupal.org项目页面的一种快捷方法是复制“Requires”后面列出的名称,并将该名称粘贴到URL的末尾:

https://www.drupal.org/project/

例如,我将模块'Paragraphs'作为我选择的新模块,其描述显示:

需要:Entity_reference_revisions(缺失)

所以,在我的浏览器地址栏中,我把:

https://www.drupal.org/project/Entity_reference_revisions (...不要担心'e'是大写的'E')

...然后按键盘键[Return / Enter]。

之后,在安装了entity_reference_revisions后,段落的描述显示......

要求:实体参考修订(已禁用)

...这是一个很好的改变,指的是从'entity_reference_revisions'到'Entity Reference Revisions'的名称更改,因为'Entity Reference Revisions'是'Extend'页面上列出该模块的方式,所以现在我知道了什么特别是在名称列中寻找'那个'新模块。

缺少库以及模块的其他可能要求(不包括其他模块)

有时,模块将依赖于除站点中缺少的另一个模块之外的某些内容,例如库。

'要求:'项目'必需',当它在模块的描述中存在时,如果您正在考虑卸载该模块,则最有帮助,因为您可以看到卸载它会影响哪些其他模块(如果有) 。

列出的'Required by:'模块(如果有的话)后面没有任何内容,或者'(禁用)'。'(已禁用)表示它已退出您的网站,但未启用; 而如果未显示“(禁用)”,则该模块既可以“在您的网站上”也可以“启用”。

多个模块打包在一个项目中

请注意,contrib模块实际上是多个模块的设置并不罕见。然而,即使单个contrib模块项目带有多个模块,单个下载中的所有模块也将在“扩展”页面的单个部分中一起找到。

如果您的模块是一组多个模块,其中一个是主模块,通常,其他模块将依赖于主模块工作。

您通常需要启用主模块,但您可能想要或不想启用随附的其他模块(如果有)。

模块名称右侧的描述(在表格列表的“扩展”页面上)应该可以让您了解哪个模块是主要模块。

并且,如前所述,描述将告诉您它依赖哪些其他模块(如果有),以及它们是否已存在于您的站点上,以及它们是否已启用。

不过不要担心,因为如果您尝试安装的模块具有其依赖的另一个模块,并且该模块不在您的站点上,或者未启用,那么您将获得有用的通知。如果其他模块在您的站点上但未启用,您将获得的通知也将允许您继续允许它为您启用该其他模块。

另一方面,如果您尝试安装的模块依赖于您网站上尚未安装的另一个模块,则必须返回drupal.org,并从其项目页面获取该模块。

此外,模块可能依赖于另一个模块以外的其他模块,例如,需要找到并下载的“库”。在这种情况下,当您尝试启用该模块时,您应该收到通知,告诉您缺少的内容。

特定模块的描述通常还会列出您站点上已启用和未启用的其他模块(如果有),这些模块依赖于该模块。

如果恰好是模块是为了开发目的而严格设计的,并且出于安全原因不应该在“实时”站点上使用,或者,作为另一个例子,因为它会大大降低站点的响应速度,该信息至少已在模块的项目页面上进行了解释,也可能在“模块”页面的说明中。

在描述的最底部,如果模块可用,则会显示经常看到的(但不总是)链接“ 帮助”,“ 权限 ”和“ 配置 ”。

完成新模块的启用后,将在下一节“配置模块”中单独讨论这些项目。

启用新模块

在“模块”页面上找到您的新模块

您的新模块永远不会位于“核心”的顶部,这是为Drupal 8模块保留的。并非最初配备Drupal 8核心的所有模块都在顶级部分,但大多数都是。

您的模块可以在以下任何一个部分中,但是,哪个部分取决于模块的开发人员如何对其进行分类。

向下滚动页面,直到找到您安装的模块。

在左侧框中为您要启用的任何模块添加复选标记。

单击页面底部按钮“安装”。

“必须启用一些必需的模块”

如果您正在安装一个“需要”另一个模块(或多个)已经在您的网站上但未启用的模块,您将收到此通知:

____________________________ Some required modules must be enabled You must enable the *REQUIRED-MODULE-NAME-HERE* module to install *YOUR-MODULE-NAME-HERE*. Would you like to continue with the above? ____________________________

接下来是“继续”按钮和文本链接“取消”。

单击“继续”按钮。

当“扩展”页面重新加载并显示在顶部“已保存配置选项”时,您就知道已成功启用新模块。

如果要仔细检查模块是否已安装,请向下滚动模块列表,并使新模块的框中带有复选标记。

关于卸载Drupal 8模块与Drupal 7模块的说明

在Drupal 7中,“安装”模块和“启用”模块之间存在区别。事实证明,这通常会导致人们禁用模块并删除其代码但无需清理数据库的情况。因此,在Drupal 8中更改了方法,以便在安装模块时,Drupal会注册任何路由,挂钩等,并在数据库中创建任何必要的条目。然后,如果你“卸载”一个模块,Drupal将删除所有数据库条目,并取消注册路由,钩子等。

标签