O recurso de pontuação e selo do AEM Communities identifica e retribui 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, 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, isAssigned indica que o selo foi concedido para 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.
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
Selecionar Adicionar novo logger
Selecionar DEBUG
para Nível de log
Insira um nome para Arquivo de log, por exemplo
Digite 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 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), é necessário habilitar o CRXDE Lite.
A localização base 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 instalados estão disponíveis para os 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.
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 = [/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 emblemas, adicione a propriedade
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
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 emblemas, adicione a propriedade
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=/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 emblemas de bronze e recebeu um selo de moderador, o usuário aparece com a entrada do fórum da seguinte maneira:
Este exemplo não segue essas práticas recomendadas:
Os nomes de regras de pontuação devem ser globais exclusivas; eles não devem terminar com o mesmo nome.
Um exemplo do que not para fazer:
/libs/settings/community/scoring/rules/site1/forums-scoring
/libs/settings/community/scoring/rules/site2/forums-scoring
Criação de imagens de selo exclusivas para sites de AEM diferentes
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 de 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 só podem conter um valor ou indiretamente se referem a um atomicCounter.
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 emblemas, como:
/home/users/community/w271OOup2Z4DjnOQrviv/profile/badges
Para exibir uma lista classificada de membros com base em pontos: