您正在查看的是 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 自定义博客模块:
- 确保您的门户已升级到 14.02.156.1 或更高版本。
- 以拥有管理员或内容创建权限的用户身份登录门户。
- 在 Drupal 菜单中选择 Modules。
- 停用 Blog 模块。
- 启用以下三个 Apigee 自定义模块:
- Devconnect 博客
- 开发 内容创建菜单
- devconnect 博客内容类型
- 保存配置。
查看博客
开发者门户会在“博客”页面上显示最近的博文。博客条目按创建时间降序显示。如需显示“博客”页面,请在开发者门户主菜单中选择“博客”。
此外,开发者门户最初设置为在首页上显示最近的博文。条目还会按创建时间降序显示。
设置博客的权限
作为管理员,您可以控制对博客执行操作(例如创建、修改和删除博文)所需的权限。
您还可以配置发布、修改和删除博客评论所需的权限,以及用户是否必须审核用户的评论。如果评论无需审核,该评论会立即显示。如果评论必须审核,则必须由拥有审核评论所需权限的门户用户批准。
如需设置博客权限,请执行以下操作:
- 以拥有管理员或内容创建权限的用户身份登录门户。
- 在 Drupal 菜单中选择 People。
- 选择“用户”页面顶部的权限链接。
- 向下滚动到页面的评论区域。
- 在评论区域下方,设置以下权限,以控制哪些用户能够添加、查看、修改和批准评论:
- 管理评论和评论设置
- 查看评论
- 帖子评论
- 跳过评论批准
- 编辑自己的评论
- 向下滚动到页面的节点区域。
- 在节点区域下,设置五种不同的权限,用于控制哪些用户可以添加、修改和删除博文:
- 博文:创建新内容
- 博文:修改自己的内容
- 博文:修改任意内容
- 博文:删除自己的内容
- 博文:删除所有内容
- 保存配置。
添加博文
所有拥有必要权限的用户都可以创建博客条目。但是,您可以配置用户角色,使用户可以添加和修改自己的博客条目,但不能将其删除。或者,他们可以添加、修改和删除自己的博客条目,但不能编辑其他用户的博客条目。
如果您的门户版本使用 Drupal Blog 模块,系统会显示以下按钮,以便您创建博客条目:
将显示默认的博客编辑页面:
如果您使用的是 Apigee 自定义博客,并且启用了对所有博客内容类型的支持,则系统会显示以下菜单,以便您创建不同类型的博客条目:
选择相应内容类型的按钮,创建新博客条目。根据所选的内容类型,系统会显示以下编辑器:
使用右下角的按钮,您可以添加由 Bootstrap 项目定义的内容,包括轮播界面、featurette、Jumbotron 和三角形。
在下部区域,您可以添加相关媒体。例如,在上图中,对于视频内容类型,您可以向博客条目添加视频。
如需添加博客条目,请执行以下操作:
- 以拥有管理员或内容创建权限的用户身份登录门户。
- 在开发者门户导航菜单中选择博客。
- 选择创建新博客条目(Drupal 博客模块)或内容类型(Apigee 自定义博客)。
- 在 Title 和 Body 部分添加内容。
- 如果适用,请点击修改摘要以添加摘要。
- 输入以逗号分隔的关键字列表。这些关键词用于填充“博客”页面上的“热门主题”视图。您可以选择将“热门主题”视图添加到首页或其他任何页面。
根据博客条目的类型,您可能需要展开网页的元标记区域,才能输入关键字。 - 点击保存。
博客会发布到博客的首页,并列在首页的“近期博文”区域。
当您创建新的博客条目时,“博客”模块会记录有关内容的基本信息,包括作者 ID、创建日期和内容类型。
管理博客评论
开发者门户的用户可以向博客条目发布评论。默认情况下,用户必须登录门户才能发布评论。用户能否查看、发布、修改和批准评论取决于其角色和权限(如上所述)。
如需管理评论,请执行以下操作:
- 以拥有管理员或评论批准权限的用户身份登录您的门户。
- 在 Drupal 管理菜单中,依次选择内容 > 评论。
- 选择已发布的评论链接或未获批准的评论链接。
- 使用该页面审核评论。
配置“博客”页面的显示方式
开发者门户使用 Drupal 视图(称为标记为博客内容的内容视图)来控制博客条目在“博客”页面上的显示方式。默认情况下,博客条目会按创建日期降序排列。
要配置博客视图,请执行以下操作:
- 以拥有管理员或内容创建权限的用户身份登录门户。
- 在 Drupal 管理菜单中,依次选择结构 > 视图。
- 在标记为博客内容视图 (内容)视图的行中选择修改链接。系统会显示以下页面,您可以用该页面配置该视图:
- 修改视图。
- 保存更改。
配置博客条目的热门主题显示
开发者门户使用名为热门主题的 Drupal 视图来控制博客条目上博客条目的热门主题显示。默认情况下,热门主题项与添加到博文中的关键字相对应。
要配置“热门主题”视图,请执行以下操作:
- 以拥有管理员或内容创建权限的用户身份登录门户。
- 在 Drupal 管理菜单中,依次选择结构 > 视图。
- 在热门主题(内容)视图对应的行中,选择修改链接。系统会显示可用于配置视图的页面。
- 修改视图。
- 保存更改。
使用论坛
在论坛中,拥有必要权限的用户可以创建话题式讨论,其功能类似于其他留言板系统。主题包含在论坛内,每个论坛可以包含多个主题。主题也可以有自己的网址。
用户在论坛中发布新主题。每个论坛主题都由一个初始帖子以及回复或评论组成。根据用户的权限,用户可以修改和删除自己的博文,以及修改和删除其他用户的帖子。
默认情况下,匿名用户可以查看帖子,但不能发布回复。只有通过身份验证且拥有必要权限的用户才能回复帖子。回复一经输入即会显示,这意味着系统不会对回复进行审核。
管理员可以设置发帖、修改现有帖子和删除帖子所需的权限。管理员还可以将论坛帖子提升到首页的“论坛讨论”区域。
确定论坛使用的 Drupal 模块
该门户使用两个 Drupal 模块来实现论坛:
- Drupal Forum 模块是核心论坛模块,14.02.156.1 之前的门户版本默认使用该模块。
- Drupal 高级论坛模块增强了核心论坛模块,以添加更多功能,包括改进的样式、快速搜索活跃主题、未回答的主题、新主题等。默认情况下,门户 14.02.156.1 版及更高版本使用 Drupal Advance Forum 模块。
如需确定哪个模块处于活动状态,请执行以下操作:
- 以拥有管理员或内容创建权限的用户身份登录门户。
- 在 Drupal 菜单中选择 Modules。
- 在“模块”页面顶部的过滤器列表中输入“论坛”。
- 如果列出并启用了高级论坛模块,则说明您使用的是高级论坛模块。
- 如果高级论坛模块缺失或已停用,并且论坛模块已启用,则说明您使用的是核心论坛模块。
或者,您可以使用以下 c网址 命令发现门户版本:
$ curl <portal url>/buildInfo
配置高级论坛模块
高级论坛模块具有一些配置设置,可用于控制论坛的显示、面包屑导航和其他视觉特征。
如需配置高级论坛模块,请执行以下操作:
- 以拥有管理员或内容创建权限的用户身份登录门户。
- 在 Drupal 菜单中,依次选择配置 > 内容创作 > 高级论坛。系统会显示“高级论坛”页面。
- 设置显示选项。
- 保存配置。
设置论坛的权限
作为管理员,您可以控制在论坛上执行操作所需的权限。您可以设置高级论坛和论坛模块使用的权限,并为每个模块设置特定的权限。
如需设置论坛权限,请执行以下操作:
- 以拥有管理员或内容创建权限的用户身份登录门户。
- 在 Drupal 菜单中选择 People。
- 选择“用户”页面顶部的权限链接。
- 如果您使用的是高级论坛模块,请向下滚动到高级论坛区域并设置关联权限。
- 如果您使用的是论坛模块,请向下滚动到论坛区域并设置相关权限。
- 向下滚动到页面的节点区域。
- 在节点区域下,设置五种不同的权限,用于控制哪些用户可以添加、修改和删除论坛帖子:
- 论坛主题:创建新内容
- 论坛主题:修改自己的内容
- 论坛主题:修改内容
- 论坛主题:删除自己的内容
- 论坛主题:删除任何内容
- 保存配置。
添加论坛
默认情况下,开发者门户带有一个名为“General 讨论”的论坛。您可以添加其他论坛、嵌套论坛,并创建由论坛群组构成的论坛容器。
论坛容器提供了一种创建论坛集合的方法。不过,容器本身并不是论坛,它只是定义了一系列论坛。
如需添加论坛,请按以下步骤操作:
- 以拥有管理员或内容创建权限的用户身份登录门户。
- 在 Drupal 菜单中依次选择结构 > 论坛以查看当前论坛的列表。
在此页面上,您可以修改现有论坛或重新排列论坛在“论坛”页面上的显示顺序。 - 选择 +添加论坛。
- 添加有关新论坛的信息,包括其父级(如果您想嵌套论坛)。
- 选择保存。
如需对论坛重新排序,请执行以下操作:
- 以拥有管理员或内容创建权限的用户身份登录门户。
- 在 Drupal 菜单中依次选择结构 > 论坛以查看当前论坛的列表。
- 点击并拖动论坛名称前的加号 +,可更改其顺序或嵌套级别。
- 保存更改。
如需添加论坛容器,请按以下步骤操作:
- 以拥有管理员或内容创建权限的用户身份登录门户。
- 在 Drupal 菜单中依次选择结构 > 论坛以查看当前论坛的列表。
- 选择 +添加容器。
- 添加有关新容器的信息,包括其父级(如果您想嵌套该容器)。
- 选择保存。
系统会打开论坛页面。 - 在论坛页面上,点击并拖动论坛名称旁边的加号 +,将其添加到新容器中。
- 保存更改。
将论坛主题提升到首页
默认首页包含一个 Drupal 视图,它控制着首页的“论坛讨论”区域的内容。管理员必须提升该论坛主题,该主题才会显示在“论坛讨论”区域。
如需宣传论坛主题,请按以下步骤操作:
- 以拥有管理员或评论批准权限的用户身份登录您的门户。
- 在 Drupal 管理菜单中选择内容。
- 在类型下拉框中选择论坛主题,然后选择应用,以过滤内容。
只有论坛主题才会显示在内容列表中。 - 选择一个或多个要宣传的论坛主题。
- 在操作下拉列表中,选择晋升到首页。
- 选择执行。
所有选定的主题现在都会显示在首页的“论坛讨论”区域。
或者,您也可以修改单个论坛帖子,然后在该主题的发布选项中选择晋升到首页。