自定义外观

您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档。 信息

您可以自定义开发者服务门户的外观，使其符合您的公司主题、向门户添加新内容区域，或更改门户上任何页面的布局。此配置中的大部分内容都需要具备 Drupal 的应用知识。但是，本页面介绍了您在自定义门户时可能需要执行的一些基本任务。

自定义网站标题和标语

您可以设置网站的标题和宣传口号。在首页上，标题和标语会显示为：

"标题 | 标语"

标题为必填项，默认设为“新建 Apigee 网站”。标语不是必需的，默认情况下为空。

如需设置标题和标语，请执行以下操作：

  1. 以拥有管理员或内容创建权限的用户身份登录门户。
  2. 在 Drupal 管理菜单中，依次选择配置 > 系统 > 网站信息。
  3. 在“网站信息”页面上，设置网站名称，并视需要设置标语。
  4. 保存配置。
    请注意，由于缓存的原因，对功能块和标语的更改可能不会立即显示。您可以选择刷新缓存以显示这些更改。如需清除缓存，请选择 Drupal 管理菜单最左侧的 Drupal 图标，然后选择“刷新所有缓存”。

自定义首页的布局

下图显示了首页的布局：

Drupal 提供了一种用于控制此页面显示的大量机制。本部分介绍默认主页面的布局元素以及如何修改这些元素。如需对页面进行全面的重新设计，请参阅 Drupal 文档。

首页分为以下几个部分：

  • 主菜单：包含 Apigee 徽标以及“博客”和“论坛”菜单项。 下文介绍如何配置主菜单。
  • 欢迎辞：主菜单下方以文本“Welcome to the ...”开头的字符串。自定义主题背景介绍了如何配置欢迎辞。
  • 顶部区域：主菜单下方的区域，包含欢迎辞、两个包含指向文档和构建的链接的框，以及一个大图标。此区域由 Drupal Block 定义。Blocks 是 Drupal 页面上的矩形内容区域。如需配置顶部区域，请按下文所述修改用于定义该区域内容的 Drupal Block。
  • 底部区域：此区域包含“近期博文”、“论坛讨论”和“热门主题”区域。这三个部分以 Drupal 视图的形式实现。添加博客和论坛帖子介绍了如何修改这些视图。
  • 页脚：包含隐私权政策、条款和使用以及联系方式链接。 请参阅编辑页脚页面。

自定义用于定义首页顶部区域的块

  1. 以拥有管理员权限的用户身份登录您的门户。
  2. 在 Drupal 管理菜单中，依次选择结构 > 块。
  3. 在“屏蔽”页面上，为名为“主页标题”的屏蔽选择configure链接。
    首页标头块的正文是 HTML 代码，用于定义该块的外观
  4. 根据需要修改该组成要素。
  5. 选择保存块。
  6. 转到您的首页即可查看更改。

自定义主菜单

主菜单显示在开发者门户的每个页面顶部。默认情况下，它会显示 Apigee 徽标和两个菜单项：博客和论坛。您可以修改主菜单，将其更改为徽标并设置自己的菜单项。

如需更改徽标，请执行以下操作：

  1. 以拥有管理员或内容创建权限的用户身份登录门户。
  2. 如果您的默认主题是 Apigee 自适应主题：
    1. 依次选择外观 > 设置。
  3. 如果您的默认主题是 Apigee DevConnect 主题：
    1. 依次选择 Appearance > Settings > Apigee DevConnect Theme。
  4. 在“徽标图片”设置下，取消选择使用默认徽标。
    页面会发生变化，让您可以浏览并上传图片文件。
  5. 在“上传徽标图片”下，选择选择文件按钮，然后找到您的图片文件。
  6. 选择打开以上传文件。
  7. 点击 Save Configuration（保存配置）。

如需修改菜单项，请执行以下操作：

  1. 以拥有管理员或内容创建权限的用户身份登录门户。
  2. 在 Drupal 管理菜单中，依次选择结构 > 菜单 > 主菜单。
    您可以使用此页面添加、移除和重新排列菜单项。
  3. 点击添加链接以添加新的菜单项。
  4. 添加所需信息，然后选择保存。
  5. 点击“主菜单”页面上的保存配置。

将“My Apps”页面重命名为“My API”

默认情况下，每个门户开发者都有一个名为“我的应用”的页面，用于添加、修改和删除应用以及与这些应用关联的 API 密钥。例如，开发者可以拥有多个应用、修改应用以添加或移除 API 产品，以及查看有关应用使用情况的分析信息，所有这些操作都可以在“我的应用”页面上完成。

但是，有些 API 提供商希望简化门户上的信息显示，并简化开发者与门户的交互。例如，您可以将该门户配置为在开发者在该门户上注册时创建默认的应用和 API 密钥。该应用甚至可能是开发者能够访问的唯一应用，而且网站不允许用户修改该应用。如需了解如何创建默认应用，请参阅添加和管理用户帐号。

某些网站根本不想使用“应用”一词。这些网站是指 API 和 API 密钥。在这种情况下，您需要配置门户以将术语“app”替换为“API”，以便开发者现在具有一个名为“My APIs”的页面。不过，页面上显示的信息与页面称为“我的应用”时显示的信息相同，如下所示：

此次变更不仅会影响“我的 API”页面的标题，还会影响其他区域。例如，在上图中，请注意，右侧的按钮现在显示的是“Add a new API”，并且其下方的文本引用的是 API，而不是应用。

如需配置门户以显示“我的 API”，请执行以下操作：

  1. 以拥有管理员或内容创建权限的用户身份登录门户。
  2. 在 Drupal 管理菜单中，依次选择配置 > 开发门户 > 应用设置。
  3. 展开页面的应用界面设置区域。
  4. 选择与您要起诉的文字对应的单选按钮。
  5. 点击保存更改。
  6. 在 Drupal 管理菜单中，依次选择结构 > 菜单 > 主菜单。
  7. 点击我的应用条目的修改链接。
  8. 修改 Menu link title，使其显示 My APIs。
  9. 点击保存。
  10. 点击“主菜单”页面上的保存配置。

为移动设备启用 Drupal 管理菜单

默认的 Drupal 管理菜单与移动设备的小屏幕尺寸不兼容。如果您想在移动设备上管理门户，可以启用新的管理菜单，该菜单支持屏幕宽度为 767 像素或更大的移动设备。

如要启用与移动设备兼容的“管理”菜单，请执行以下操作：

  1. 以拥有管理员或内容创建权限的用户身份登录门户。
  2. 在 Drupal 管理菜单中选择模块。系统会显示所有已安装的 Drupal 模块的列表。
  3. 下载并安装 Navbar 模块。
  4. 如果启用，请停用管理菜单工具栏样式模块。
  5. 点击 Save configuration（保存配置）。
  6. 停用管理菜单模块。
  7. 启用 Navbar 模块。
  8. 点击 Save configuration（保存配置）。

您现在会看到与移动设备兼容的 Drupal 管理菜单。