添加博客和论坛帖子

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

通过开发者服务门户,您可以创建博客和会话式论坛:

  • 博客支持可让用户创建、修改和删除博文。此外,借助基于角色的权限,您可以将博客操作限制为特定用户类型。
  • 论坛中,用户可以通过基于角色的审核功能创建话题式讨论。您可以向门户添加论坛,按层次结构对论坛进行分组,并配置用户角色来控制对论坛的访问权限。

使用博客

拥有必要权限的用户可以通过该门户创建、修改和删除博文。博客由单独的帖子组成,这些帖子带有时间戳并按日期查看。任何人(包括匿名用户)都可以使用门户首页提供的导航链接查看最新的博客条目。

任何拥有必要权限的用户都可以对博文发表评论。评论一经输入即可立即显示,您也可以配置开发者门户,要求评论必须先经过审核才能显示。默认情况下,匿名用户无法发表评论。

关于博客类型

门户支持两种博客类型,具体取决于您的门户版本:

  • 14.02.156.1 之前的门户版本会默认使用 Drupal Blog 模块实现的标准博客。
  • Apigee 自定义博客,具有博文自定义视图、对图片、音频和视频内容类型的支持以及由自定义 Apigee Drupal 模块实现的“微博式”编辑工具栏。默认情况下,门户 14.02.156.1 版及更高版本使用 Apigee 自定义博客。在升级到版本 14.02.156.1 的过程中,现有门户可以升级为使用新博客。

自定义博客由 Apigee 提供的三个自定义 Drupal 模块定义。下表介绍了这些模块:

单元 定义
Devconnect 博客 定义博客的基本功能。
开发内容创建菜单 定义用于创建不同类型的博客内容的菜单。
devconnect 博客内容类型 定义博客的 Drupal 特殊内容类型:图片、音频和视频。如果没有此模块,您只能创建文章类型的博客条目。

确定您的门户版本以及支持的博客类型

您可以使用以下 c网址 命令发现门户版本:

$ curl <portal url>/buildInfo

如果您想使用自定义博客,请确保您的版本为 14.02.156.1 或更高版本。

升级现有门户以使用 Apigee 自定义博客模块

  1. 确保您的门户已升级到 14.02.156.1 或更高版本。
  2. 以拥有管理员或内容创建权限的用户身份登录门户。
  3. 在 Drupal 菜单中选择 Modules
  4. 停用 Blog 模块。
  5. 启用以下三个 Apigee 自定义模块:
    • Devconnect 博客
    • 开发 内容创建菜单
    • devconnect 博客内容类型
  6. 保存配置。

查看博客

开发者门户会在“博客”页面上显示最近的博文。博客条目按创建时间降序显示。如需显示“博客”页面,请在开发者门户主菜单中选择“博客”。

此外,开发者门户最初设置为在首页上显示最近的博文。条目还会按创建时间降序显示。

设置博客的权限

作为管理员,您可以控制对博客执行操作(例如创建、修改和删除博文)所需的权限。

您还可以配置发布、修改和删除博客评论所需的权限,以及用户是否必须审核用户的评论。如果评论无需审核,该评论会立即显示。如果评论必须审核,则必须由拥有审核评论所需权限的门户用户批准。

如需设置博客权限,请执行以下操作

  1. 以拥有管理员或内容创建权限的用户身份登录门户。
  2. 在 Drupal 菜单中选择 People
  3. 选择“用户”页面顶部的权限链接。
  4. 向下滚动到页面的评论区域。
  5. 评论区域下方,设置以下权限,以控制哪些用户能够添加、查看、修改和批准评论:
    • 管理评论和评论设置
    • 查看评论
    • 帖子评论
    • 跳过评论批准
    • 编辑自己的评论
  6. 向下滚动到页面的节点区域。
  7. 节点区域下,设置五种不同的权限,用于控制哪些用户可以添加、修改和删除博文:
    • 博文:创建新内容
    • 博文:修改自己的内容
    • 博文:修改任意内容
    • 博文:删除自己的内容
    • 博文:删除所有内容
  8. 保存配置。

添加博文

所有拥有必要权限的用户都可以创建博客条目。但是,您可以配置用户角色,使用户可以添加和修改自己的博客条目,但不能将其删除。或者,他们可以添加、修改和删除自己的博客条目,但不能编辑其他用户的博客条目。

如果您的门户版本使用 Drupal Blog 模块,系统会显示以下按钮,以便您创建博客条目:

将显示默认的博客编辑页面:

如果您使用的是 Apigee 自定义博客,并且启用了对所有博客内容类型的支持,则系统会显示以下菜单,以便您创建不同类型的博客条目:

选择相应内容类型的按钮,创建新博客条目。根据所选的内容类型,系统会显示以下编辑器:

使用右下角的按钮,您可以添加由 Bootstrap 项目定义的内容,包括轮播界面、featurette、Jumbotron 和三角形。

在下部区域,您可以添加相关媒体。例如,在上图中,对于视频内容类型,您可以向博客条目添加视频。

如需添加博客条目,请执行以下操作

  1. 以拥有管理员或内容创建权限的用户身份登录门户。
  2. 在开发者门户导航菜单中选择博客
  3. 选择创建新博客条目(Drupal 博客模块)或内容类型(Apigee 自定义博客)。
  4. TitleBody 部分添加内容。
  5. 如果适用,请点击修改摘要以添加摘要。
  6. 输入以逗号分隔的关键字列表。这些关键词用于填充“博客”页面上的“热门主题”视图。您可以选择将“热门主题”视图添加到首页或其他任何页面。
    根据博客条目的类型,您可能需要展开网页的元标记区域,才能输入关键字。
  7. 点击保存
    博客会发布到博客的首页,并列在首页的“近期博文”区域。

当您创建新的博客条目时,“博客”模块会记录有关内容的基本信息,包括作者 ID、创建日期和内容类型。

管理博客评论

开发者门户的用户可以向博客条目发布评论。默认情况下,用户必须登录门户才能发布评论。用户能否查看、发布、修改和批准评论取决于其角色和权限(如上所述)。

如需管理评论,请执行以下操作

  1. 以拥有管理员或评论批准权限的用户身份登录您的门户。
  2. 在 Drupal 管理菜单中,依次选择内容 > 评论
  3. 选择已发布的评论链接或未获批准的评论链接。
  4. 使用该页面审核评论。

配置“博客”页面的显示方式

开发者门户使用 Drupal 视图(称为标记为博客内容的内容视图)来控制博客条目在“博客”页面上的显示方式。默认情况下,博客条目会按创建日期降序排列。

要配置博客视图,请执行以下操作

  1. 以拥有管理员或内容创建权限的用户身份登录门户。
  2. 在 Drupal 管理菜单中,依次选择结构 > 视图
  3. 标记为博客内容视图 (内容)视图的行中选择修改链接。系统会显示以下页面,您可以用该页面配置该视图:

  4. 修改视图。
  5. 保存更改。

配置博客条目的热门主题显示

开发者门户使用名为热门主题的 Drupal 视图来控制博客条目上博客条目的热门主题显示。默认情况下,热门主题项与添加到博文中的关键字相对应。

要配置“热门主题”视图,请执行以下操作

  1. 以拥有管理员或内容创建权限的用户身份登录门户。
  2. 在 Drupal 管理菜单中,依次选择结构 > 视图
  3. 热门主题(内容)视图对应的行中,选择修改链接。系统会显示可用于配置视图的页面。
  4. 修改视图。
  5. 保存更改。

使用论坛

在论坛中,拥有必要权限的用户可以创建话题式讨论,其功能类似于其他留言板系统。主题包含在论坛内,每个论坛可以包含多个主题。主题也可以有自己的网址。

用户在论坛中发布新主题。每个论坛主题都由一个初始帖子以及回复或评论组成。根据用户的权限,用户可以修改和删除自己的博文,以及修改和删除其他用户的帖子。

默认情况下,匿名用户可以查看帖子,但不能发布回复。只有通过身份验证且拥有必要权限的用户才能回复帖子。回复一经输入即会显示,这意味着系统不会对回复进行审核。

管理员可以设置发帖、修改现有帖子和删除帖子所需的权限。管理员还可以将论坛帖子提升到首页的“论坛讨论”区域。

确定论坛使用的 Drupal 模块

该门户使用两个 Drupal 模块来实现论坛:

  • Drupal Forum 模块是核心论坛模块,14.02.156.1 之前的门户版本默认使用该模块。
  • Drupal 高级论坛模块增强了核心论坛模块,以添加更多功能,包括改进的样式、快速搜索活跃主题、未回答的主题、新主题等。默认情况下,门户 14.02.156.1 版及更高版本使用 Drupal Advance Forum 模块。

如需确定哪个模块处于活动状态,请执行以下操作

  1. 以拥有管理员或内容创建权限的用户身份登录门户。
  2. 在 Drupal 菜单中选择 Modules
  3. 在“模块”页面顶部的过滤器列表中输入“论坛”。
    • 如果列出并启用了高级论坛模块,则说明您使用的是高级论坛模块。
    • 如果高级论坛模块缺失或已停用,并且论坛模块已启用,则说明您使用的是核心论坛模块。

或者,您可以使用以下 c网址 命令发现门户版本:

$ curl <portal url>/buildInfo

配置高级论坛模块

高级论坛模块具有一些配置设置,可用于控制论坛的显示、面包屑导航和其他视觉特征。

如需配置高级论坛模块,请执行以下操作

  1. 以拥有管理员或内容创建权限的用户身份登录门户。
  2. 在 Drupal 菜单中,依次选择配置 > 内容创作 > 高级论坛。系统会显示“高级论坛”页面。
  3. 设置显示选项。
  4. 保存配置。

设置论坛的权限

作为管理员,您可以控制在论坛上执行操作所需的权限。您可以设置高级论坛和论坛模块使用的权限,并为每个模块设置特定的权限。

如需设置论坛权限,请执行以下操作

  1. 以拥有管理员或内容创建权限的用户身份登录门户。
  2. 在 Drupal 菜单中选择 People
  3. 选择“用户”页面顶部的权限链接。
    • 如果您使用的是高级论坛模块,请向下滚动到高级论坛区域并设置关联权限。
    • 如果您使用的是论坛模块,请向下滚动到论坛区域并设置相关权限。
  4. 向下滚动到页面的节点区域。
  5. 节点区域下,设置五种不同的权限,用于控制哪些用户可以添加、修改和删除论坛帖子:
    • 论坛主题:创建新内容
    • 论坛主题:修改自己的内容
    • 论坛主题:修改内容
    • 论坛主题:删除自己的内容
    • 论坛主题:删除任何内容
  6. 保存配置。

添加论坛

默认情况下,开发者门户带有一个名为“General 讨论”的论坛。您可以添加其他论坛、嵌套论坛,并创建由论坛群组构成的论坛容器。

论坛容器提供了一种创建论坛集合的方法。不过,容器本身并不是论坛,它只是定义了一系列论坛。

如需添加论坛,请按以下步骤操作

  1. 以拥有管理员或内容创建权限的用户身份登录门户。
  2. 在 Drupal 菜单中依次选择结构 > 论坛以查看当前论坛的列表。
    在此页面上,您可以修改现有论坛或重新排列论坛在“论坛”页面上的显示顺序。
  3. 选择 +添加论坛
  4. 添加有关新论坛的信息,包括其父级(如果您想嵌套论坛)。
  5. 选择保存

如需对论坛重新排序,请执行以下操作

  1. 以拥有管理员或内容创建权限的用户身份登录门户。
  2. 在 Drupal 菜单中依次选择结构 > 论坛以查看当前论坛的列表。
  3. 点击并拖动论坛名称前的加号 +,可更改其顺序或嵌套级别。
  4. 保存更改。

如需添加论坛容器,请按以下步骤操作

  1. 以拥有管理员或内容创建权限的用户身份登录门户。
  2. 在 Drupal 菜单中依次选择结构 > 论坛以查看当前论坛的列表。
  3. 选择 +添加容器。
  4. 添加有关新容器的信息,包括其父级(如果您想嵌套该容器)。
  5. 选择保存
    系统会打开论坛页面。
  6. 论坛页面上,点击并拖动论坛名称旁边的加号 +,将其添加到新容器中。
  7. 保存更改。

将论坛主题提升到首页

默认首页包含一个 Drupal 视图,它控制着首页的“论坛讨论”区域的内容。管理员必须提升该论坛主题,该主题才会显示在“论坛讨论”区域。

如需宣传论坛主题,请按以下步骤操作

  1. 以拥有管理员或评论批准权限的用户身份登录您的门户。
  2. 在 Drupal 管理菜单中选择内容
  3. 类型下拉框中选择论坛主题,然后选择应用,以过滤内容。
    只有论坛主题才会显示在内容列表中。
  4. 选择一个或多个要宣传的论坛主题。
  5. 操作下拉列表中,选择晋升到首页
  6. 选择执行
    所有选定的主题现在都会显示在首页的“论坛讨论”区域。

或者,您也可以修改单个论坛帖子,然后在该主题的发布选项中选择晋升到首页