drupal

这是一个临时存根。https：//www.drupal.org/docs/8/extending-drupal-8/installing-contributed-...中的部分内容应移至此处。

为了卸载未使用的模块，您必须确定您的站点上未使用该模块，以免影响任何功能。
您可以使用Drush或Administrative Interface来卸载模块。

使用Drush

先决条件 - 应在您的机器上安装Drush。
要安装Drush，请检查如何安装Drush。

运行以下Drush命令卸载模块：
drush pm-uninstall module_name

或者使用Drush别名：
drush pmu module_name

然后使用Drush命令清除缓存：
drush cr

就是这样，卸载的模块在模块列表中没有显示为已检查，并且从站点中删除了模块的功能。

使用管理界面

1. 在“  管理”  管理菜单中，导航到“  扩展”  >“  卸载”选项卡，您可在其中找到已准备好卸载的已启用模块的列表。(admin/modules/uninstall)
2. 您可以通过在搜索字段中键入模块名称来搜索或过滤掉要卸载的模块。
3. 选中要卸载的模块的框/框。
4. 单击 页面底部的“ 卸载”按钮。
5. 步骤4将提示您确认模块卸载请求。
6. 单击“  卸载”。
7. 转到链接点击manage>onfiguration>development>performanceclear all cache.

您将看到已从站点中删除已卸载模块的功能。

以下是使用Drush和Administrative Interface卸载模块的完整过程。

 

相关内容

4.4。卸载未使用的模块

如何卸载模块以减少开销

有些模块实际上并不需要你做任何事情，他们只是做他们在幕后做的事情。但是，这些模块可能没有可配置选项，或者只能作为其他模块所依赖的选项。

更常见的是，您关注的模块可以调整权限和选项。有些项目很容易使用，也就是说，它们的使用是“直观的”，你可以相对清楚地知道你可以调整什么，以及你需要做些什么来完成你可能想要做的事情。

如果您想知道智能使用刚刚安装的模块所需的所有相关细节，那么，我可以想到您可能需要做的几件事或要看的地方。

以易于使用的方式大致订购以下建议。

不幸的是，对于像我们这样的终端用户来说，Drupal正在不断发展，虽然我们很幸运能够从开发人员的所有优秀工作中自由受益，但他们的时间有限，我认为这样说是安全的。对于新手来说，最好的开发人员并不倾向于成为最勤奋的文档创建者，我们就是这样，否则你和我现在就不会在这里。

当你学习使用Drupal时，我会鼓励你记录和发布你的试验和磨难，以便成千上万在未来几天，几个月和几年内为你服务的人受益。

我接受它作为创建此文档的最终挑战，尽管（或因为）看似无休止的烦恼，挫折和恶化 - 使用Drupal的新文档部分 - 以及在较小程度上，撤消学习和使用Drupal的挑战，如果有足够的新手“How-to”以前是由你和我这样的其他人创造的，那本可以被淘汰 - 但特别是，我很高兴我的假设你，我的朋友，将从中受益。

你和我一样，不必了解“发展”或编程，分享你所做的知识，并且正在学习。

试错

您可以直接跳入并开始使用该模块，或者开始使用其配置选项。

或者，如果您经过研究后无法确定选项的作用，或者使用选项的所有潜在影响，您应该随意尝试一下您的冒险灵魂认为最好的东西。

每当你到达一个模块需要你做出猜测的时间点时，你真的不必担心尝试任何可用的选项，因为你的站点已备份，你总是可以恢复到以前的版本现场。您的网站已备份，对吧？

鉴于您可能不会立即明白该模块的模块或特定选项会对您的网站产生什么影响，因此我建议您一次只能尝试一个模块，您可以导航到站点的每个角落，并尝试以各种方式使用您的站点 - 创建新页面，尝试不同的配置选项 - 然后再继续添加另一个contrib模块。

否则，如果你启用了更多的那个新模块，然后你遇到了一些看起来很奇怪的问题或情况，你就不会知道哪个新模块对你造成的麻烦负责。

项目页面内容

每个模块的“项目页面”都是drupal.org的主页。项目页面是我在考虑是否尝试模块时，或者当我遇到问题时，或者对我刚启用的模块有疑问时，我通常都会先去的地方。

如果您仔细阅读完整的项目页面，您可以相对确定您拥有所需的所有最重要的信息。例如，在考虑是否尝试模块时，如果模块需要任何其他模块，那么其他模块将列在项目页面的某个位置。

项目页面还可能包含与该模块相关的各种有用的其他有用链接。

项目页面内容可能适用于新的Drupal用户，也可能适用于更高级的用户/开发人员。

项目页面“阅读文档”链接（存在时）

在右侧栏中（在移动设备上或在其他狭窄的浏览器窗口中落入页面底部的列），您将始终找到标题“资源”，您可以在其下找到或者找不到链接'阅读文档'。

但是，并非所有项目页面都有“阅读文档”链接，在这种情况下，希望您在项目页面的主要内容区域中找到有用的文档链接。

当“阅读文档”链接确实存在时，它将是开发人员认为是用于开始寻求更多信息的最相关的单一资源。

每个项目页面的内容由该项目的初始创建者以及可能是初始创建者已获得此类许可的其他一些个人确定并在其控制之下。

其他drupal.org成员无法访问更改项目页面，从来没有，经常创建其他页面，其中包含有关您想要了解的模块的重要信息。不幸的是，那些其他页面很少会在项目页面上链接到它们。

在项目页面上查找未链接的页面将在下面的Google搜索范围内讨论drupal.org⤵

模块“README.txt”文件

“README.txt”文件历来是官方的地方，其中记录了模块（或主题）的所有真正相关和必要的信息，包括模块（或主题）更新到更新版本时的任何相关信息。

README.txt文件在提取后（如果存在）位于contrib模块（或主题）的顶级文件夹中。

要查看模块（或主题）的“README.txt”文件而不必下载任何内容，请访问以下URL：

http://cgit.drupalcode.org/project/PROJECT_MACHINE_NAME.git/blob/HEAD:/README.txt

将PROJECT_MACHINE_NAME上面URL中的表达式替换为特定项目的简短“机器名称”。

当您在任何drupal.org项目页面时，“机器名称”位于浏览器的地址栏URL中，例如，此示例URL的“PROJECT_MACHINE_NAME”部分 - 类似于每个项目的URL：

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

如果README.txt文件不存在，则该模块可能是没有可配置选项的模块，并且只是一个在后台静默工作的模块，并且是其他contrib模块工作所必需的模块。

如果没有README.txt文件，或者您只想查看项目的所有其他文档，请使用以下URL（替换'PROJECT_MACHINE_NAME'）：

http://cgit.drupalcode.org/PROJECT_MACHINE_NAME/tree/?id=HEAD

在'drupalcode.org'页面的右上角，您可能需要“切换”到您有兴趣探索的Drupal核心版本。

谷歌搜索仅限于drupal.org

如果您想要搜索仅限于整个drupal.org网站，这就是我的工作。我经常使用这种方法搜索drupal.org或我选择的任何其他域。

我去google.com⎘ ，然后输入：

site:drupal.org

请注意，域名前面的冒号（“：”）后面没有空格。不要使用'www。' 在任何域名的开头。

无论域名是什么，都要添加一个“空格”，然后键入您可以想到的任何关键字，即我们今天讨论的模块名称。

我有时也发现通过添加"Drupal 8"到Google搜索引擎文本区域框中，尝试将Google搜索专门限制为“Drupal 8”（而不是获取D6，D7的结果......）也很有帮助。通过使用双引号，Google将返回包含双引号中确切的两个或更多单词表达式的页面的搜索结果。（...大多。）

要查看整个地球上特定模块可用的信息，包括drupal.org内部和外部的页面，请省略“site：drupal.org”。

要获得每页100个Google搜索结果，而不是10个，当您在任何Google搜索结果页面时，请点击右上角的“齿轮”图标，然后在下拉菜单中点击“搜索设置”。在下一页的“Google即时预测”标题下，点击单选按钮“从不显示即时结果”，然后在“每页结果”标题下，将滑块一直拖到右侧。你的搜索现在需要额外的千分之三秒，或类似的东西。

倾斜和咆哮的意见：您可能已经考虑过使用drupal.org提供的搜索引擎，位于所有drupal.org页面的顶部。几年前我尝试了几次，如果你喜欢徒劳无功，我会鼓励你自己尝试一下。

您网站的“扩展”页面“帮助”按钮/链接（存在时）

在站点的“扩展”页面上，在每个模块名称的右侧，如果浏览器窗口足够宽，您可能会看到其描述的第一行。

如果您单击描述的第一行，它将展开并显示其余的描述，并且还会显示该模块的“帮助”，“权限”和“配置”按钮/链接物品可用。

如果您没有立即在模块名称右侧看到模块描述的第一行，并且您想要查看它，请使用“ 模块配置”页面上的说明。

但是，不幸的是，要访问您网站上的模块帮助页面，不仅需要将模块导入您的站点，而且只有该模块是“帮助”按钮/链接才会显示启用。而且，遗憾的是，并非所有的贡献或核心模块都有可用的“帮助”按钮/链接，但除非您首先启用该模块，否则您将无法知道其中是否有一个可用。

出于那些有问题的原因，我从来没有依赖过，也没有使用那些“帮助”按钮，虽然现在看着它们我看到它们经常导致包含良好信息的页面。

如果您还没有，请转到“扩展”页面。

在“扩展”页面上，每个表行用于一个模块，并从左侧开始，带有复选框，紧接着右侧的模块名称。

模块名称右侧是第三列，其中包含模块的描述。

如果您看到说明，请跳至'Accordion'切换以获取说明⤵

如果你没有看到描述

如果您没有在其名称右侧看到每个模块的描述，那么您的“响应式”管理主题将隐藏描述。

有关此问题的详细信息及其解决方案的详细信息，请参阅“ 在”扩展“页面上显示隐藏模块描述的修复程序，但以下简要概述是解决该情况的步骤的摘要。

快速修复“扩展”页面上隐藏描述的大纲

如果左侧垂直管理菜单已打开，请将其关闭。

如果您仍然没有看到描述，那么您需要执行以下三项中的一项，这些内容在“扩展”页面上显示隐藏模块描述的修复中有更详细的讨论  。

'手风琴'为描述切换

在“扩展”页面上，在新模块的表格行中，单击其“描述”的顶行，以完全展开手风琴切换功能的描述。

在说明的底部，当模块可用时，将显示模块的“帮助”，“权限”和“配置”链接。

但是，只有在启用模块后才会显示这些链接。

无需去打猎，节省时间。

我认为“扩展”页面是确定模块是否具有与其关联的“权限”选项或“配置”选项的最佳位置。并且，方便的是，这些是适用时这些选项的直接链接。

确实可以从您站点的“配置”页面访问模块的配置页面，但您需要提前知道模块的配置页面是否存在，然后您需要知道在什么标题下它位于“配置”页面上。

相反，我在“扩展”页面上找到该模块并检查它是否具有“配置”链接，该链接将我直接带到配置页面。

您也可以通过管理员菜单项“人员”>“权限”转到“权限”页面来设置模块的权限，但提前知道权限是否非常有用甚至存在一个模块，如果是这样，在“权限”页面上确切地知道它们被归类为什么标题名称也会很有帮助。

相反，我在“扩展”页面上找到该模块，并检查它是否具有“权限”链接，这会将我带到“权限”页面上的正确位置。

模块“帮助”链接

模块开发人员提供的现成帮助文档的数量因模块的存在，详细程度以及对新用户的有用程度而异。

模块文档将在下面的“模块文档和帮助”部分中详细讨论，但是现在，“扩展”页面上的“帮助”按钮将简要讨论它对模块配置的有用性。

在您网站的“扩展”页面上，如果您针对特定模块看到“帮助”链接，请点击该链接，看看您获得了什么。

打开的页面由您的站点使用导入的模块文件夹中包含的信息生成。

我建议您至少扫描帮助页面以了解它包含的内容。

当您下次使用模块的“权限”或“配置”按钮（如果适用）时，该页面可能包含与您相关的详细信息。

其他模块文档和帮助选项中讨论模块文档和帮助。

浏览完“帮助”页面后，返回“扩展”页面。

模块“权限”链接

并非所有模块都具有与其关联的“权限”，但是如果模块具有“权限”，则应该在“扩展”页面上看到其描述右侧的模块的“权限”链接。

每当您的站点首次启用模块时，“管理员”角色将自动被授予该模块的完全权限。

但是，某些模块将要求您为“匿名用户”和“经过身份验证的用户”角色设置权限，以使模块以您希望的方式为这些角色工作。

新的contrib模块的权限信息可能位于上面讨论的“帮助”链接，或者它可能位于模块文件夹顶层的“README.txt”或“INSTALL.txt”文件中，如模块文档中所述和帮助。

权限概述

如果您之前从未访问过“权限”页面，那么在您进一步阅读时，了解它的外观会很有帮助。

要进入“权限”页面，您可以点击“扩展”页面上的任何一个“权限”链接; 或者，在您的页面管理员菜单中，单击“人员”，然后在“人员”页面中，单击标记为“权限”的页面顶部选项卡（或链接）。

默认情况下，Drupal站点会创建三个权限级别，每个类型对应一种基本站点用户：“匿名用户”，“经过身份验证的用户”和“管理员”。

“管理员”角色用户帐户

正如您可能猜到的那样，您是“管理员”，因此，您的帐户被授予您网站允许的最高权限级别：允许执行任何操作。

“管理员”角色将始终具有授予其的所有权限，并且无法从“管理员”角色中删除权限。（这与Drupal 7不同。）

“经过身份验证的用户”角色用户帐户

“经过身份验证的用户”帐户是由完全陌生人创建的帐户，他们来到您的网站并注册帐户。

当经过身份验证的用户“登录”到他们的帐户时，您的网站会将其归类为具有“经过身份验证的用户”角色，并且他们将被授予执行操作的权限，但只有您已设置权限的内容。认证用户'做。

默认情况下，“经过身份验证的用户”角色授予的权限相对较少，但默认情况下，“经过身份验证的用户”可以发布评论并使用快捷方式。

“匿名用户”角色用户帐户

但是，默认情况下，“匿名用户”可以比查看网站内容做更多的事情，并使用网站范围的联系表单。

你在掌控之中

您可以根据需要更改每个角色的各种权限。

您还可以创建任意数量的其他新帐户，并将每个帐户指定为“经过身份验证的用户”帐户或“管理员”帐户。您为每个帐户提供最少的用户名和密码，但您也可以分配一个电子邮件地址。

其他用户角色

除了Drupal核心附带的三个用户角色之外，您还可以创建任意数量的其他用户角色，例如，如果您希望您信任的个人能够管理某些事物，但您不希望他们拥有权限管理您网站上的所有内容。

要创建其他用户角色，请在“权限”页面的顶部，点击“角色”标签，然后在该页面底部附近点击“添加角色”按钮。

您的模块的权限

如果在“扩展”页面上，您有一个模块的“权限”链接，请单击该链接。

您模块的“权限”页面位于 [d8-root]/admin/people/permissions

每当您点击“扩展”页面上的“权限”链接之一时，您将进入页面上某个位置的“权限”页面，并在窗口顶部显示相关的第一个权限（可能有多个与模块关联的权限）。

您可能需要向上滚动一行，将窗口放在头发上，因为您想要的权限可能隐藏在页面顶部的管理菜单下。

但是，请注意，如果“权限”页面恰好将其自身呈现为一直向下滚动，那么您所寻求的权限可能不会位于查看窗口的顶部。换句话说，由于页面尽可能地向下，并且您的特定权限太靠近列表的底部，因此您的权限不会位于查看窗口的顶部，而是位于查看窗口的顶部中间的。

将始终选中“管理员”列复选框（最右侧），并且您不能取消选择它们。

您是否允许“匿名”和/或“经过身份验证”的用户获得特定权限取决于您。

如果您不清楚每个权限要控制的内容，以及允许“匿名用户”和/或“经过身份验证的用户”权限背后的全部含义，请参阅“帮助”链接以获取“扩展”页面上的模块（如果存在“帮助”链接）。或者，请参阅模块文件夹顶层的'README.txt'或'INSTALL.txt'文件，如下所述，以及模块文档和帮助中的其他帮助选项。

模块权限安全警告

任何显示以下单词的权限，只应给予您信任的个人100％。

Warning: Give to trusted roles only; this permission has security implications.

而且，重要的是，即使权限没有上面引用的完整警告，如果它在第一列描述中使用“管理”一词，那么该项目也可能存在巨大的安全风险，并且只应给予您个人完全信任。

例如，“分类法”权限读取“管理词汇表”，但它不会显示上面的完整警告。

然而，如果您授权某人管理分类法，您将授予他们访问编辑字段的权限，这会使您的网站处于危险之中。

总之，当“权限”使用“管理”一词时，只将其提供给您完全信任的人。

完成“权限”页面上的更改后，返回“扩展”页面。

模块“配置”链接

在“扩展”页面上，如果新模块的“配置”链接可用，请单击该链接。

如果“配置”链接不存在，则您的模块没有可配置选项。

如果您不清楚每个配置选项要控制的内容，以及每个选项背后的完整含义，请参阅“扩展”页面上该模块的“帮助”链接（如果“帮助”链接存在）。或者，请参阅contrib模块的顶级文件夹中的'README.txt'文件，如将在模块文档和帮助中讨论的那样，以及其他帮助选项。

• 更大的浏览器窗口

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

• 较小的字体

  尝试尽可能减小字体，但仍可使用。如果描述仍未显示，...

• 将'Stark'设为'管理主题'

  “Stark”主题附带Drupal核心，并将显示“描述”列，但您必须水平滚动（左右）。

  转到“外观”页面，然后单击主题“Stark”的“安装”（不是“安装并设置默认值”）

  重新加载“外观”页面后，转到“外观”页面的底部，将Stark设置为“管理主题”，然后单击“保存配置”。

  返回“扩展”页面。

大多数贡献的模块将定期收到更新，以解决安全问题，解决模块功能问题，添加新功能或全部三项。定期检查您正在使用的模块的新版本并在发布新版本时更新它们是个好主意。

用户指南中详细描述了更新模块的过程 - 请参阅  第13.6节：“更新模块 ”。 

如果您使用Composer来管理站点，请阅读Composer模块更新说明。

Drupal 8将所有核心主题放在名为的目录下， 并将所有contrib或custom主题放在名为 （在webroot中）的目录下  。检查目录中README.txt的详细内容以获取更多信息。/core/themes/themes/themes

1. 下载主题。
   您可以在下载以及一些外部网站上找到主题。确保主题的版本与您的Drupal版本相匹配。 
    首次下载主题时，它将以压缩文件格式显示，例如“tar.gz”或“zip”。您需要提取压缩文件，然后您将获得提取到文件夹中的文件列表。 
    
2. 上传文件夹。
   FTP / Copy / SCP将您的文件保存到Drupal安装中的所需主题文件夹中。Drupal 8将所有核心主题放在名为的目录下， 并将所有contrib或custom主题放在名为 （在webroot中）的目录下  。如果您运行的是米 ULTI现场安装多点安装，你还可以把主题在网站/所有/ themes目录，并在网站版本/所有/主题将优先于在这里同一主题的版本。或者，sites / your_site_name / themes目录模式可用于将主题限制为特定的站点实例。/core/themes/themes
    
3. 阅读说明。
   如果主题有安装文件（通常是INSTALL.txt和/或README.txt），请阅读它以获取具体说明。有些主题需要特殊处理才能正常运作。
    
4. 启用并激活默认主题。
   转到站点主管理菜单上的“外观” 。选中“安装”以安装主题并使用“设置为默认值”为您的网站启用主题。或者您可以使用'安装并设置为默认'来启用您网站的主题以及主题安装。(/admin/appearance)
    
5. 单击底部的“保存配置”按钮。

如果遇到问题，请检查主题问题队列并搜索论坛。如果您的问题尚未解决，请发布问题，有人会尽力帮您解决。

除了使用UI安装模块外，您还可以从命令行下载和安装模块：

• 下载模块（和主题）的推荐方法是使用Composer。但是，您仍可以使用Drush 8或Drupal Console下载模块，但它不会调整您的composer.json文件。
• 无论Drush和Drupal的控制台将安装模块和主题，为您服务。（在Drupal 8中安装和启用模块是相同的。）

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

Drush

在drush 8中，您可以使用命令下载模块：

drush dl module_name

要使用Drush安装模块，请执行以下命令：

drush en module_name

使用命令清除缓存

drush cr

转到浏览器刷新页面。您将看到模块的功能已添加到站点。

Drupal控制台

要使用Drupal控制台安装模块，请执行以下命令：

drupal moi module_name

使用Drupal Console，您可以使用下载模块

drupal mod module_name

Composer是PHP包管理器。它提供了与Drupal自己的依赖关系管理类似的功能，以及Drush make，但对于任何项目，不仅仅是Drupal模块。Drupal 8的许多模块依赖于需要使用Composer包含在站点代码库中的通用PHP包。

哪些模块具有Composer依赖性？

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

• 它在项目页面或README或INSTALL文件中记录事实。
• 它的根目录包含一个文件。composer.json
• 一旦＃2494073：标记具有未安装的未安装的作曲家依赖关系的模块是固定的，Drupal核心将自动通知您这些模块。

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

非常简短的解释是始终使用Composer来包含模块。跑

composer require drupal/modulename

从webroot目录，而不是在核心目录中，安装具有其所有Composer依赖项的模块。一旦模块包含在Composer中，就可以在Drupal中启用该模块。有关更多信息，请阅读有关在Drupal中启用模块的指南。

阅读使用Composer管理Drupal站点依赖项以获取更多信息。

NB！从Drupal 8.1开始，不推荐使用Composer Manager模块。

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

内容

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

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

2. 导入模块

   • 模块导入 - 概述

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

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

     • 手动模块导入 - 概述

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

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

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

   • 模块导入 - 步骤

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

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

     • 手动模块导入 - 步骤

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

3. 启用模块

   • '扩展'页面概述（第1部分，共2部分）

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

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

       • '外观'页面概述

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

   • '扩展'页面概述（续 - 第2部分，共2部分）

   • 启用新模块

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将删除所有数据库条目，并取消注册路由，钩子等。