Pontuação e emblemas de comunidades communities-scoring-and-badges
Visão geral overview
O recurso de pontuação e selo do AEM Communities oferece a capacidade de identificar e recompensar membros da comunidade.
Os principais aspectos da pontuação e dos emblemas são:
-
Atribuir emblemas para identificar o papel de um membro na comunidade
-
Atribuição básica de cartões aos membros para incentivar sua participação (quantidade de conteúdo criado)
-
Atribuição avançada de cartões para identificar membros como especialistas (qualidade do conteúdo criado)
Observação que a atribuição de cartões é não habilitado por padrão.
Selos badges
Os emblemas são colocados sob o nome de um membro para indicar sua função ou sua posição na comunidade. Os emblemas podem ser exibidos como uma imagem ou como um nome. Quando exibido como uma imagem, o nome é incluído como texto alternativo para acessibilidade.
Por padrão, os rótulos estão localizados no repositório em
- /etc/community/badging/images
Se armazenados em um local diferente, eles devem ser lidos e acessíveis a todos.
Os emblemas são diferenciados no UGC quanto ao fato de terem sido atribuídos ou terem sido obtidos de acordo com as regras. No momento, os emblemas atribuídos são exibidos como texto e os emblemas recebidos são exibidos como uma imagem.
Interface do usuário do gerenciamento de emblemas badge-management-ui
Comunidades Console de emblemas O fornece a capacidade de adicionar emblemas personalizados que podem ser exibidos para um membro quando ganhados (concedidos) ou quando assumem uma função específica na comunidade (atribuídos).
Símbolos atribuídos assigned-badges
Os emblemas baseados em funções são atribuídos por um administrador aos membros da comunidade com base em sua função na comunidade.
Os rótulos atribuídos (e avisados) são armazenados no SRP e não são diretamente acessíveis. Até que uma GUI esteja disponível, o único meio para atribuir emblemas baseados em função é fazer isso com código ou cURL. Para obter instruções de cURL, consulte a seção intitulada Atribuir e Revogar Símbolos.
Incluídos na versão, há três distintivos com base em funções:
-
Moderador
/etc/community/badging/images/moderator/jcr:content/moderator.png
-
Gerente de grupo
/etc/community/badging/images/group-manager/jcr:content/group-manager.png
-
Membro privilegiado
/etc/community/badging/images/privileged-member/jcr:content/privileged-member.png
Símbolos atribuídos awarded-badges
Os emblemas baseados em recompensa são concedidos pelo serviço de pontuação aos membros da comunidade com base nas regras aplicadas à sua atividade na comunidade.
Para que os emblemas apareçam como recompensa pela atividade, há duas coisas que devem acontecer:
Incluídos na versão, há três selos baseados em recompensa:
-
Ouro
/etc/community/badging/images/gold-badge/jcr:content/gold.png
-
Prata
/etc/community/badging/images/silver-badge/jcr:content/silver.png
-
Bronze
/etc/community/badging/images/bronze-badge/jcr:content/bronze.png
Símbolos personalizados custom-badges
Os emblemas personalizados podem ser instalados usando o Console de emblemas e atribuído ou especificado nas regras de marcação.
Quando instalados a partir do console Badges, os emblemas personalizados são replicados automaticamente para o ambiente de publicação.
Ativar Pontuação enable-scoring
A pontuação não está ativada por padrão. As etapas básicas para a configuração e a habilitação da pontuação e da atribuição de emblemas são:
-
Identificar regras para pontos de ganhos (regras de pontuação)
-
Para pontos acumulados por regra de pontuação, atribua emblemas (regras de marcação)
-
Aplicar as regras de pontuação e marcação a um site da comunidade
Consulte a Teste rápido para ativar a pontuação para um site da comunidade usando as regras de pontuação e marcação padrão para fóruns e comentários.
Aplicar regras ao conteúdo apply-rules-to-content
Para ativar a pontuação e os emblemas, adicione as propriedades scoringRules
e badgingRules
para qualquer nó na árvore de conteúdo do site.
Se o site já estiver publicado, depois de aplicar todas as regras e ativar os componentes, publique-o novamente.
As regras que se aplicam a um componente habilitado para marcação são as do nó atual ou seu ancestral.
Se o nó for do tipo cq:Page
(recomendado), em seguida, usando o CRXDE|Lite, adicione as propriedades à sua jcr:content
nó .
Ativar emblemas para componente enable-badges-for-component
As regras de pontuação e delimitação estão em vigor apenas para instâncias de componentes que habilitaram a marcação ao editar a configuração do componente em modo de criação.
Uma propriedade booleana, allowBadges
, ativa/desativa a exibição de emblemas para uma instância de componente. É configurável no caixa de diálogo edição de componente para componentes de fórum, QnA e comentário por meio de uma caixa de seleção rotulada Exibir emblemas.
Exemplo: allowBadges para a instância do componente Forum example-allowbadges-for-forum-component-instance
Regras de pontuação scoring-rules
As regras de pontuação são a base da pontuação para fins de concessão de emblemas.
Muito simplesmente, cada regra de pontuação é uma lista de uma ou mais subregras. As regras de pontuação são aplicadas ao conteúdo do site da comunidade para identificar as regras a serem aplicadas quando os rótulos estiverem ativados.
As regras de pontuação são herdadas, mas não aditivas. Por exemplo:
-
Se a página 2 contém a regra de pontuação 2 e sua página ancestral 1 contém a regra de pontuação 1
-
Uma ação em um componente de página 2 chamará a regra1 e a regra2
-
Se ambas as regras contiverem subregras aplicáveis para o mesmo
topic/verb
:- Somente a subregra da regra 2 afetará a pontuação
- As pontuações de ambas as subregras não são adicionadas juntas
Quando há mais de uma regra de pontuação, as pontuações são mantidas separadamente para cada regra.
As regras de pontuação são nós do tipo cq:Page
com propriedades em jcr:content
que especificam a lista de subregras que a definem.
As pontuações são armazenadas no SRP.
/etc/community/pontuação/rules/site1/forums-scoring
/etc/community/pontuação/rules/site2/forums-scoring
Subregras de pontuação scoring-sub-rules
As sub-regras de pontuação contêm as propriedades que detalham os valores para participar da comunidade.
Cada subregra de pontuação identifica
- Quais atividades estão sendo rastreadas
- Que função comunitária específica está envolvida
- Quantos pontos são atribuídos
Por padrão, os pontos são atribuídos ao membro que está tomando a ação, a menos que a subregra especifique o proprietário do conteúdo como recebendo os pontos ( forOwner
).
Cada subregra pode ser incluída em uma ou mais regras de pontuação.
O nome da subregra normalmente segue o padrão de uso de um assunto, objeto e verbo. Por exemplo:
- membro-comentário-criar
- membro-receberá-voto
Sub-regras são nós do tipo cq:Page
com propriedades em jcr:content
nó que especifica a verbos e tópicos .
Regras e subregras de pontuação incluídas included-scoring-rules-and-sub-rules
Incluídas na versão são duas regras de pontuação para a variável Função do fórum (um para os componentes Fórum e Comentários do recurso Fórum ):
-
/etc/community/scoring/rules/comments-scoring
-
subRules[] =
/etc/community/scoring/rules/sub-rules/member-comment-create
/etc/community/scoring/rules/sub-rules/member-receive-vote
/etc/community/scoring/rules/sub-rules/member-don
/etc/community/scoring/rules/sub-rules/member-is-moderated
-
-
/etc/community/pontuação/rules/forums-scoring
-
subRules[] =
/etc/community/scoring/rules/sub-rules/member-forum-create
/etc/community/scoring/rules/sub-rules/member-receive-vote
/etc/community/scoring/rules/sub-rules/member-don
/etc/community/scoring/rules/sub-rules/member-is-moderated
-
Notas:
-
Ambos
rules
esub-rules
nós são do tipo cq:Page -
subRules
é um atributo do tipo String[] no relatóriojcr:content
nó -
sub-rules
pode ser compartilhado entre várias regras de pontuação -
rules
deve estar localizado em um local de repositório com permissão de leitura para todos- Os nomes das regras devem ser exclusivos, independentemente da localização
Ativar regras de pontuação personalizadas activating-custom-scoring-rules
Quaisquer alterações ou adições feitas às regras de pontuação ou subregras feitas no ambiente de criação precisam ser instaladas na publicação.
Regras de marcação badging-rules
Regras de atribuição de rótulo vinculam regras de pontuação a rótulos especificando:
- Qual regra de pontuação
- A pontuação necessária para receber um símbolo específico
Regras de marcação são nós do tipo cq:Page
com propriedades em jcr:content
nó que correlaciona as regras de pontuação a pontuações e distinções.
As regras para a marcação consistem em um thresholds
que é uma lista ordenada de pontuações mapeadas para emblemas. As pontuações devem ser ordenadas em maior valor. Por exemplo:
-
1|/etc/community/badging/images/bronze-badge/jcr:content/bronze.png
- Selo de bronze é visto para ganhar 1 ponto
-
60|/etc/community/badging/images/silver-badge/jcr:content/silver.png
- Um emblema de prata é concedido quando há 60 pontos acumulados
-
80|/etc/community/badging/images/gold-badge/jcr:content/gold.png
- Um selo de ouro é avisado quando 80 pontos são acumulados
As regras de marcação são emparelhadas com regras de pontuação, que determinam como os pontos são acumulados. Consulte a seção intitulada Aplicar regras ao conteúdo.
O scoringRules
em uma regra de marcação, o simplesmente restringe quais regras de pontuação podem ser emparelhadas com essa regra de marcação específica.
Regras de marcação incluídas included-badging-rules
Incluídas na versão estão duas Regras de emblema que correspondem à variável Fóruns e regras de pontuação de comentários.
- /etc/community/badging/rules/comments-badging
- /etc/community/badging/rules/forums-badging
Notas:
-
rules
nós são do tipo cq:Page -
rules
deve estar localizado em um local de repositório com permissão de leitura para todos- Os nomes das regras devem ser exclusivos, independentemente da localização
Ativando regras de marcação personalizadas activating-custom-badging-rules
Quaisquer alterações ou adições feitas às regras de marcação ou imagens feitas no ambiente de criação precisam ser instaladas na publicação.
Atribuir e Revogar Símbolos assign-and-revoke-badges
Os emblemas podem ser atribuídos aos membros utilizando a console membros ou programaticamente usando comandos cURL.
Os seguintes comandos cURL mostram o que é necessário para uma solicitação HTTP para atribuir e revogar emblemas. O formato básico é:
cURL -i -X POST -H header -u *sinal * -F *operação * -F *selo * member-profile-url
header = "Accept:application/json"
cabeçalho personalizado a ser enviado para o servidor (obrigatório)
assinatura = administrador-id:senha
por exemplo: admin:admin
operation = ":operation=social:assignBadge" OU ":operation=social:deleteBadge"
emblema = "badgeContentPath=badge-image-file"
badge-image-file = o local do arquivo de imagem do selo no repositório
por exemplo: /etc/community/badging/images/moderator/jcr:content/moderator.png
member-profile-url = o ponto de extremidade do perfil do membro na publicação
por exemplo: https://<server>:<port>/home/users/community/riley/profile.social.json
- Pode se referir a uma instância do autor se a variável Serviço de túnel está ativado
- Pode ser um nome aleatório obscuro - consulte Lista de verificação de segurança sobre a ID de autorização
Exemplos: examples
Atribuir um símbolo de moderador assign-a-moderator-badge
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" /home/users/community/updcs9DndLEI74DB9zsB/profile.social.json
Revogar um símbolo de prata atribuído revoke-an-assigned-silver-badge
curl -i -X POST -H "Accept:application/json" -u admin:admin -F ":operation=social:deleteBadge" -F "badgeContentPath=/etc/community/badging/images/silver/jcr:content/silver.png" /home/users/community/updcs9DndLEI74DB9zsB/profile.social.json
Pontuação e emblemas para componentes personalizados scoring-and-badges-for-custom-components
As regras de pontuação e marcação podem ser criadas para componentes personalizados ao associar os tópicos de evento criados para o componente aos verbos.
Tópicos e verbos topics-and-verbs
Quando os membros interagem com os recursos das comunidades, os eventos são enviados e podem acionar ouvintes assíncronos, como notificações e pontuação.
A instância SocialEvent de um componente registra os eventos como actions
que ocorrem para um topic
. O SocialEvent inclui um método para retornar um verb
associada à ação. Existe um n-1 relação entre actions
e verbs
.
Para os componentes de comunidades entregues, as tabelas a seguir descrevem o verbs
definido para cada topic
disponível para uso em subregras de pontuação.
allowBadges
, ativa/desativa a exibição de emblemas para uma instância de componente. Ele poderá ser configurado na atualização caixas de diálogo de edição de componente por meio de uma caixa de seleção rotulada Exibir emblemas.Componente de calendário
SocialEvent topic
= com/adobe/cq/social/calendar
Componente Comentários
SocialEvent topic
= com/adobe/cq/social/comment
Componente Biblioteca de arquivos
SocialEvent topic
= com/adobe/cq/social/fileLibrary
Componente de fórum
SocialEvent topic
= com/adobe/cq/social/forum
Componente Diário
SocialEvent topic
= com/adobe/cq/social/journal
Componente QnA
SocialEvent topic
= com/adobe/cq/social/qna
Componente de revisões
SocialEvent topic
= com/adobe/cq/social/review
Componente de classificação
SocialEvent topic
= com/adobe/cq/social/tally/rating
Componente de votação
SocialEvent topic
= com/adobe/cq/social/tally/votar
Componentes habilitados para moderação
SocialEvent topic
= com/adobe/cq/social/moderação
Eventos de componente personalizado custom-component-events
Para um componente personalizado, um SocialEvent é instanciado para registrar os eventos do componente como actions
que ocorrem para um topic
.
Para oferecer suporte à pontuação, o SocialEvent precisaria substituir o método getVerb()
de forma a que verb
é retornado para cada action
. O verb
retornado para uma ação pode ser usado normalmente (como POST
) ou uma especializada para o componente (como ADD RATING
). Existe um n-1 relação entre actions
e verbs
.
Resolução de problemas troubleshooting
Os emblemas não estão aparecendo badges-are-not-appearing
Se as regras de pontuação e selo tiverem sido aplicadas ao conteúdo do site, mas os emblemas não estiverem sendo avisados para nenhuma atividade, verifique se os emblemas foram ativados para a instância desse componente.
Consulte Ativar emblemas para componente.
A regra de pontuação não tem efeito scoring-rule-has-no-effect
Se as regras de pontuação e selo tiverem sido aplicadas ao conteúdo do site, e os emblemas tiverem sido atribuídos para algumas ações, mas não para outras, verifique se a regra de selo não restringiu as regras de pontuação às quais se aplica.
Consulte a scoringRules
propriedade de Regras de marcação.
Tipo sensível a maiúsculas e minúsculas case-sensitive-typo
A maioria das propriedades e valores, especialmente os verbos, diferencia maiúsculas de minúsculas. Os verbos devem ser todos MAIÚSCULAS quando usados em uma subregra de pontuação.
Se o recurso não estiver funcionando como esperado, verifique se os dados foram inseridos corretamente.
Teste rápido quick-test
É possível experimentar rapidamente a pontuação e o selo usando o Tutorial de introdução Sítio de participação:
-
Acessar o CRXDE Lite no autor
-
Navegue até a página base:
- /content/sites/engagement/en/jcr:content
-
Adicione a propriedade badgingRules:
- Nome:
badgingRules
- Tipo:
String
- Selecionar Multi
- Selecionar Adicionar
- Insira
/etc/community/badging/rules/forums-badging
- Selecionar
+
- Insira
/etc/community/badging/rules/comments-badging
- Selecionar OK
- Nome:
-
Adicione a propriedade scoringRules:
- Nome:
scoringRules
- Tipo:
String
- Selecionar Multi
- Selecionar Adicionar
- Insira
/etc/community/scoring/rules/forums-scoring
- Selecionar
+
- Insira
/etc/community/scoring/rules/comments-scoring
- Selecionar OK
- Nome:
-
Selecionar Salvar tudo
Em seguida, verifique se os componentes de fórum e comentários permitem a exibição de emblemas:
-
Novamente usando o CRXDE Lite
-
Navegue até o componente de fórum
/content/sites/engage/en/forum/jcr:content/content/primary/forum
-
Adicione a propriedade booleana allowBadges, se necessário, e verifique se ela é verdadeira
- Nome:
allowBadges
- Tipo:
Boolean
- Valor:
true
- Nome:
Em seguida, republicar o site da comunidade.
Finalmente,
-
Navegue até o componente na instância de publicação
-
Fazer logon como membro da comunidade (por exemplo: weston.mccall@dodgit.com / password)
-
Publicar um novo tópico do fórum
-
A página deve ser atualizada para que o símbolo seja exibido
- Faça logoff e login como um membro da comunidade diferente (por exemplo: aaron.mcdonald@mailinator.com / password)
-
Selecionar o fórum
Isso deve gerar para o membro da comunidade um selo de bronze visível em sua publicação no fórum, devido ao primeiro limite da regra de selo de fóruns ser uma pontuação de 1.
Informações adicionais additional-information
Mais informações podem ser encontradas no Fundamentos de pontuação e emblemas página para desenvolvedores.
Para obter informações sobre o mecanismo de pontuação avançado, consulte Pontuação avançada e emblemas.
O Quadro de líderes configurável componente e função simplifica a exibição de membros e suas pontuações em um site da comunidade.