社区评分和徽章 communities-scoring-and-badges

概述 overview

AEM Communities评分和徽章功能使您能够识别和奖励社区成员。

评分和徽章的主要方面包括：

请注意，默认情况下未启用徽章授予🔗。

徽章 badges

徽章放置在成员的名称下，以指示其在社区中的角色或地位。 徽章可以显示为图像或名称。 显示为图像时，该名称将作为辅助功能的替换文本包含在内。

默认情况下，徽章位于以下存储库中：

如果存储在其他位置，则每个人都可以读取这些文件。

在UGC中区分徽章，无论它们是按照规则分配还是按照规则获得的。 目前，分配的徽章显示为文本，已获得的徽章显示为图像。

徽章管理UI badge-management-ui

社区徽章控制台允许您添加自定义徽章，当成员获得（授予）或在社区中承担特定角色（已分配）时，可以显示这些徽章。

已分配的徽章 assigned-badges

基于角色的徽章由管理员根据社区成员在社区中的角色分配给社区成员。

已分配（和已授予）的徽章存储在选定的SRP中，无法直接访问。 在GUI可用之前，分配基于角色的徽章的唯一方法是使用代码或cURL。 有关cURL说明，请参阅标题为分配和撤销徽章的部分。

此版本中包含三个基于角色的徽章：

已授予的徽章 awarded-badges

评分服务会根据适用于社区成员在社区中活动的规则，向社区成员授予基于奖励的徽章。

要让徽章显示为对活动的奖励，必须发生以下两种情况：

此版本中包含三个基于奖励的徽章：

自定义徽章 custom-badges

可以使用徽章控制台安装自定义徽章，并在徽章规则中指定或分配。

从“徽章”控制台安装后，自定义徽章会自动复制到发布环境。

启用评分 enable-scoring

默认情况下不启用评分。 设置和启用徽章评分和授予的基本步骤如下：

请参阅快速测试部分，以使用论坛和评论的默认评分和徽章规则为社区站点启用评分。

将规则应用于内容 apply-rules-to-content

要启用评分和徽章，请将属性scoringRules和badgingRules添加到网站内容树中的任意节点。

如果站点已发布，请在应用所有规则和启用组件后，重新发布站点。

应用于启用了徽章的组件的规则适用于当前节点或其祖先的规则。

如果节点的类型为cq:Page（推荐），则使用CRXDE|Lite将属性添加到其jcr:content节点。

为组件启用徽章 enable-badges-for-component

评分和徽章规则仅对通过在创作模式中编辑组件配置而启用徽章的组件实例有效。

布尔属性allowBadges启用/禁用组件实例的徽章显示。 可以通过标记为​ 显示徽章 ​的复选框在论坛、QnA和评论组件的组件“编辑”对话框中对其进行配置。

示例：用于论坛组件实例的allowBadges example-allowbadges-for-forum-component-instance

评分规则 scoring-rules

评分规则是颁发徽章进行评分的基础。

每个评分规则是一个包含一个或多个子规则的列表。 评分规则将应用于社区站点内容，以确定在启用徽章时要应用的规则。

评分规则是继承的，但不是累加的。 例如：

当存在多个评分规则时，将分别为每个规则维护得分。

评分规则是cq:Page类型的节点，其jcr:content节点上具有属性，这些属性指定定义该规则的子规则列表。

分数存储在SRP中。

评分子规则 scoring-sub-rules

评分子规则包含详细说明参与社区的值的属性。

每个评分子规则确定：

默认情况下，积分被授予采取操作的成员，除非子规则将内容的所有者指定为接收积分(forOwner)。

每个子规则可以包含在一个或多个评分规则中。

子规则的名称通常遵循使用​ 主题、对象 ​和​ 谓词 ​的模式。 例如：

子规则是cq:Page类型的节点，其jcr:content节点上具有指定谓词和主题的属性。

包含评分规则和子规则 included-scoring-rules-and-sub-rules

此版本中包含了论坛功能的两个评分规则（论坛功能的论坛和评论组件各一个）：

注释：

激活自定义评分规则 activating-custom-scoring-rules

在创作环境中对评分规则或子规则所做的任何更改或添加必须安装在发布上。

徽章规则 badging-rules

徽章规则通过指定以下内容将评分规则链接到徽章：

徽章规则是cq:Page类型的节点，其jcr:content节点上具有将评分规则与分数和徽章关联的属性。

徽章规则由必需的thresholds属性组成，该属性是映射到徽章的分数排序列表。 必须按递增值对得分进行排序。 例如：

徽章规则与评分规则配对，后者决定积分的积累方式。 请参阅标题为将规则应用于内容的部分。

徽章规则的scoringRules属性仅限制哪些评分规则可以与该特定徽章规则配对。

包含的徽章规则 included-badging-rules

发行版中包含两个徽章规则，它们对应于论坛和评论评分规则。

注释：

激活自定义徽章规则 activating-custom-badging-rules

在创作环境中对标记规则或图像所做的任何更改或添加都必须安装在发布上。

分配和撤销徽章 assign-and-revoke-badges

可以使用成员控制台或以编程方式使用cURL命令为成员分配徽章。

以下cURL命令显示了分配和撤消徽章的HTTP请求所必需的。 基本格式为：

cURL -i -XPOST-H 标头 -u 登录 -F 操作 -F 徽章 member-profile-url

标头 = "Accept：application/json"
要传递到服务器的自定义标头（必需）

登录 = administrator-id：password
例如，admin：admin

operation = "：operation=social：assignBadge" OR "：operation=social：deleteBadge"

徽章 = "badgeContentPath=badge-image-file"

badge-image-file =徽章图像文件在存储库中的位置
例如，/libs/settings/community/badging/images/moderator/jcr：content/moderator.png

member-profile-url =发布时成员配置文件的端点
例如，https://<服务器>：<端口>/home/users/community/riley/profile.social.json

示例： examples

分配审查方徽章 assign-a-moderator-badge

curl -i -X POST -H "Accept:application/json" -u admin:admin -F ":operation=social:assignBadge" -F "badgeContentPath=/libs/settings/community/badging/images/moderator/jcr:content/moderator.png" /home/users/community/updcs9DndLEI74DB9zsB/profile.social.json

撤销分配的银质徽章 revoke-an-assigned-silver-badge

curl -i -X POST -H "Accept:application/json" -u admin:admin -F ":operation=social:deleteBadge" -F "badgeContentPath=/libs/settings/community/badging/images/silver/jcr:content/silver.png" /home/users/community/updcs9DndLEI74DB9zsB/profile.social.json

自定义组件的评分和徽章 scoring-and-badges-for-custom-components

通过将为组件创建的事件主题与动词相关联，可以为自定义组件创建评分和徽章规则。

主题和动词 topics-and-verbs

当成员与社区功能交互时，会发送可触发异步侦听器的事件，例如通知和评分。

组件的SocialEvent实例将事件记录为topic发生的actions。 SocialEvent包含用于返回与操作关联的verb的方法。 actions和verbs之间存在​ n-1 ​关系。

对于交付的社区组件，下表描述了为评分子规则中可用的每个topic定义的verbs。

日历组件
社交活动topic= com/adobe/cq/social/calendar

注释组件
SocialEvent topic= com/adobe/cq/social/comment

文件库组件
SocialEvent topic= com/adobe/cq/social/fileLibrary

论坛组件
SocialEvent topic= com/adobe/cq/social/forum

日志组件
SocialEvent topic= com/adobe/cq/social/journal

QnA组件
SocialEvent topic = com/adobe/cq/social/qna

审阅组件
SocialEvent topic= com/adobe/cq/social/review

评级组件
SocialEvent topic= com/adobe/cq/social/tally/rating

投票组件
SocialEvent topic= com/adobe/cq/social/tally/voting

启用审核的组件
SocialEvent topic= com/adobe/cq/social/moderation

自定义组件事件 custom-component-events

对于自定义组件，SocialEvent被实例化，以将组件的事件记录为topic发生的actions。

为了支持评分，SocialEvent需要覆盖方法getVerb()，以便为每个action返回相应的verb。 为操作返回的verb可以是常用的（如POST）或组件专用的（如ADD RATING）。 actions和verbs之间存在​ n-1 ​关系。

疑难解答 troubleshooting

未显示徽章 badges-are-not-appearing

如果评分和徽章规则已应用于网站的内容，但未授予任何活动的徽章，请确保已为该组件的实例启用徽章。

请参阅为组件启用徽章。

评分规则无效 scoring-rule-has-no-effect

如果评分和徽章规则已应用于网站的内容，并且授予了一些操作的徽章，但其他操作没有这样做，请检查徽章规则是否未限制其适用的评分规则。

查看徽章规则的scoringRules属性。

区分大小写的拼写错误 case-sensitive-typo

大多数属性和值（尤其是动词）区分大小写。 在评分子规则中使用动词时，必须全部大写。

如果功能无法按预期工作，请确保已正确输入数据。

快速测试 quick-test

可以使用入门教程 （参与）网站快速尝试评分和徽章：

接下来，确保论坛和评论组件允许显示徽章：

接下来，重新发布社区站点。

最后，

由于第一个论坛徽章规则的第一个阈值为1分，因此这应该会为社区成员获取随论坛帖子可见的铜级徽章。

附加信息 additional-information

可在面向开发人员的评分和徽章要点页面上找到更多信息。

有关高级评分引擎的信息，请参阅高级评分和徽章。

可配置的排行榜组件和功能简化了成员及其分数在社区网站上的显示。