Developer Portal 中的概念

Developer Portal 基于开放式源代码内容管理技术 Drupal 10。 深入了解 Drupal 概念和术语可增强您使用 Developer Portal的能力。

在 Drupal 中，Web 站点上的大多数内容都被视为节点概念的变体。 诸如静态页面、博客帖子和新闻项之类的节点类型都以相同方式进行存储。 通过编辑菜单、视图和块，分别设计站点的导航结构。 最后，系统的主题控制站点面向访问者的整体外观。 对这些内容的访问权取决于您的角色所具有的许可权。 以下部分中对这些内容进行了更完整的说明。

节点数

节点是一组与个人相关的内容，如页面、民意调查、文章、论坛主题或博客帖子。 例如，创建博客帖子并定义正文文本时，还会定义其标题，内容，作者链接，创建日期和分类法。 这些元素中的一部分由主题层在显示节点时显示，而某些元素则是控制节点的显示位置和时间的元数据。 Developer Portal 站点中的每组内容都是一个节点。 您可以将新功能或更改应用于单一节点类型的所有内容。

字段

字段是可以向节点中添加额外元数据的位置。 以下类型数据是字段的示例：
  • 标题
  • 正文
  • 注释主体
  • 标记
  • 图像
您可以创建不同类型的字段，在 Content-Type 级别为内容项和注释定义字段，在词汇表级别为分类术语定义字段，在站点级别为用户帐户定义字段。 字段类型由模块定义，由字段模块管理。 此外，其他模块还可以为其数据定义字段。

内容类型

内容类型是预定义的一批字段。 内容类型定义内容编辑器用于在 Developer Portal 站点中添加内容的缺省字段，并帮助构造内容的编写和开发。 内容类型可以显示在 Developer Portal中。 您可以在 Developer Portal中控制哪些内容类型以及它们的显示顺序和格式。

主题

您可以使用主题来控制 Developer Portal 站点的整体外观。 您可以如下方式修改主题外观：
  1. 扩展现有主题的代码。
  2. 识别并使用 Drupal 社区或第三方站点提供的主题，并修改主题设置。
  3. 从头开始创建完整的定制主题。

但是，无法直接编辑 API Connect 主题，因为不支持编辑。 安装修订包或 iFix 时会覆盖这些文件的任何已编辑版本。 因此，创建定制主题的方法是创建 Developer Portal 在缺省情况下使用的标准 API Connect 主题的定制子主题。 除覆盖的设置以外，子主题将继承其父主题的所有设置。 有关更多信息，请参阅 创建子主题。

大多数主题都使用 PHP 的 Twig 模板引擎。

区域

Developer Portal 站点中可放置内容的特定区域。 在主题中定制区域并为其设计样式。

块

块是可在 Developer Portal 页面上的区域中显示的内容框。 可以通过启用特定模块将块提供给 Developer Portal 站点。 创建块后，可修改其外观。 您还可以定义显示哪些 Developer Portal 页面或页面块。 某些模块在启用后可提供多个块，而其他模块可能不会定义新块。 有关更多信息，请参阅 添加和更改 Developer Portal 页面上显示的块。

模块

模块类似于插件的概念，因为它们扩展了 Developer Portal 站点的核心功能。 缺省情况下，将使用 Drupal 核心实施一组模块，还有其他一些模块，启用后可扩展缺省功能。 您可以从因特网查找更多模块并将其添加到 Developer Portal 站点。 有关更多信息，请参阅 扩展。

视图

您可以使用视图来处理在 Developer Portal 站点中的页面，块和其他可视元素上显示的内容。 视图可与内容类型一起使用，以根据您的规范将站点外观格式化。 有关更多信息，请参阅 在 Developer Portal 中使用 "视图" 模块。

页面

页面由可修改 Developer Portal 外观的功能部件使用，以定制 Developer Portal 站点的外观。 页面可以根据需要具体定制，并且可以配置为满足其使用情境的上下文。

用户

登录到 Developer Portal 站点后，您在 Developer Portal 数据库中具有用户记录。 系统始终为管理员帐户保留用户标识 1。 无论其他用户帐户是否正在使用远程认证 (例如 LDAP) ，管理员帐户始终是本地帐户，以启用 Developer Portal 站点的管理。 有关更多信息，请参阅 人员。

角色

角色是一组许可权，用于定义用户可以在 Developer Portal 站点中执行的操作。 可以为用户提供一个或多个角色。 缺省情况下，登录到 Developer Portal 的用户处于 已认证 角色。 可以向用户分配的其他角色包括：
  • 管理员
  • 论坛管理员
  • 内容作者
还可以创建新的定制角色。 有关更多信息，请参阅 在 Developer Portal 中使用角色。

许可权

许可权定义用户可以或不能在 Developer Portal 站点中执行的操作。 许可权是可以累加的。 如果未分配允许用户执行操作的许可权，那么用户无法执行该操作。 如果用户具有多个角色，并且任何角色都包含特定许可权，那么用户能够执行该操作。 还有一些许可权具有安全隐患，建议您将这些许可权分配给可信角色。 有关更多信息，请参阅 控制对 Developer Portal 内容的访问。

模板

模板文件定义特定组件的输出的外观。 它们格式化为 Twig 模板文件。 以下是可使用模板的位置示例：
  • html.html.twig - Developer Portal HTML 页面的模板
  • page.html.twig - Developer Portal HTML 页面的主体
  • node.html.twig - 所有内容节点的模板
  • comment.html.twig - 所有注释节点的模板
  • search-result.html.twig - 搜索结果的模板
  • node--product.html.twig - 使用产品内容类型的节点的模板
  • node--product--teaser.html.twig - 产品内容类型的预览模板

有关在 Developer Portal中覆盖模板的更多信息，请参阅 应用修改后的内容类型模板。