Pontuação e emblemas de comunidades

Visão geral

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

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

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

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

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:

• O selo deve ser ativado para o componente de recurso
• As regras de pontuação e marcação devem ser aplicado à página (ou ancestral) em que o componente é colocado

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

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

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

• Ativar a marcação para recursos 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

Para ativar a pontuação e os emblemas, adicione as propriedades scoringRules e badgingRulespara 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:contentnó .

Ativar emblemas para componente

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

Regras de pontuação

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:contentque especificam a lista de subregras que a definem.

As pontuações são armazenadas no SRP.

Subregras de pontuação

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:contentnó que especifica a verbos e tópicos .

Regras e subregras de pontuação incluídas

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 ):

1. /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

2. /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 rulese sub-rules nós são do tipo cq:Page

• subRulesé um atributo do tipo String[] no relatório jcr:content nó

• sub-rules pode ser compartilhado entre várias regras de pontuação

• rulesdeve 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

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

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:contentnó que correlaciona as regras de pontuação a pontuações e distinções.

As regras para a marcação consistem em um thresholdsque é 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 scoringRulesem 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

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

• rulesdeve 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

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

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

Exemplos:

Atribuir um símbolo de moderador

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

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

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

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 actionsque ocorrem para um topic. O SocialEvent inclui um método para retornar um verbassociada à ação. Existe um n-1 relação entre actionse verbs.

Para os componentes de comunidades entregues, as tabelas a seguir descrevem o verbsdefinido para cada topicdisponível para uso em subregras de pontuação.

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

Para um componente personalizado, um SocialEvent é instanciado para registrar os eventos do componente como actionsque 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 actionse verbs.

Resolução de problemas

Os emblemas não estão aparecendo

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

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 scoringRulespropriedade de Regras de marcação.

Tipo sensível a maiúsculas e minúsculas

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

É 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

• 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

• 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

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

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.

Recursos do Business.Adobe.com

Cms Cloud Content Intelligence Personalized Communications Mobile Forms Theme Editor Dynamic Forms