Fundamentos de pontuação e emblemas scoring-and-badges-essentials
O recurso de pontuação e selo do AEM Communities oferece a capacidade de identificar e recompensar membros da comunidade.
Os detalhes da configuração do recurso estão descritos em
Esta página contém detalhes técnicos adicionais:
- Como exibir um símbolo como imagem ou texto
- Como ativar o extenso log de depuração
- Como acessar UGC relacionadas à pontuação e à marcação
Exibição de emblemas displaying-badges
Se um selo é exibido como texto ou imagem é controlado no lado do cliente no modelo HBS.
Por exemplo, pesquise por this.isAssigned em /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 símbolo foi atribuído para uma função e o símbolo deve ser exibido como texto.
Se falso, is Assigned indica que o selo foi atribuído por uma pontuação ganha e o selo deve ser exibido como uma imagem.
Quaisquer alterações nesse comportamento devem ser feitas em um script personalizado (substituição ou sobreposição). Consulte Personalização do lado do cliente.
Log de depuração para pontuação e marcação debug-log-for-scoring-and-badging
Para ajudar a depurar a pontuação e o selo, um arquivo de log personalizado pode ser configurado. O conteúdo desse arquivo de log pode 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 de sling:
-
Acesse o Suporte de log do console da Web da Adobe Experience Manager, por exemplo
- http://localhost:4502/system/console/slinglog
-
Selecionar Adicionar novo logger
-
Selecionar
DEBUGpara Nível de log -
Insira um nome para Arquivo de log, por exemplo
- logs/scoring-debug.log
-
Digite dois Logger entradas (classe) (usando
+ícone )com.adobe.cq.social.scoringcom.adobe.cq.social.badging
-
Selecione Salvar
-
Para ver entradas de log:
-
No Console da Web
- Em Status menu
- Selecionar Arquivos de registro
- Pesquise o nome do arquivo de log, como
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
UGC para pontuação e marcação ugc-for-scoring-and-badging
É possível visualizar o UGC relacionado à pontuação e à marcação quando o SRP escolhido é 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 marcação usam o JSRP, pois o UGC é facilmente acessível usando CRXDE Lite.
JSRP no autor: a experimentação no ambiente de criação resulta em UGC que é visível somente no ambiente de criação.
JSRP na 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 em modo de produção (nosamplecontent runmode), será necessário habilitar o CRXDE Lite.
A localização base do UGC no JSRP é /content/usergenerated/asi/jcr/.
APIs de pontuação e marcação scoring-and-badging-apis
As seguintes APIs estão disponíveis para uso:
Os Javadocs mais recentes para o versões estão disponíveis para desenvolvedores do repositório do Adobe. Consulte Usando o Maven para comunidades: Javadocs.
A localização e o formato do UGC no repositório estão sujeitos a alterações sem aviso prévio.
Exemplo de configuração example-setup
As capturas de tela dos dados do repositório vêm da configuração da pontuação e do selo para um fórum em dois sites de AEM diferentes:
-
Um site AEM com uma id exclusiva (site da comunidade criado usando o assistente):
-
Usar o site Tutorial de introdução (engajamento) criado durante a 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 marcação
-
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]
-
-
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)
-
-
Adicionar propriedade para exibir emblemas
allowBadges = true
-
Um usuário entra, cria um tópico de fórum e recebe um selo de bronze
-
-
Um site AEM without 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 marcação
code language-none scoringRules = [/etc/community/scoring/rules/comments-scoring, /etc/community/scoring/rules/forums-scoring]code language-none badgingRules =[/etc/community/badging/rules/comments-scoring, /etc/community/badging/rules/forums-scoring] -
Localize o nó do componente do fórum
-
/content/community-components/en/forum/jcr:content/content/forum(
sling:resourceType = social/forum/components/hbs/forum)
-
-
Adicionar propriedade para exibir emblemas
allowBadges = true
-
Um usuário entra, cria um tópico de fórum e recebe um selo de 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=/etc/community/badging/images/moderator/jcr:content/moderator.png" http://localhost:4503/home/users/community/w271OOup2Z4DjnOQrviv/profile.social.json
Como um usuário ganhou dois emblemas de bronze e recebeu um selo de moderador, é assim que o usuário aparece com a entrada do fórum:
-
a pontuação de nomes de regras deve ser global exclusiva; eles não devem terminar com o mesmo nome.
Um exemplo do que not para fazer:
/etc/community/pontuação/rules/site1/forums-scoring
/etc/community/pontuação/rules/site2/forums-scoring -
criação de imagens de selo exclusivas para sites de AEM diferentes
Acesse o UGC de pontuação access-scoring-ugc
Utilização do APIs é preferível.
Para fins de investigação, usando o JSRP, por exemplo, a pasta base contendo 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 a pontuação dos nomes de regras em um servidor seja globalmente exclusiva.
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), uma id exclusiva e a id do usuário:
.../scoring/forums-scoring/engage-ba81p/6d179715c0e93cb2b20886aa0434ca9b5a540401/riley
Para o site do guia 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), uma id exclusiva e a id do usuário:
.../scoring/forums-scoring/default-site/b27a17cb4910a9b69fe81fb1b492ba672d2c086e/riley
A pontuação é armazenada na propriedade scoreValue_tl que podem conter somente um valor ou indiretamente se referir a um atomicCounter.
UGC de marca de acesso access-badging-ugc
Utilização do APIs é preferível.
Para fins de investigação, usando o JSRP, por exemplo, a pasta base contendo informações sobre os emblemas atribuídos ou concedidos é
- /content/usergenerated/asi/jcr
Seguido pelo caminho para o perfil do usuário, terminando em uma pasta de crachás, como
- /home/users/community/w271Oup2Z4DjnOQrviv/profile/badges
Selo concedido awarded-badge
selo atribuído assigned-badge
Informações adicionais additional-information
Para exibir uma lista classificada de membros com base em pontos:
- Função de quadro de líderes para inclusão em um site da comunidade ou modelo de grupo.
- Componente de quadro de líderes, o componente em destaque da função do Quadro de líderes, para criação de página.