使用注释 using-comments
简介 introduction
“评论”功能用于允许登录的网站访客（成员）分享他们关于网站内容的看法和知识。 此功能通常已存在于其他功能中，但可以添加到任何网站。
本文档描述了：
- 正在将
Comments添加到页面。 Comments组件的配置设置。
向页面添加评论 adding-comments-to-a-page
要将Comments组件添加到创作模式下的页面，请使用组件浏览器来查找
Communities / Comments
并将其拖动到页面上的适当位置，例如相对于要供用户注释的功能的位置，或仅拖动到页面底部。
有关必要的信息，请访问社区组件基础知识。
当包含所需的客户端库时，Comments组件的显示方式如下所示。
Comments组件。 请注意，若干社区功能已经包含评论，例如博客、日历、论坛、问题与解答以及评论。配置评论 configuring-comments
选择要访问的已放置的Comments组件，并选择用于打开“编辑”对话框的Configure图标。
“评论”选项卡 comments-tab
在 评论 选项卡下，指定访客输入评论的方式。
-
允许回复
如果选中，则允许成员回复现有注释。 默认值为取消选中。
-
每页 条评论
限制每页显示的评论数和显示的回复数。 默认值为10。
-
允许文件上传
如果选中，上载文件的选项将显示为文本输入框。 默认值为取消选中。
-
最大文件大小
仅在选中允许文件上传时才相关。 此值限制上传的文件大小。 默认限制为10 MB。
-
最大消息长度
可输入文本框的最大字符数。 默认值为4096个字符。
-
允许的文件类型
仅在选中允许文件上传时才相关。 以“点”分隔符分隔的文件名扩展名列表。 例如： .jpg、.jpeg、.png、.doc、.docx、.pdf。 如果指定了任何文件类型，则不允许使用未指定的文件类型。 默认值为无指定以便允许所有文件类型。
-
富文本编辑器
如果选中，则使用标注输入注释。 默认值为取消选中。
-
允许投票
如果选中，则会显示文本输入框中的向上或向下投票选项。 默认值为取消选中。
-
允许关注
如果选中，则允许成员关注注释。 默认值为取消选中。
-
显示徽章
如果选中，则允许显示已获得和已授予的徽章。 默认值为取消选中。
“用户审核”选项卡 user-moderation-tab
在 用户审核 选项卡下，指定如何管理发布的评论。 有关详细信息，请参阅审核用户生成的内容。
-
预审
如果选中，评论必须先获得批准，然后才能显示在发布网站上。 默认值为取消选中。
-
删除评论
如果选中，则为发表评论的成员提供删除评论的功能。 默认值为取消选中。
-
拒绝评论
如果选中，则允许审查方拒绝评论。 默认值为取消选中。
-
关闭/重新打开评论
如果选中，则允许审查方关闭和重新打开评论。 默认值为取消选中。
-
标记评论
如果选中，则允许成员将评论标记为不适当。 默认值为取消选中。
-
标记原因列表
如果选中，则允许成员从下拉列表中选择将评论标记为不适当的原因。 默认值为取消选中。
-
自定义标记原因
如果选中，则允许成员输入将评论标记为不适当的原因。 默认值为取消选中。
-
审核阈值
输入在通知版主之前，评论必须被成员标记的次数。 默认值为一次(1)。
-
标记限制
输入在将评论从公开视图隐藏之前必须对其标记的次数。 此数字必须大于或等于 审核阈值。 默认值为5。
“排序设置”选项卡 sort-settings-tab
在 排序设置 选项卡下，指定在显示时如何对发布的评论进行排序。
-
排序字段
下拉以选择
Newest, Oldest, Last Updated, Most Viewed, Most Active, Most Followed或Most Liked之一。 -
排序顺序
下拉以选择
Ascending或Descending之一。
更改为自定义评论类型 changing-to-a-custom-comment-type
通过更改“注释资源类型”，注释系统不再使用缺省值生成注释的实例，而是由开发人员自定义（扩展）的实例。
在已知自定义资源类型后，输入设计模式并双击放置的Comments组件以打开带有额外选项卡的对话框。
在 资源类型 选项卡下，为Comments or Voting组件的新实例指定自定义resourceType：
-
评论资源类型
导航到/apps中的扩展
comment组件的resourceType（单个注释）。 例如，/apps/social/commons/components/hbs/comments/comment此资源标识访客发表评论时创建的UGC的resourceType。
-
投票资源类型
导航到/apps中扩展
voting组件的resourceType。 例如，/apps/social/components/hbs/voting此资源标识访客发表投票时创建的UGC的资源类型。
-
注释系统资源类型
导航到/apps中的扩展
comments组件（注释系统）的resourceType。 留空，除非页面模板在基础脚本中动态包含注释系统，而不是作为资源（注释节点）添加到页面。 通过阅读有关{{include}}帮助程序的信息了解详情。
网站访客体验 site-visitor-experience
审查方和管理员 moderators-and-administrators
当登录用户具有审阅人或管理员权限时，他们能够执行组件配置允许的审阅任务，而不管评论的作者是谁。
成员 members
当网站访客登录时，根据配置，他们可能
- Post新评论
- 编辑他们自己的评论
- 删除他们自己的评论
- 标记其他人的评论
匿名 anonymous
未登录的网站访客只能读取已发布的评论，如果支持的话，可以翻译这些评论，但不得添加评论或标记其他人的评论。
附加信息 additional-information
可在面向开发人员的Comments Essentials页面上找到更多信息。
有关审核已发布的评论，请参阅审核用户生成的内容。
有关已发布评论的翻译，请参阅翻译用户生成的内容。