La fonction de notation et de badges AEM Communities permet d'identifier et de récompenser les membres de la communauté.
Les principaux aspects de la notation et des badges sont les suivants :
Attribuer des badges pour identifier le rôle d'un membre dans la communauté
Attribution de base de badgestes aux membres pour encourager leur participation (quantité de contenu créé)
Attribution avancée de badgess pour identifier les membres comme experts (qualité du contenu créé)
Notez que l’attribution de badges n’est pas activée par défaut.
La structure d’implémentation visible dans le CRXDE Lite peut être modifiée une fois que l’interface utilisateur est disponible.
Les insignes sont placés sous le nom d'un membre pour indiquer soit son rôle, soit son statut dans la communauté. Les badges peuvent être affichés sous forme d'image ou de nom. Lorsqu’il est affiché sous forme d’image, le nom est inclus en tant que texte de remplacement pour l’accessibilité.
Par défaut, les badges se trouvent dans le référentiel à l’adresse
S'ils sont stockés à un autre emplacement, ils doivent être lus accessibles à tous.
Les insignes sont différenciés en UGC selon qu'ils ont été attribués ou acquis selon les règles. Actuellement, les badges attribués apparaissent sous forme de texte et les badges gagnés apparaissent sous forme d’image.
La console Communautés Badges permet d'ajouter des badges personnalisés qui peuvent être affichés pour un membre lorsqu'il est gagné (attribué) ou lorsqu'il assume un rôle spécifique dans la communauté (attribué).
Un administrateur attribue aux membres de la communauté des badges fondés sur le rôle en fonction de leur rôle dans la communauté.
Les badges attribués (et attribués) sont stockés dans le SRP sélectionné et ne sont pas directement accessibles. Tant qu’une interface graphique n’est pas disponible, le seul moyen d’attribuer des badges basés sur les rôles consiste à le faire avec du code ou de l’URL. Pour obtenir des instructions sur les URL, voir la section intitulée Attribuer et révoquer des badges.
Cette version comprend trois badges basés sur les rôles :
Modérateur
/etc/community/badging/images/moderator/jcr:content/moderator.png
Gestionnaire de groupes
/etc/community/badging/images/group-manager/jcr:content/group-manager.png
Membre privilégié
/etc/community/badging/images/privileged-member/jcr:content/privileged-member.png
Le service de notation accorde aux membres de la communauté des badges récompensés en fonction des règles appliquées à leur activité dans la communauté.
Pour que les badges apparaissent comme une récompense pour l'activité, deux choses doivent se produire :
La version comprend trois badges basés sur la récompense :
Or
/etc/community/badging/images/gold-badge/jcr:content/gold.png
Argent
/etc/community/badging/images/silver-badge/jcr:content/silver.png
Bronze
/etc/community/badging/images/bronze-badge/jcr:content/bronze.png
Les règles de score peuvent être configurées pour affecter des points négatifs aux publications marquées comme inappropriées et affecter ainsi la valeur de score. Cependant, une fois qu’un badge est gagné, il ne sera pas automatiquement supprimé en raison de la réduction du point de notation ou des modifications de la règle de notation.
Les badges attribués peuvent être révoqués de la même manière que les badges attribués. Voir la section Attribuer et révoquer les badges. Les améliorations futures comprendront une interface utilisateur pour gérer les badges des membres.
Les badges personnalisés peuvent être installés à l'aide de la console Badges et être affectés ou spécifiés dans les règles de badge.
Une fois installés à partir de la console Badges, les badges personnalisés sont automatiquement répliqués dans l’environnement de publication.
Le score n’est pas activé par défaut. Les étapes de base pour la configuration et l'activation de la notation et de l'attribution des badges sont les suivantes :
Identifier les règles pour les points de rémunération (règles de notation)
Pour les points cumulés par règle de score, affectez badges (règles de badge)
Appliquer les règles de notation et de badge à un site communautaire
Activation du badge pour les fonctionnalités de la communauté
Consultez la section Test rapide pour activer la notation pour un site communautaire à l’aide des règles de notation et de badge par défaut pour les forums et les commentaires.
Pour activer la notation et les badges, ajoutez les propriétés scoringRules
et badgingRules
à tout noeud de l'arborescence de contenu du site.
Si le site est déjà publié, après avoir appliqué toutes les règles et activé les composants, republiez le site.
Les règles qui s’appliquent à un composant activé par badge sont celles du noeud actif ou de son ancêtre.
Si le noeud est de type cq:Page
(recommandé), ajoutez les propriétés à son jcr:content
noeud à l'aide de CRXDE|Lite.
Propriété | Type | Description |
---|---|---|
badgingRules | Chaîne[] | une liste de tableau de règles de badge |
scoringRules | Chaîne[] | une liste de tableau de règles de score |
Si une règle d’évaluation ne semble pas avoir d’effet sur l’attribution des badges, assurez-vous que la règle d’évaluation n’a pas été bloquée par la propriété scoringRules de la règle d’évaluation. Consultez la section intitulée Règles d’insigne.
Les règles d’évaluation et de classement ne sont en vigueur que pour les instances de composants qui ont activé la mise en badge en modifiant la configuration du composant en mode de création.
Une propriété booléenne, allowBadges
, active/désactive l'affichage des badges pour une instance de composant. Il est configurable dans la boîte de dialogue de modification des composants pour les composants de forum, de QnA et de commentaires par le biais d'une case à cocher intitulée Afficher les badges.
N’importe quel composant peut être superposé pour afficher les badges à l’aide du code HBS trouvé dans les forums, QnA et les commentaires comme exemple.
Les règles de score sont la base de la notation pour l’attribution de badges.
Très simplement, chaque règle de score est une liste d’une ou de plusieurs sous-règles. Des règles de score sont appliquées au contenu du site de la communauté afin d’identifier les règles à appliquer lorsque les badges sont activés.
Les règles de score sont héritées, mais pas additifs. Par exemple :
Si la page2 contient la règle de score2 et sa page1 ancêtre contient la règle de score1
Une action sur un composant page2 appelle à la fois règle1 et règle2.
Si les deux règles contiennent des sous-règles applicables pour le même topic/verb
:
Lorsqu’il existe plusieurs règles de score, les scores sont conservés séparément pour chaque règle.
Les règles de score sont des noeuds de type cq:Page
avec des propriétés sur son jcr:content
noeud qui spécifient la liste des sous-règles qui le définissent.
Les scores sont stockés dans SRP.
Bonne pratique : nommez de manière unique chaque règle de score.
Les noms des règles de score doivent être globalement uniques ; ils ne devraient pas se terminer par le même nom.
Exemple de ce que ne pas faire :
/etc/community/scoring/rules/site1/forums-score
/etc/community/scoring/rules/site2/forums-score
Les sous-règles de notation contiennent les propriétés qui détaillent les valeurs de participation à la communauté.
Chaque sous-règle de notation identifie
Par défaut, les points sont attribués au membre qui agit, sauf si la sous-règle spécifie le propriétaire du contenu comme recevant les points ( forOwner
).
Chaque sous-règle peut être incluse dans une ou plusieurs règles de notation.
Le nom de la sous-règle suit généralement le modèle d’utilisation d’un sujet, objet et verbe. Par exemple :
Les sous-règles sont des noeuds de type cq:Page
avec des propriétés sur son jcr:content
noeud qui spécifient les verbes et rubriques.
Propriété | Type | Valeur Description |
---|---|---|
VERB |
Long |
|
topics |
Chaîne[] |
|
forOwner |
Booléen |
|
scoringType |
Chaîne |
|
Cette version comprend deux règles de notation pour la fonction Forum (une pour les composants Forum et Commentaires de la fonction Forum) :
/etc/community/score/rules/commentaires-score
subRules[] =
/etc/community/scoring/rules/sub-rules/members-comment-create
/etc/community/scoring/rules/sub-rules/members-receive-vote
/etc/community/scoring/rules/sub-rules/members-don-vote
/etc/community/scoring/rules/sub-rules/members-is-modérated
/etc/community/scoring/rules/forums-score
subRules[] =
/etc/community/scoring/rules/sub-rules/membre-forum-create
/etc/community/scoring/rules/sub-rules/members-receive-vote
/etc/community/scoring/rules/sub-rules/members-don-vote
/etc/community/scoring/rules/sub-rules/members-is-modérated
Remarques:
Les noeuds rules
et sub-rules
sont de type cq:Page
subRules
est un attribut de type [] Stringon the rule's jcr:content
node
sub-rules
peut être partagée entre différentes règles de notation
rules
doit être situé dans un emplacement de référentiel avec une autorisation de lecture pour tout le monde
Toute modification ou tout ajout apporté aux règles de notation ou aux sous-règles apportées dans l’environnement d’auteur doit être installé lors de la publication.
Les règles de mise en badge lient les règles de notation aux badges en spécifiant :
Les règles de badge sont des noeuds de type cq:Page
avec des propriétés sur son jcr:content
noeud qui mettent en corrélation les règles de score avec les scores et les badges.
Les règles de badge consistent en une propriété thresholds
obligatoire qui est une liste ordonnée de scores mappés à des badges. Les scores doivent être triés en valeur croissante. Par exemple :
1|/etc/community/badging/images/bronze-badge/jcr:content/bronze.png
60|/etc/community/badging/images/silver-badge/jcr:content/silver.png
80|/etc/community/badging/images/gold-badge/jcr:content/gold.png
Les règles de badge sont associées à des règles de score, qui déterminent comment les points s’accumulent. Voir la section intitulée Appliquer des règles au contenu.
La propriété scoringRules
d'une règle de badge limite simplement les règles de score qui peuvent être associées à cette règle de badge particulière.
Meilleure pratique : créez des images de badge propres à chaque site AEM.
Propriété | Type | Valeur Description |
---|---|---|
seuils | Chaîne[] | (obligatoire) Chaîne à plusieurs valeurs du formulaire "numéro|chemin"
Exemple d'entrée : 80|/etc/community/badging/images/gold-badge/jcr:content/gold.png |
badgingType | Chaîne | (Facultatif) Identifie le moteur d’évaluation comme étant "de base" ou "avancé". Si vous souhaitez utiliser le moteur de score avancé, voir Advanced Scoring and Badges. La valeur par défaut est "basic". |
scoringRules |
Chaîne[] | (facultatif) Chaîne à plusieurs valeurs pour limiter la règle de badge aux événements de notation identifiés par les règles de notation |
Cette version comprend deux règles de mise en badge qui correspondent aux Forums et aux règles de score des commentaires.
Remarques:
rules
les noeuds sont de type cq:Page
rules
doit être situé dans un emplacement de référentiel avec une autorisation de lecture pour tout le monde
Toute modification ou tout ajout apporté aux règles de mise en badge ou aux images effectuées dans l’environnement d’auteur doit être installé lors de la publication.
Des badges peuvent être attribués à des membres à l'aide de la console members ou par programmation à l'aide des commandes cURL.
Les commandes cURL suivantes indiquent ce qui est nécessaire pour une demande HTTP d’attribution et de révocation de badges. Le format de base est le suivant :
cURL -i -X POST -H header -u *signature * -F *opération * -F *badge * membre-profil-url
header = "Accepter:application/json"
en-tête personnalisé à transmettre au serveur (obligatoire)
signature = administrator-id:password
par exemple : admin:admin
operation = ":operation=social:assignBadge" OU ":operation=social:deleteBadge"
badge = "badgeContentPath=badge-image-file"
badge-image-file = l’emplacement du fichier image de badge dans le référentiel.
par exemple : /etc/community/badging/images/modérator/jcr:content/moderator.png
Member-profil-url = point de terminaison du profil du membre lors de la publication
par exemple : https://<serveur>:<port>/home/users/community/riley/profile.social.json
Le membre-profil-url
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
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
L’utilisation de cURL pour attribuer et révoquer des badges fonctionne pour n’importe quelle image de badge, mais lorsqu’elle est affectée à la place de celle acquise, elle est marquée comme des badges attribués et gérée en conséquence.
Il est possible de créer des règles de score et de badge pour les composants personnalisés en associant les rubriques de événement créées pour le composant aux verbes.
Lorsque les membres interagissent avec les fonctionnalités des communautés, des événements sont envoyés qui peuvent déclencher des écouteurs asynchrones, tels que des notifications et des scores.
L’instance SocialEvent d’un composant enregistre les événements sous la forme actions
qui se produisent pour un topic
. SocialEvent inclut une méthode permettant de renvoyer une verb
valeur associée à l’action. Il existe une relation n-1 entre actions
et verbs
.
Pour les composants de communautés livrés, les tableaux suivants décrivent les verbs
définies pour chaque topic
disponible pour l'utilisation dans sous-règles de notation.
Une nouvelle propriété booléenne, allowBadges
, active/désactive l'affichage des badges pour une instance de composant. Il sera configurable dans les boîtes de dialogue de modification de composant mises à jour via une case à cocher intitulée Badges d'affichage.
Calendrier
ComponentSocialEvent topic
= com/adobe/cq/social/calendar
Verbe | Description |
---|---|
POST | crée un événement de calendrier |
AJOUTER | commentaires d'un membre sur un événement de calendrier |
UPDATE | le événement de calendrier ou le commentaire du membre est modifié |
DELETE | le événement de calendrier ou le commentaire du membre est supprimé |
Commentaires
ComponentSocialEvent topic
= com/adobe/cq/social/comment
Verbe | Description |
---|---|
POST | crée un commentaire |
AJOUTER | réponse du membre au commentaire |
METTRE À JOUR | le commentaire du membre est modifié |
DELETE | le commentaire du membre est supprimé |
File Library
ComponentSocialEvent topic
= com/adobe/cq/social/fileLibrary
Verbe | Description |
---|---|
POST | crée un dossier |
ATTAQUE | le membre télécharge un fichier |
METTRE À JOUR | met à jour un dossier ou un fichier |
DELETE | supprime un dossier ou un fichier |
Forum
ComponentSocialEvent topic
= com/adobe/cq/social/forum
Verbe | Description |
---|---|
POST | membre crée une rubrique de forum |
AJOUTER | réponses des membres au sujet du forum |
METTRE À JOUR | le sujet ou la réponse du forum du membre est modifié |
DELETE | le sujet ou la réponse du membre du forum est supprimé |
Journal
ComponentSocialEvent topic
= com/adobe/cq/social/journal
Verbe | Description |
---|---|
POST | crée un article de blog |
AJOUTER | commentaires d'un membre sur un article de blog |
METTRE À JOUR | article ou commentaire du blog du membre modifié |
DELETE | article ou commentaire du blog du membre supprimé |
QnA
ComponentSocialEvent topic
= com/adobe/cq/social/qna
Verbe | Description |
---|---|
POST | crée une question QnA |
AJOUTER | crée une réponse QnA |
METTRE À JOUR | Question ou réponse QnA du membre modifiée |
SELECT | la réponse du membre est sélectionnée |
DÉSÉLECTIONNER | la réponse du membre est désélectionnée |
DELETE | QnUne question ou réponse du membre est supprimée |
Critiques
ComponentSocialEvent topic
= com/adobe/cq/social/review
Verbe | Description |
---|---|
POST | membre crée une révision |
METTRE À JOUR | révision du membre est modifiée |
DELETE | la révision du membre est supprimée |
Evaluation
ComponentSocialEvent topic
= com/adobe/cq/social/tally/rating
Verbe | Description |
---|---|
AJOUTE | le contenu du membre a été amélioré |
SUPPRESSION DE LA COTE | le contenu du membre a été réduit |
Vote du
composantSocialEvent topic
= com/adobe/cq/social/tally/vote
Verbe | Description |
---|---|
AJOUTER VOTE | le contenu du député a été voté |
SUPPRIMER LE VOTE | le contenu du député a été rejeté, voté |
Composants prenant en charge la modérationSocialEvent topic
= com/adobe/cq/social/modération
Verbe | Description |
---|---|
DENY | le contenu du membre est refusé |
INDICATEUR INAPPROPRIÉ | le contenu du membre est marqué |
INAPPROPRIÉ | le contenu du membre n'est pas marqué |
ACCEPTER | le contenu du membre est approuvé par le modérateur |
CLOSE | le membre ferme les commentaires aux modifications et aux réponses |
OUVRIR | membre réouvre le commentaire |
Pour un composant personnalisé, un SocialEvent est appelé pour enregistrer les événements du composant sous la forme actions
qui se produisent pour un topic
.
Pour prendre en charge le score, SocialEvent doit remplacer la méthode getVerb()
afin qu’un verb
approprié soit renvoyé pour chaque action
. L'élément verb
renvoyé pour une action peut être couramment utilisé (tel que POST
) ou spécialisé pour le composant (tel que ADD RATING
). Il existe une relation n-1 entre actions
et verbs
.
Si des règles de notation et de badge ont été appliquées au contenu du site Web, mais que les badges ne sont attribués à aucune activité, assurez-vous que les badges ont été activés pour l’instance de ce composant.
Voir Activer les badges pour le composant.
Si des règles de notation et de badge ont été appliquées au contenu du site Web et que des badges sont attribués pour certaines actions, mais pas pour d’autres, vérifiez que la règle de badge n’a pas limité les règles de notation auxquelles elle s’applique.
Voir la propriété scoringRules
des Règles d'insigne.
La plupart des propriétés et valeurs, en particulier les verbes, sont sensibles à la casse. Les verbes doivent être en MAJUSCULES lorsqu’ils sont utilisés dans une sous-règle de score.
Si la fonction ne fonctionne pas comme prévu, assurez-vous que les données ont été saisies correctement.
Il est possible d’essayer rapidement de marquer et de marquer des points à l’aide du site Didacticiel de prise en main (engager) :
Accéder au CRXDE Lite sur l’auteur
Accédez à la page de base :
Ajoutez la propriété badgingRules :
badgingRules
String
/etc/community/badging/rules/forums-badging
+
/etc/community/badging/rules/comments-badging
Ajoutez la propriété scoringRules :
scoringRules
String
/etc/community/scoring/rules/forums-scoring
+
/etc/community/scoring/rules/comments-scoring
Sélectionner Enregistrer tout
Ensuite, assurez-vous que les composants du forum et des commentaires permettent l'affichage des badges :
Utilisation de nouveau du CRXDE Lite
Accédez au composant de forum
/content/sites/engage/en/forum/jcr:content/content/primary/forum
Ajoutez la propriété booléenne allowBadges, si nécessaire, et assurez-vous qu’elle est vraie.
allowBadges
Boolean
true
Ensuite, republier le site communautaire.
Enfin,
Accédez au composant sur l’instance de publication
Connectez-vous en tant que membre de la communauté (par exemple : weston.mccall@dodgit.com / mot de passe)
Publier un nouveau sujet de forum
La page doit être actualisée pour que le badge s’affiche.
Sélectionner le forum
Cela devrait permettre au membre de la communauté d'obtenir un badge en bronze visible avec son billet sur le forum car le premier seuil de la règle de badge de forums est un score de 1.
Pour plus d'informations, consultez la page Scoring and Badges Essentials destinée aux développeurs.
Pour plus d’informations sur le moteur de score avancé, voir Advanced Scoring and Badges.
Le tableau de bord configurable composant et fonction simplifie l'affichage des membres et leurs scores sur un site communautaire.