drupal

drupal 图书教程

由 hrs, 1 七月, 2019

4.2 编辑基本站点信息

标签
drupal

目标

更改基本站点信息，例如站点名称，标语， 默认时区。

必备知识

第4.1节“概念：管理概述”

脚步

配置基本站点信息

  1. 在“ 管理”管理菜单中，导航到“ 配置” >“ 系统” >“ 基本站点设置”（admin / config / system / site-information）以更改“ 站点名称”，“ Slogan”，“管理电子邮件地址”或“ 默认首页”路径。

  2. 根据您的网站填写适用的字段。

    字段名称说明示例值

    网站详细信息>网站名称

    用于标识站点并在浏览器中显示

    Anytown农贸市场

    网站详情>口号

    通常在全站显示

    农场新鲜食物

    网站详情>电邮地址

    在自动电子邮件中用作发件人地址（注册，密码重置等）

    info@example.com

    drupal-config-basic-SiteInfo.png

  3. 编辑字段后，单击“ 保存配置”以查看应用于站点的更改。

配置默认区域设置

  1. 在Manage管理菜单中，导航到Configuration > Regional and language > Regional settings （admin / config / regional / settings）。

  2. 填写表格如下：

    字段名称说明示例值

    区域设置>默认国家/地区

    您网站的主要国家/地区

    美国

    区域设置>一周的第一天

    本周从日历开始的那一天

    星期日

    时区>默认时区

    您网站的主要时区

    美国>洛杉矶

    时区>用户可以设置自己的时区

    登录用户是否可以选择不同的时区来显示站点上的日期和时间

    未选中

    drupal-config-basic-TimeZone.png

  3. 编辑字段后，单击“ 保存配置”以查看应用于站点的更改。

影片

 

编辑基本站点信息

其他资源

Drupal.org社区文档页面“Drupal 8管理入门”

评论

由 hrs, 1 七月, 2019

4.1 概念：行政概览

标签
drupal

必备知识

什么是行政菜单？

核心工具栏模块提供的工具栏显示 站点顶部或左侧的管理管理菜单，供有权查看的用户使用。此菜单提供对站点的所有管理区域的访问。菜单条目将根据您网站上的哪些模块以及查看菜单的人员的权限而有所不同; 如果使用核心标准安装配置文件进行安装并具有完全管理权限，则顶级条目如下所示：

drupal-config-overview-toolbar.png

内容
列出并管理现有内容，并允许创建新内容。
结构体
包含用于管理站点结构元素的链接列表，例如块，内容类型，菜单和分类。
出现
管理主题和与外观相关的设置。
延伸
管理模块的安装和卸载。
组态
包含指向各种网站功能的设置页面的链接。
人
管理用户，角色和权限。
报告
包含指向日志，更新信息，搜索信息以及有关站点状态的其他信息的链接。
帮助
列出帮助提供已安装模块的主题。

工具栏第二行最右侧的箭头按钮（如果使用像阿拉伯语这样的从右到左阅读的语言查看站点，则可以使用最左侧的箭头按钮）来切换菜单，使其不会水平显示在页面顶部，左侧（或右侧，从右到左语言）的垂直格式。垂直查看时，菜单将成为交互式树。

drupal-config-overview-vertical-menu.png

本指南使用管理工具栏描述导航到管理页面的标准方法。有关更多信息，请参见第i.5节“指南的约定”。

什么是上下文链接？

可以通过核心Contextual Links模块显示的上下文链接访问站点上的某些管理和编辑功能。上下文链接将您带到可以通过管理菜单访问的某些页面，但不必在菜单层次结构中导航，而是在您站点上显示相关内容的位置附近提供这些链接。

必须激活上下文链接才能看到。如果您网站的主题使用上下文链接的默认样式，则铅笔图标用于指示上下文链接存在并已激活，如果单击该图标，您将看到上下文链接。有两种方法可以激活提供对上下文链接的访问的铅笔图标：

  • 如果您在浏览器中使用鼠标，当您将鼠标悬停在具有相关上下文链接的区域上时，该图标将暂时显示。

  • 您可以单击工具栏顶部栏右端的主铅笔图标（或其编辑链接），这将激活当前页面上的所有上下文链接。此图标仅在具有上下文链接的页面上可见。

    drupal-config-overview-pencils.png

评论

由 hrs, 1 七月, 2019

第4章基本站点配置

标签
drupal

4.1 概念：行政概览

管理菜单和上下文链接概述。

4.2 编辑基本站点信息

如何编辑基本站点信息（站点名称，标语和默认时区）。

4.3 安装模块

如何使用管理界面或Drush安装核心或贡献模块。

4.4 卸载未使用的模块

如何卸载模块以减少开销。

4.5 配置用户帐户设置

如何更改用户帐户注册设置。

4.6 配置主题

如何编辑主题的设置以更新配色方案并添加徽标。

评论

由 hrs, 30 六月, 2019

3.7 运行交互式安装程序

标签
drupal

目标

安装核心软件并通过运行附带的安装程序创建管理员帐户。

网站先决条件

第3.4节“准备安装”

脚步

  1. 如果您使用来自托管服务提供商或演示站点的一键安装，您很可能会在安装过程中看到以下部分或全部屏幕。如果您手动或使用Composer上载核心文件，要启动安装程序，请打开浏览器并访问您为托管设置的URL。

  2. 在安装程序的第一页上选择一种语言; 例如，英语。您可以选择任何其他列出的语言。将下载并安装所选语言的语言文件，以便可以使用所选语言完成其余的安装过程。选择语言后，单击“ 保存”并继续。

    drupal_install-run-01.png

  3. 选择安装配置文件。安装配置文件为特定类型的站点提供站点功能和功能，作为包含核心软件，贡献模块，主题和预定义配置的单个下载。Core包含两个安装配置文件。选择核心标准安装配置文件。单击“ 保存”并继续。

    drupal_install-run-02.png

  4. 安装程序的下一步将验证您的系统是否满足最低要求。如果没有，您将看到需要更正的内容的大纲，以便继续。如果是，安装程序将自动进入下一步。

  5. 提供您在第3.4节“准备安装” 一章中创建的数据库的详细信息。然后单击“ 保存”并继续。

    字段名称说明值

    数据库名称

    给数据库的自定义名称

    drupal8

    数据库用户名

    用户名已创建

    databaseUsername

    数据库密码

    密码选择

     

    drupal_install-run-03.png

  6. 下一步将在标题安装Drupal下显示一个进度条。安装程序完成后，它将自动进入下一步。

    drupal_install-run-04.png

  7. 最后一步是配置有关新站点的一些基本信息。请注意，您在此步骤中创建的用户帐户是该网站的管理员帐户。有关此唯一帐户的重要信息，请参见第7.2节“概念：用户1帐户”。您可以安全地将此帐户命名为“admin”，并确保选择安全且唯一的密码。

    填写表格并提供以下信息：

    字段名称说明值

    网站名称

    为网站选择的名称

    Anytown农贸市场

    网站电邮地址

    与该网站关联的电子邮件

    info@example.com

    用户名

    指定用户的凭据

    管理

    密码

    选择密码

     

    确认密码

    重复密码

     

    电子邮件地址

    用户的电子邮件

    admin@example.com

    其余字段可能会保留其默认值。

    drupal_install-run-05.png

  8. 单击“ 保存”并继续。

  9. 您将被重定向到新网站的首页，您应该看到消息恭喜，您安装了Drupal！显示在页面顶部。

    drupal_install-run-06.png

扩大您的理解

检查状态报告以查看安装是否存在任何问题。请参见第12.5节“概念：状态报告”。

相关概念

影片

 

运行安装程序

其他资源

Drupal.org社区文档页面“创建数据库”

评论

由 hrs, 30 六月, 2019

3.6 手动下载核心软件

标签
drupal

目标

手动下载核心软件或分发。如果您使用其他方法下载，请跳过此主题。

必备知识

脚步

  1. 转到https://www.drupal.org并 在顶级菜单中导航到Build > Download＆Extend。

    drupal_install-prepare-downloads.png

  2. 如果您只想下载核心软件，请单击下载Drupal zip或下载tar.gz链接，然后将文件保存到本地计算机。

  3. 如果要下载分发，请单击“ 分发”图标或链接，从列表中选择分发，单击其项目页面，然后单击链接以将zip或tar.gz文件下载到本地计算机。链接如下所示：

    drupal_extend-module-install-download.png

  4. 将下载的文件上传到您的主机帐户。登录控制面板并导航到HTML目录。将文件保存在那里。

  5. 解压缩tar.gz或zip文件，这将创建一个新目录。如果您没有终端访问权限，或者您的托管服务器未运行Linux，则您的主机控制面板的文件管理器应该提供一种提取文件的方法。如果您有终端访问托管服务器（运行Linux），您可以使用如下命令：

    tar -xzf drupal-8.3.2.tar.gz

  6. 除非您的解包方法已将其删除，否则请从服务器中删除压缩文件。
  7. 重命名目录或重新配置您的Web主机，以便目录名称与您的Web主机配置为用于您的站点的目录相匹配。

扩大您的理解

下载软件后，您可以通过从核心软件的顶级目录运行以下命令来安装临时演示站点（请参见第3.3节“概念：下载和安装核心软件的方法”）：

php core / scripts / drupal快速启动标准

将安装演示站点，并且您的Web浏览器应该打开以登录到新站点，该站点只有在PHP命令处于活动状态时才会运行。要了解有关此功能的更多信息，请使用其help命令：

php core / scripts / drupal quick-start --help

归因

写和编辑德鲁戈顿， 迈克尔Lenahan在 erdfisch， 珍妮弗·霍奇登和Jojy阿方索在红裂纹。

评论

由 hrs, 30 六月, 2019

3.5 使用Composer下载和更新文件

标签
drupal

目标

使用Composer下载或更新核心软件或附加模块和主题中的文件和依赖项。如果您不使用Composer，请跳过此主题。

必备知识

第3.2节“概念：附加工具”

网站先决条件

如果要使用Composer，则必须将其安装在本地开发服务器或实际站点上。请参见第3.2节“概念：其他工具”。

脚步

如果您无法在实时服务器上安装Composer工具，则可以按照本地服务器上的以下任何部分中的步骤操作，然后将任何更新或添加的文件传输到实时服务器。建议的过程是创建新目录和已更改目录的存档或zip文件，将存档传输到实时服务器，删除已更改的目录，然后解压缩存档。确保在安装的根目录中检查以下文件的更新和添加内容：

  • 供应商目录
  • autoload.php
  • composer.json
  • composer.lock

使用Composer下载核心软件

如果您尚未下载或安装核心软件，并且希望使用Composer下载核心软件及其外部依赖项，请执行以下步骤：

  1. 在命令行中，更改为您希望软件驻留的目录上方的一个级别。

  2. 输入此命令，其中mydir是您要创建的目录：

    composer create-project drupal-composer / drupal-project：8.x-dev mydir --no-interaction

  3. 最新版本的核心软件将下载到mydir / web 子目录; 你还可以在mydir / vendor目录中获得一些额外的工具，如Drush和Drupal Console 。

转换以前下载的站点以使用Composer

如果您之前未使用Composer下载了核心软件，则稍后可能会发现您希望或需要使用Composer来管理和更新依赖项。要将现有站点转换为使用Composer，请在站点的根目录中输入以下命令：

作曲家全球需要grasmash / composerize-drupal 作曲家composerize-drupal --composer-root =。--drupal根=。

请注意，如果这些模块，主题和配置文件放在modules / contrib，themes / contrib和profiles / contrib目录中，它们也会使您以前下载的模块，主题和配置文件不使用Composer 。如果将它们放在其他位置，您可以考虑删除以前下载的模块和主题，然后按照以下说明使用Composer重新下载它们。

使用Composer下载模块或主题

如果您已经在使用Composer来管理核心软件，并且希望使用Composer添加带有依赖项的贡献模块或主题，请执行以下步骤。

  1. 每次要添加贡献的模块或主题时，请确定项目的短名称。这是项目页面URL的最后一部分; 例如，Geofield模块，在https://www.drupal.org/project/geofield，有简称geofield。

  2. 要下载提供的模块或主题及其外部依赖项，请在站点的根目录中输入以下命令（替换模块或主题的短名称geofield）：

    作曲家需要drupal / geofield

使用Composer更新以前下载的文件

在开始使用Composer管理依赖关系后，请按照以下步骤更新核心软件或贡献模块或主题的文件：

  1. 确定要更新的项目的简称。对于核心软件，它是核心。对于贡献的模块和主题，它是项目页面URL的最后一部分; 例如，Geofield模块，在https://www.drupal.org/project/geofield，有简称geofield。

  2. 如果要更新到最新的稳定版本，请使用以下命令，替换要更新的项目的短名称 geofield：

    作曲家更新drupal / geofield --with-dependencies

  3. 如果您需要特定版本，请确定如何输入要更新的版本号。例如，对于贡献模块的版本8.x-1.7，您只需输入1.7，对于核心软件版本8.3.1，您将输入8.3.1。然后在站点的根目录中输入以下命令（替换项目的短名称geofield和正确的版本号）：

    作曲家需要drupal / geofield：1.7

扩大您的理解

您可以使用Composer的内置帮助系统了解有关Composer命令的更多信息。例如，要了解有关该create-project命令的更多信息，请composer help create-project在命令窗口中输入 。

影片

 

使用Composer和Git下载文件

其他资源

归因

由Jennifer Hodgdon， Hans Fredrik Nordhaug和 Joe Shindelar 改编自Drupalize.Me， 来自 “使用Composer来管理Drupal站点依赖”，版权所有2000-2017由Drupal社区文档的个人贡献者完成 。

评论

由 hrs, 30 六月, 2019

3.4 准备安装

标签
drupal

目标

下载核心软件，并处理所有必需的先决条件。

必备知识

网站先决条件

必须在计划托管站点的计算机上安装服务器软件。请参见第3.1节“概念：服务器要求”。

根据您计划下载核心软件的方式，您可能需要先安装其他软件工具。请参见第3.3节“概念：下载和安装核心软件的方法”和第3.2节“概念：其他工具”。

脚步

  1. 从第3.3节“概念：下载和安装核心软件的方法”中列出的方法中选择下载和安装核心软件的方法。其余说明适用于Composer和手动下载选项以及交互式安装程序; 如果您选择其他选项，则应为您安装该软件。
  2. 在服务器上为您的站点设置URL和托管。通过将简单的HTML文件放在托管的Web根目录中，并访问您站点的URL，验证托管是否正常工作。
  3. 创建数据库以及具有完全访问权限的数据库用户帐户。
  4. 使用您决定的方法将核心软件文件下载到Web根目录。有关说明的链接，请参见第3.3节“概念：下载和安装核心软件的方法”。

扩大您的理解

请参见第3.7节“运行交互式安装程序”以运行交互式安装程序。

或者，您可以在下载软件的目录中使用以下Drush命令，其中DB_NAME，DB_USER和 DB_PASS是您数据库的凭据：

drush site-install standard --db-url ='mysql：// DB_USER：DB_PASS @ localhost / DB_NAME' - site-name = example

影片

 

准备安装

其他资源

Drush

评论

由 hrs, 30 六月, 2019

3.3 概念：下载和安装核心软件的方法

标签
drupal

必备知识

有哪些方法可以下载核心软件？

在构建站点之前，您需要先下载核心软件。根据您的计划，您可以通过多种方式下载核心软件：

尝试免费的在线演示
如果您正在评估是否使用Drupal来构建站点，您可以使用在线提供程序在20分钟或更短的时间内获得核心软件的演示安装。请参阅 Drupal.org页面“尝试Drupal”。
使用托管服务提供商提供的一键式安装程序
如果您选择在托管服务提供商处安装核心软件，则您的托管服务提供商可能具有您可以使用的特定文档和/或一键安装。请参阅 Drupal.org的支持Drupal的托管服务提供商列表。
使用预配置的环境
使用包含Drupal的预配置环境或虚拟机以及所有必需的支持软件在本地安装Drupal。有关 可能的选项，请参阅Drupal.org的本地服务器设置指南下的操作系统部分 。
从网站手动下载
如果您计划构建没有具有复杂依赖关系的附加模块的站点，则可以从Web站点下载核心软件或包含核心软件和其他模块或主题的分发。有关说明，请参见第3.6节“手动下载核心软件”。
使用Composer
如果您计划使用Drush工具（请参见第3.2节“概念：其他工具”），或者如果您要构建可能使用具有复杂依赖关系的模块的站点，则应使用Composer下载核心软件，因为Composer将管理依赖关系正确。但是，如果通过手动下载来启动站点，则可以转换为使用Composer稍后管理依赖项。有关下载和转换说明，请参见第3.5节“使用Composer下载和更新文件”。

安装核心软件后会发生什么？

安装核心软件意味着设置一些数据库表，配置和管理用户帐户，以便您可以构建和使用您的站点。

有哪些方法可以安装核心软件？

有几种方法可以安装核心软件：

幕后安装程序
如果您选择使用在线演示或从托管服务提供商处单击安装程序，则可能会自动为您安装核心软件。
互动安装人员
核心软件具有交互式安装程序，可为您提供多个在线表单，然后使用您在表单中提供的信息完成安装。请参见第3.4节“准备安装”和第3.7节“运行交互式安装程序”。
演示站点安装程序
如果将核心软件下载到本地计算机，则可以快速创建一个临时演示站点，该站点使用作为PHP一部分的内置Web服务器和SQLite数据库。设置演示站点的命令在第3.6节“手动下载核心软件”的末尾给出。在这种情况下，您将不会运行交互式安装程序。
命令行工具
命令行工具（请参见第3.2节“概念：其他工具”）也可用于执行安装步骤。

评论

由 hrs, 30 六月, 2019

3.2 概念：其他工具

标签
drupal

网站建设者可以使用哪些工具？

还有一些其他工具可以帮助您更快，更准确，更省力地创建网站。

Drush和Drupal控制台
有关命令行工具的更多信息，请参见下文。
混帐
有关版本控制工具的更多信息，请参见下
作曲家
有关Composer的更多信息，请参见下文。
杰韦利
该贡献杰韦利模块有助于开发任务，如调试和检查码，分析数据库查询，并生成虚拟内容。

什么是命令行工具？

命令行工具为您网站上的各种操作提供了使用管理界面的替代方法。许多站点构建者和维护者花时间安装和学习命令行工具，因为：

  • 在命令行执行管理任务通常比在用户界面中执行更快，更乏味。
  • 您可以编写将与站点相关的命令与服务器上的其他命令组合在一起的脚本，以自动执行更复杂的任务。
  • 命令行工具提供了通过管理界面无法提供的其他功能; 例如，运行数据库查询。

最受欢迎的工具是Drush和 Drupal Console。Drush已经可用更长时间，并且具有核心软件和贡献模块的命令; 本指南介绍了许多任务的Drush命令。Drupal Console作为模块程序员的工具开始，但是有越来越多的站点构建器命令列表; 本指南未记录Drupal Console命令，但您可以在Drupal Console文档中查找它们。

要使用这些工具，您需要具有对托管您的网站的服务器的命令行终端访问权限，并且您需要首先安装Composer才能安装Drush或Drupal Console工具。

什么是版本控制系统？

版本控制系统是将文件和修订历史记录的副本保存在存储库中的软件，允许您添加，删除和更新文件。对于网站项目，修订控制软件可以帮助您：

  • 在实际站点上部署文件之前在本地进行测试
  • 查看，比较并恢复到以前版本的文件
  • 在提交更改之前查看添加，更改或删除的文件（更新存储库）
  • 合并来自不同团队成员的变更
  • 保持本地站点和实时站点之间的文件和配置同步

有许多专有和开源版本控制系统可供选择; 一个流行的选择是Git，它是在大多数计算机平台上运行的开源软件。Git是一个分布式版本控制系统，允许您拥有一个或多个存储库副本，这允许您提交对副本的更改，然后仅在您准备共享时将它们推送到您指定为规范的存储库中他们和他人在一起 规范的git存储库可以托管在您的本地计算机或公司的服务器上，但许多软件项目和个人在GitHub站点上托管他们的Git存储库。

Composer用于什么？

Composer是一个用于管理PHP依赖关系的工具，开发人员指定所需的每个外部库的版本，Composer管理下载和安装库的过程。

核心软件是Composer的主要用户，因为它使用了几个外部开发的软件库，必须下载和安装这些软件库才能使核心软件正常工作。安装核心软件时，您需要下载包含外部库的兼容版本的存档，或者需要在初始下载后运行Composer以下载外部库。Drush和Drupal Console命令行工具也可以使用Composer下载。

一些贡献的模块也使用外部开发的软件库; 例如，Facebook集成模块可能需要安装Facebook的集成库才能使模块正常工作，而地理模块可能会使用标准的地理功能库。要安装具有外部依赖性的模块，您需要运行Composer。

模块和主题开发人员可以使用哪些工具？

除了上面提到的站点构建器工具之外，以下工具对模块和主题开发人员也很有用。

Drupal控制台
Drupal Console是一个命令行工具，可生成样板代码并与Drupal站点进行交互。例如，它可以生成块或表单代码，安装模块和主题，以及创建虚拟内容。Drupal Console使用Symfony控制台。
编码器
Coder是一个命令行工具，可检查您的模块和主题是否符合编码标准和其他最佳实践。它还可以修复编码标准违规。
浏览器调试工具
Firefox和Chrome等Web浏览器包含允许查看，编辑，调试和监控CSS，HTML和JavaScript的工具。您可以通过在窗口区域中右键单击鼠标，然后选择“检查”或“检查元素”来打开调试窗格或窗口。

评论

由 hrs, 30 六月, 2019

3.1 概念：服务器要求

标签
drupal

运行核心软件有哪些要求？

磁盘空间

您网站所需的磁盘空间总量不是固定金额，因为它取决于您的网站。核心软件的基本文件在Web服务器上占用大约100 MB。如果您安装其他模块或主题，则需要更多空间，并且还需要空间来存储媒体，备份以及由您的网站生成和上传到您网站的其他文件。数据库也使用磁盘空间，尽管通常不在站点文件使用的相同区域（在某些情况下，甚至不在同一服务器上）。

PHP

PHP 7.2或更高版本。必须设置PHP，最小内存大小为64MB; 如果您在站点上运行多个模块或使用内存密集型的基于PHP的命令行工具（例如Composer），则可能需要相当多的内存。

某些PHP扩展也是必需的; 所需PHP扩展的确切列表取决于您如何安装核心软件以及您在站点上使用的模块。通常，托管服务提供商已经安装了您需要的所有PHP扩展。如果您是自托管或在本地计算机上运行您的站点，如果缺少任何所需的PHP扩展，您将在安装期间收到错误消息，并且应该能够安装并继续。

网络服务器

Apache（推荐）
Apache是​​最常用的Web服务器。核心软件适用于在UNIX / Linux，OS X或Windows上托管的Apache 2.x，其中安装并启用了Apache mod_rewrite模块。Apache VirtualHost配置必须包含指令AllowOverride All以允许使用.htaccess文件。
PHP本地服务器
您可以使用PHP暂时在计算机上运行本地演示站点，而无需安装Web服务器软件。
Nginx的
Nginx是一种常用的Web服务器，专注于高并发性，高性能和低内存使用。核心软件适用于UNIX / Linux，OS X或Windows上托管的Nginx 1.1或更高版本。必须安装并启用ngx_http_rewrite_module。
海华沙
Hiawatha是一个专注于安全性的Web服务器。它还旨在易于使用和轻量级。独立研究人员进行的研究证明，Hiawatha在正常情况下提供的性能可与其他Web服务器相媲美，但在受到攻击时效果更好。必须安装和配置URL Toolkit才能重写URL。
Microsoft IIS
Microsoft IIS是一个Web服务器和一组功能扩展模块，用于Microsoft Windows。如果正确配置了PHP，核心软件将与IIS 5，IIS 6或IIS 7一起使用。由于需要干净的URL，因此您可能需要使用第三方产品。对于IIS 7，您可以使用Microsoft URL重写模块或第三方解决方案。

数据库

使用以下数据库之一：

  • MySQL - 5.5.3（MariaDB 5.5.20，Percona 5.5.8）或更高版本，与InnoDB兼容的主存储引擎
  • PostgreSQL - 9.1.2或更高版本
  • SQLite - 3.4.2或更高版本。临时本地演示站点使用SQLite，它作为PHP的一部分分发，不需要安装单独的数据库软件。

评论

drupal