自定义外观

您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 信息

您可以自定义开发者服务门户的外观，使其与您的公司主题相匹配，为门户添加新的内容区域，或更改门户上任何页面的布局。此配置的大部分内容都需要具备 Drupal 的实际使用知识。不过，本页介绍了您可能需要执行的一些基本任务，以便自定义门户。

自定义网站标题和口号

您可以为网站设置标题和口号。在首页上，标题和口号的显示方式如下：

“标题 | 口号”

标题是必填字段，默认设置为“New Apigee Site”（新 Apigee 网站）。口号不是必填字段，默认处于空白状态。

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

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

自定义首页的布局

下图显示了首页的布局：

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

首页分为以下几个部分：

  • 主菜单：包含 Apigee 徽标以及“博客”和“论坛”菜单条目。 下一部分介绍了如何配置主菜单。
  • 欢迎消息：主菜单下方以“欢迎使用...”开头的字符串。自定义主题介绍了如何配置欢迎消息。
  • 顶部区域：主菜单下方包含欢迎消息、两个包含文档链接和包含访问密钥的构建的框，以及一个大图标的区域。此区域由 Drupal 块定义。块是 Drupal 网页上的矩形内容区域。如需配置顶部区域，请修改用于定义该区域内容的 Drupal 块，如下所述。
  • 底部区域：包括“近期博文”“论坛讨论”和“热门主题”区域。这三个区域都是作为 Drupal 视图实现的。添加博文和论坛帖子介绍了如何修改这些视图。
  • 页脚：包含隐私权政策、使用条款和联系信息链接。 请参阅修改页脚页面。

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

  1. 以具有管理员权限的用户身份登录门户。
  2. 在 Drupal 管理菜单中，依次选择 Structure > Blocks。
  3. 在“版块”页面上，选择名为“首页标题”的版块的配置链接。
    首页标题代码块的正文是用于定义该代码块外观的 HTML 代码
  4. 根据需要修改代码块。
  5. 选择保存块。
  6. 前往您的首页查看更改。

自定义主菜单

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

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

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

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

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

将“我的应用”页面重命名为“我的 API”

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

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

有些网站根本不想使用“应用”一词。这些网站会提及 API 和 API 密钥。在这种情况下，您可以将门户配置为将“应用”一词替换为“API”，这样开发者现在就会看到一个名为“我的 API”的页面。不过，页面上显示的信息与页面名为“我的应用”时显示的信息相同，如下所示：

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

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

  1. 以拥有管理员权限或内容创建权限的用户身份登录您的门户。
  2. 在 Drupal 管理菜单中，依次选择配置 > 开发者门户 > 应用设置。
  3. 展开该页面的应用界面设置区域。
  4. 选择与您要起诉的文字对应的单选按钮。
  5. 点击保存更改。
  6. 在 Drupal 管理菜单中，依次选择 Structure > Menus > Main menu。
  7. 点击我的应用条目的修改链接。
  8. 修改菜单链接标题，将其设为我的 API。
  9. 点击保存。
  10. 点击“主菜单”页面上的保存配置。

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

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

如需启用适用于移动设备的管理菜单，请执行以下操作：

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

现在，您会看到适用于移动设备的 Drupal 后台菜单。