AEM Communities评分和徽章功能提供了识别和奖励社区成员的功能。
有关设置该功能的详细信息,请参阅
本页包含其他技术详细信息:
CRXDE Lite中可见的实施结构可能会发生更改。
在HBS模板的客户端上,将控制徽章显示为文本还是图像。
例如,在/libs/social/forum/components/hbs/topic/list-item.hbs
中搜索this.isAssigned
:
{{#each author.badges}}
{{#if this.isAssigned}}
<div class="scf-badge-text">
{{this.title}}
</div>
{{/if}}
{{/each}}
{{#each author.badges}}
{{#unless this.isAssigned}}
<img class="scf-badge-image" alt="{{this.title}}" title="{{this.title}}" src="{{this.imageUrl}}" />
{{/unless}}
{{/each}}
如果为true,则isAssigned表示已为角色分配标记,该标记应显示为文本。
如果为false,则为“已分配”表示已为应得分授予徽章,且徽章应显示为图像。
对此行为所做的任何更改都应在自定义脚本中进行(覆盖或叠加)。 请参阅客户端自定义。
为帮助调试评分和标记,可以设置自定义日志文件。 如果该功能遇到问题,可向客户支持提供此日志文件的内容。
有关详细说明,请访问创建自定义日志文件。
要快速设置slinglog文件,请执行以下操作:
例如,访问Adobe Experience Manager Web控制台日志支持
选择添加新日志记录器
为日志级别选择DEBUG
输入日志文件的名称,例如
输入两个Logger(类)条目(使用+
图标)
com.adobe.cq.social.scoring
com.adobe.cq.social.badging
选择Save
要查看日志条目:
从Web控制台
scoring-debug
在服务器的本地磁盘上
.../crx-quickstart/logs/scoring-debug.log
当所选SRP是JSRP或MSRP,但不是ASRP时,可以查看与评分和标记相关的UGC。 (如果不熟悉这些术语,请参阅社区内容存储和存储资源提供程序概述。)
访问评分和标记数据的描述使用JSRP,因为UGC可以使用CRXDE Lite轻松访问。
作者JSRP:在创作环境中进行实验时,会导致生成的UGC仅在创作环境中可见。
发布时的JSRP:同样,如果在发布环境中进行测试,则需要使用发布实例的管理权限访问CRXDE Lite。如果发布实例在生产模式(nosamplecontent运行模式)中运行,则需要启用CRXDE Lite。
JSRP上UGC的基本位置为/content/usergenerated/asi/jcr/
。
以下API可供使用:
已安装版本的最新Javaoc可供Adobe存储库中的开发人员使用。 请参阅使用Maven for Communities:Javaocs。
UGC在存储库中的位置和格式可能会发生更改,但不会发出警告。
存储库数据的屏幕截图来自在两个不同的AEM网站上为论坛设置评分和标记:
具有唯一ID的AEM网站(使用向导创建的社区网站):
使用在快速入门教程中创建的快速入门教程(参与)网站
找到论坛页面节点
/content/sites/engage/en/forum/jcr:content
添加评分和标记属性
scoringRules = [/etc/community/scoring/rules/comments-scoring,
/etc/community/scoring/rules/forums-scoring]
badgingRules =[/etc/community/badging/rules/comments-scoring,
/etc/community/badging/rules/forums-scoring]
找到论坛组件节点
/content/sites/engage/en/forum/jcr:content/content/primary/forum
(sling:resourceType = social/forum/components/hbs/forum
)
将资产添加到显示徽章
allowBadges = true
用户登录,创建论坛主题,并获得铜像徽章
没有唯一ID的AEM站点:
使用社区组件指南
找到论坛页面节点
/content/community-components/en/forum/jcr:content
添加评分和标记属性
scoringRules = [/etc/community/scoring/rules/comments-scoring,
/etc/community/scoring/rules/forums-scoring]
badgingRules =[/etc/community/badging/rules/comments-scoring,
/etc/community/badging/rules/forums-scoring]
找到论坛组件节点
/content/community-components/en/forum/jcr:content/content/forum
(sling:resourceType = social/forum/components/hbs/forum
)
将资产添加到显示徽章
allowBadges = true
用户登录,创建论坛主题,并获得铜像徽章
使用cURL为用户分配了审核者标记:
curl -i -X POST -H "Accept:application/json" -u admin:admin -F ":operation=social:assignBadge" -F "badgeContentPath=/etc/community/badging/images/moderator/jcr:content/moderator.png" http://localhost:4503/home/users/community/w271OOup2Z4DjnOQrviv/profile.social.json
由于用户已获得两枚铜牌,并获得了审核者徽章,因此用户在论坛条目中的显示方式如下:
此示例未遵循以下最佳实践:
评分规则名称应具有全局唯一性;它们不应以相同的名称结尾。
not要执行的操作的示例:
/etc/community/scoring/rules/site1/forums-scoring
/etc/community/scoring/rules/site2/forums-scoring
为不同的AEM站点创建唯一标记图像
首选使用API。
出于调查目的,以JSRP为例,包含得分的基本文件夹是
/content/usergenerated/asi/jcr/scoring
scoring
的子节点是评分规则名称。 因此,最佳做法是服务器上的评分规则名称在全局上是唯一的。
对于“Geometrixx参与”网站,用户及其得分所在的路径包含评分规则名称、社区网站的网站ID(engage-ba81p
)、唯一ID和用户ID:
.../scoring/forums-scoring/engage-ba81p/6d179715c0e93cb2b20886aa0434ca9b5a540401/riley
对于社区组件指南网站,用户及其得分所在的路径是使用评分规则名称、默认ID(default-site
)、唯一ID和用户ID构建的:
.../scoring/forums-scoring/default-site/b27a17cb4910a9b69fe81fb1b492ba672d2c086e/riley
分数存储在属性scoreValue_tl
中,该属性可能仅直接包含值或间接引用atomicCounter。
首选使用API。
为了调查目的,以JSRP为例,将包含已分配或已授予徽章信息的基础文件夹
后跟用户配置文件的路径,以徽章文件夹结尾,例如
要显示基于点的已排序成员列表,请执行以下操作: