O recurso de pontuação e medalhas do AEM Communities identifica e recompensa os membros da comunidade.
Os detalhes da configuração do recurso estão descritos em
Esta página contém detalhes técnicos adicionais:
A estrutura de implementação visível no CRXDE Lite está sujeita a alterações.
Se um selo é exibido como texto ou imagem é controlado no lado do cliente no modelo HBS.
Por exemplo, pesquisar por this.isAssigned
in /libs/social/forum/components/hbs/topic/list-item.hbs
:
{{#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}}
Se verdadeiro, isAssigned indica que o selo foi atribuído a uma função e o selo deve ser exibido como texto.
Se false, isAssigned indica que o selo foi concedido para uma pontuação recebida e o selo deve ser exibido como uma imagem.
Qualquer alteração nesse comportamento deve ser feita em um script personalizado (substituição ou sobreposição). Consulte Personalização do lado do cliente.
Para ajudar a depurar a pontuação e o símbolo, um arquivo de log personalizado pode ser configurado. O conteúdo desse arquivo de log poderá ser fornecido ao suporte ao cliente se forem encontrados problemas com o recurso.
Para obter instruções detalhadas, visite Criar um arquivo de log personalizado.
Para configurar rapidamente um arquivo de log do Sling:
Acesse o Suporte ao log do console da Web do Adobe Experience Manager, por exemplo
Selecionar Adicionar novo agente de log
Selecionar DEBUG
para Nível de registro
Digite um nome para Arquivo de log, por exemplo
Insira dois Logger entradas (classe) (usando +
ícone)
com.adobe.cq.social.scoring
com.adobe.cq.social.badging
Selecione Salvar
Para ver entradas de log:
No console da Web
scoring-debug
No disco local do servidor
O arquivo de log está em <server-install-dir>/crx-quickstart/logs/<log-file-name>.log
Por exemplo, .../crx-quickstart/logs/scoring-debug.log
É possível exibir o UGC relacionado à pontuação e ao badging quando o SRP escolhido for JSRP ou MSRP, mas não ASRP. (Se não estiver familiarizado com esses termos, consulte Armazenamento de conteúdo da comunidade e Visão geral do provedor de recursos de armazenamento.)
As descrições para acessar dados de pontuação e badging usam JSRP, pois o UGC é facilmente acessível usando CRXDE Lite.
JSRP no autor: experimentar no ambiente do autor resulta em uma UGC que só é visível do ambiente do autor.
JSRP em publicação: da mesma forma, se estiver testando no ambiente de publicação, será necessário acessar o CRXDE Lite com privilégios administrativos em uma instância de publicação. Se a instância de publicação estiver em execução no modo de produção (nosamplecontent runmode), é necessário ativar o CRXDE Lite.
A localização básica do UGC no JSRP é /content/usergenerated/asi/jcr/
.
As seguintes APIs estão disponíveis para uso:
Os Javadocs mais recentes para o pacote de recursos instalado estão disponíveis para desenvolvedores no repositório do Adobe. Consulte Uso do Maven para comunidades : Javadocs.
A localização e o formato do UGC no repositório estão sujeitos a alterações sem aviso.
As capturas de tela dos dados do repositório vêm da configuração de pontuação e badging para um fórum em dois sites AEM diferentes:
Um site de AEM com um identificador exclusivo (site da comunidade criado usando o assistente):
Uso do site Tutorial de introdução (engajamento) criado durante o tutorial de introdução
Localize o nó da página do fórum
/content/sites/engage/en/forum/jcr:content
Adicionar propriedades de pontuação e medalha
scoringRules = [/libs/settings/community/scoring/rules/comments-scoring,
/libs/settings/community/scoring/rules/forums-scoring]
badgingRules =[/libs/settings/community/badging/rules/comments-scoring,
/libs/settings/community/badging/rules/forums-scoring]
Localize o nó do componente do fórum
/content/sites/engage/en/forum/jcr:content/content/primary/forum
( sling:resourceType = social/forum/components/hbs/forum
)
Para exibir selos, adicione a propriedade
allowBadges = true
Um usuário se conecta, cria um tópico do fórum e recebe um selo bronze
Um site de AEM sem uma id exclusiva:
Localize o nó da página do fórum
/content/community-components/en/forum/jcr:content
Adicionar propriedades de pontuação e medalha
scoringRules = [/libs/settings/community/scoring/rules/comments-scoring,
/libs/settings/community/scoring/rules/forums-scoring]
badgingRules =[/libs/settings/community/badging/rules/comments-badging,
/libs/settings/community/badging/rules/forums-badging]
Localize o nó do componente do fórum
/content/community-components/en/forum/jcr:content/content/forum
( sling:resourceType = social/forum/components/hbs/forum
)
Para exibir selos, adicione a propriedade
allowBadges = true
Um usuário se conecta, cria um tópico do fórum e recebe um selo bronze
Um usuário recebe um selo de moderador usando cURL:
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" https://localhost:4503/home/users/community/w271OOup2Z4DjnOQrviv/profile.social.json
Como um usuário ganhou dois selos de bronze e recebeu um selo de moderador, o usuário aparece com sua entrada no fórum da seguinte maneira:
Este exemplo não segue estas práticas recomendadas:
Os nomes das regras de pontuação devem ser globalmente exclusivos; eles não devem terminar com o mesmo nome.
Um exemplo do que não fazer:
/libs/settings/community/scoring/rules/site1/forums-scoring
/libs/settings/community/scoring/rules/site2/forums-scoring
Criação de imagens exclusivas de crachás para diferentes sites de AEM
Utilização do APIs é preferível.
Para fins investigativos, usando JSRP para o exemplo, a pasta base que contém pontuações é
/content/usergenerated/asi/jcr/scoring
O nó filho de scoring
é o nome da regra de pontuação. Assim, uma prática recomendada é que os nomes de regras de pontuação em um servidor sejam globalmente exclusivos.
Para o site Geometrixx Engage, o usuário e sua pontuação estão em um caminho construído com o nome da regra de pontuação, a ID do site da comunidade ( engage-ba81p
), um identificador exclusivo e o identificador do usuário:
.../scoring/forums-scoring/engage-ba81p/6d179715c0e93cb2b20886aa0434ca9b5a540401/riley
Para o site de guia dos Componentes da comunidade, o usuário e sua pontuação estão em um caminho construído com o nome da regra de pontuação, uma ID padrão ( default-site
), um identificador exclusivo e o identificador do usuário:
.../scoring/forums-scoring/default-site/b27a17cb4910a9b69fe81fb1b492ba672d2c086e/riley
A pontuação é armazenada na propriedade scoreValue_tl
que só pode conter um valor ou se referir indiretamente a um atomicCounter.
Utilização do APIs é preferível.
Para fins de investigação, usando JSRP como exemplo, a pasta base que contém informações sobre selos atribuídos ou concedidos é
/content/usergenerated/asi/jcr
Seguido pelo caminho para o perfil do usuário, terminando em uma pasta de selos, como:
/home/users/community/w271OOup2Z4DjnOQrviv/profile/badges
Para exibir uma lista classificada de membros com base em pontos: