AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.
La fonction Scores et badges d’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 :
Attribution de badges identifier le rôle d’un membre dans la communauté ;
Dons de base de badges aux membres pour encourager leur participation (quantité de contenu créé)
Attribution avancée de badges identifier les membres comme experts (qualité du contenu créé)
Remarque que l'attribution des badges est non activé par défaut.
La structure d’implémentation visible dans CRXDE Lite peut être modifiée une fois l’interface utilisateur disponible.
Les badges sont placés sous le nom d’un membre pour indiquer son rôle ou sa position 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 et accessibles à tous.
Les badges sont différenciés par rapport au contenu généré par l’utilisateur 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.
Les communautés Console Badges permet d’ajouter des badges personnalisés qui peuvent être affichés pour un membre lorsqu’il est gagné (attribué) ou lorsqu’il occupe un rôle spécifique dans la communauté (affecté).
Les badges en fonction du rôle sont attribués par un administrateur aux membres de la communauté en fonction de leur rôle dans la communauté.
Les badges attribués (et attribués) sont stockés dans le SRP et ne sont pas directement accessibles. Tant qu’une interface utilisateur graphique n’est pas disponible, le seul moyen d’affecter des badges basés sur un rôle consiste à utiliser du code ou cURL. Pour obtenir des instructions sur cURL, reportez-vous à la section intitulée Attribution et révocation 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 groupe
/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
Les badges récompensés sont attribués par le service de notation aux membres de la communauté selon les 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 :
Trois badges basés sur les récompenses sont inclus dans la version :
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 notation peuvent être configurées pour affecter des points négatifs aux publications marquées comme inappropriées et affecter ainsi la valeur du score. Cependant, une fois qu’un badge est gagné, il n’est pas automatiquement supprimé en raison de la réduction du point de notation ou des modifications des règles de notation.
Les badges primés peuvent être révoqués de la même manière que les badges attribués. Voir Attribution et révocation des badges . À l’avenir, une interface utilisateur sera ajoutée pour gérer les badges des membres.
Les badges personnalisés peuvent être installés à l’aide de la fonction Console Badges et 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 vers l’environnement de publication.
La notation n’est pas activée par défaut. Les étapes de base pour configurer et activer la notation et l’attribution de badges sont les suivantes :
Identifier les règles pour les points d’entrée (règles de notation)
Pour les points cumulés par règle de notation, affectez badges (règles de badge)
Application des règles de notation et de badge à un site communautaire
Activation des badges pour les fonctionnalités de la communauté
Voir Test rapide pour activer la notation d’un site de la communauté à 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
vers n’importe quel 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é) puis, à l’aide de CRXDE|Lite, ajoutez les propriétés à son jcr:content
noeud .
Propriété | Type | Description |
---|---|---|
badgingRules | Chaîne[] | une liste de tableaux de règles de badge |
scoringRules | Chaîne[] | une liste de tableaux de règles de notation |
Si une règle de notation ne semble avoir aucun effet sur l’attribution des badges, assurez-vous que la règle de notation n’a pas été bloquée par la propriété scoringRules de la règle de badge. Voir la section intitulée Règles de badge.
Les règles de notation et de mise en page ne sont appliquées que pour les instances de composants qui ont activé la mise en badge en modifiant la configuration du composant dans mode création.
Une propriété booléenne, allowBadges
, active/désactive l’affichage des badges pour une instance de composant. Il peut être configuré dans la variable boîte de dialogue de modification du composant pour les composants forum, Q&R et commentaire via une case à cocher intitulée Badges d’affichage.
N’importe quel composant peut être superposé pour afficher les badges à l’aide du code HBS trouvé dans les forums, la qualité de service et les commentaires comme exemple.
Les règles de notation sont la base de la notation dans le but d’attribuer des badges.
Très simplement, chaque règle de notation est une liste d’une ou de plusieurs sous-règles. Les règles de notation 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 notation sont héritées, mais pas additifs. Par exemple :
Si la page 2 contient la règle de notation 2 et que sa page 1 ancêtre contient la règle de notation 1
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 la même topic/verb
:
S’il existe plusieurs règles de notation, les scores sont conservés séparément pour chaque règle.
Les règles de notation sont des noeuds de type cq:Page
avec les propriétés à sa disposition jcr:content
qui spécifient la liste des sous-règles qui la définissent.
Les scores sont stockés dans SRP.
Bonne pratique : nommez de manière unique chaque règle de notation.
Les noms des règles de notation doivent être uniques au niveau global. ils ne doivent pas se terminer par le même nom.
Exemple de ce qui suit : not pour effectuer :
/etc/community/scoring/rules/site1/forums-scoring
/etc/community/scoring/rules/site2/forums-scoring
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 au propriétaire du contenu qu’il reçoit 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’une objet, objet et verbe. Par exemple :
Les sous-règles sont des noeuds de type cq:Page
avec les propriétés à sa disposition jcr:content
qui spécifient le noeud verbes et rubriques .
Propriété | Type | Description de la valeur |
---|---|---|
VERB |
Long |
|
topics |
Chaîne[] |
|
forOwner |
Booléen |
|
scoringType |
Chaîne |
|
Cette version comprend deux règles de notation pour la variable Fonction Forum (un pour les composants Forum et Commentaires de la fonction Forum) :
/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-vote
/etc/community/scoring/rules/sub-rules/member-is-modéated
/etc/community/scoring/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-vote
/etc/community/scoring/rules/sub-rules/member-is-modéated
Remarques:
Les rules
et sub-rules
les noeuds sont de type cq:Page
subRules
est un attribut de type Chaîne[] sur la règle jcr:content
node
sub-rules
peut être partagée entre différentes règles de notation.
rules
doit se trouver dans un emplacement de référentiel avec une autorisation de lecture pour tout le monde
Toutes les modifications ou ajouts apportés aux règles de notation ou aux sous-règles effectuées dans l’environnement de création doivent être installés lors de la publication.
Les règles de 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 les propriétés à sa disposition jcr:content
noeud qui met en relation les règles de notation avec les scores et les badges.
Les règles de badge se composent d’un thresholds
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 notation qui déterminent la manière dont les points s’accumulent. Voir la section intitulée Application de règles au contenu.
Le scoringRules
sur une règle de badge limite simplement les règles de notation qui peuvent être associées à cette règle de badge spécifique.
Bonne pratique : créer des images de badge uniques à chaque site AEM.
Propriété | Type | Description de la valeur |
---|---|---|
seuils | Chaîne[] | (obligatoire) Chaîne à plusieurs valeurs de la forme 'number|path'
Exemple d’entrée : 80|/etc/community/badging/images/gold-badge/jcr:content/gold.png |
badgingType | Chaîne | (facultatif) Identifie le moteur de notation comme "de base" ou "avancé". Si vous souhaitez utiliser le moteur de notation avancé, reportez-vous à la section Notation et badges avancés. La valeur par défaut est "basic". |
scoringRules |
Chaîne[] | (facultatif) Chaîne à plusieurs valeurs permettant de 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 badge qui correspondent à la variable Forums et règles de notation des commentaires.
Remarques:
rules
les noeuds sont de type cq:Page
rules
doit se trouver 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 badge ou aux images effectuées dans l’environnement de création doit être installé lors de la publication.
Des badges peuvent être attribués aux membres à l’aide de la fonction console membres ou par programmation à l’aide des commandes cURL.
Les commandes cURL suivantes indiquent les éléments nécessaires à une requête HTTP d’attribution et de révocation des badges. Le format de base est le suivant :
cURL -i -X POST -H header -u *signature * -F *operation * -F *badge * member-profile-url
header = "Accept: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 = emplacement du fichier image de badge dans le référentiel
par exemple : /etc/community/badging/images/modérator/jcr:content/moderator.png
member-profile-url = point de terminaison du profil du membre lors de la publication
par exemple : https://<server>:<port>/home/users/community/riley/profile.social.json
Le member-profile-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 au lieu d’être acquise, elles sont marquées comme des badges attribués et gérées en conséquence.
Il est possible de créer des règles de notation et de badge pour les composants personnalisés en associant les rubriques d’é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 en tant que actions
qui se produit pour un topic
. SocialEvent comprend une méthode pour renvoyer une verb
associée à l’action. Il existe une n-1 relation entre actions
et verbs
.
Pour les composants des communautés distribués, les tableaux suivants décrivent la variable verbs
définie pour chaque topic
disponible 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 mises à jour modification de composant, boîtes de dialogue par le biais d’une case à cocher étiquetée Badges d’affichage.
Composant Calendrier
SocialEvent topic
= com/adobe/cq/social/calendar
Verbe | Description |
---|---|
POST | Un membre crée un événement de calendrier |
AJOUTER | commentaires d’un membre sur un événement de calendrier |
MISE À JOUR | l’événement ou le commentaire de calendrier du membre est modifié. |
SUPPRIMER | l’événement ou le commentaire de calendrier du membre est supprimé. |
Composant Commentaires
SocialEvent topic
= com/adobe/cq/social/comment
Verbe | Description |
---|---|
POST | Un membre crée un commentaire |
AJOUTER | réponses du membre au commentaire |
MISE À JOUR | le commentaire du membre est modifié. |
SUPPRIMER | le commentaire du membre est supprimé. |
Composant Bibliothèque de fichiers
SocialEvent topic
= com/adobe/cq/social/fileLibrary
Verbe | Description |
---|---|
POST | crée un dossier |
ATTACH | Le membre charge un fichier |
MISE À JOUR | met à jour un dossier ou un fichier |
SUPPRIMER | supprime un dossier ou un fichier |
Composant du forum
SocialEvent topic
= com/adobe/cq/social/forum
Verbe | Description |
---|---|
POST | thème de forum de création de membre |
AJOUTER | réponses des membres au sujet du forum |
MISE À JOUR | Le sujet ou la réponse du forum du membre est modifié |
SUPPRIMER | La rubrique ou la réponse du forum du membre est supprimée |
Composant Journal
SocialEvent topic
= com/adobe/cq/social/journal
Verbe | Description |
---|---|
POST | Un membre crée un article de blog. |
AJOUTER | commentaires d'un membre sur un article de blog |
MISE À JOUR | article ou commentaire de blog du membre modifié |
SUPPRIMER | article ou commentaire de blog du membre supprimé |
Composant Q&R
SocialEvent topic
= com/adobe/cq/social/qna
Verbe | Description |
---|---|
POST | crée une question Q&R |
AJOUTER | crée une réponse Q&R |
MISE À JOUR | Q&R du membre : une question ou une réponse est modifiée |
SELECT | la réponse du membre est sélectionnée. |
UNSELECT | la réponse du membre est désélectionnée. |
SUPPRIMER | Q&R du membre : une question ou une réponse est supprimée |
Composant Révisions
SocialEvent topic
= com/adobe/cq/social/review
Verbe | Description |
---|---|
POST | création de la révision par le membre |
MISE À JOUR | la révision du membre est modifiée. |
SUPPRIMER | la révision du membre est supprimée. |
Composant d’évaluation
SocialEvent topic
= com/adobe/cq/social/tally/rating
Verbe | Description |
---|---|
AJOUTER UNE NOTE | le contenu du membre a été mis au point |
SUPPRESSION DE LA NOTE | le contenu du membre a été abaissé. |
Composant Vote
SocialEvent topic
= com/adobe/cq/social/tally/vote
Verbe | Description |
---|---|
AJOUTER UN VOTE | le contenu du membre a été voté |
SUPPRIMER LE VOTE | le contenu du membre a été rejeté |
Composants activés pour la modération
SocialEvent 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é |
ACCEPT | le contenu du membre est approuvé par le modérateur ; |
CLOSE | le membre ferme le commentaire aux modifications et aux réponses |
OUVRIR | commentaire de réouverture du membre |
Pour un composant personnalisé, un événement SocialEvent est appelé pour enregistrer les événements du composant comme actions
qui se produit pour un topic
.
Pour prendre en charge la notation, SocialEvent doit remplacer la méthode . getVerb()
afin qu’une verb
est renvoyé pour chaque action
. Le verb
renvoyé pour une action peut être une méthode couramment utilisée (telle que POST
) ou spécialisé pour le composant (par exemple ADD RATING
). Il existe une n-1 relation 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 n’ont été attribués pour aucune activité, assurez-vous que les badges ont été activés pour l’instance de ce composant.
Voir Activation des 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 restreint les règles de notation auxquelles elle s’applique.
Voir scoringRules
de Règles de badge.
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 notation.
Si la fonction ne fonctionne pas comme prévu, vérifiez que les données ont été correctement saisies.
Il est possible d’essayer rapidement la notation et la notation à l’aide de la variable Tutoriel de prise en main site (engage) :
Accès au CRXDE Lite sur l’instance de création
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électionnez Enregistrer tout
Vérifiez ensuite que les composants de forum et de commentaires permettent l’affichage des badges :
Utilisation de CRXDE Lite
Accédez au composant 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 définie sur true.
allowBadges
Boolean
true
Ensuite, republier le site de la communauté.
Enfin,
Accédez au composant sur l’instance de publication.
Se connecter en tant que membre de la communauté (par exemple : weston.mccall@dodgit.com/password)
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 sa publication sur le forum car le premier seuil de la règle de badge des forums est de 1.
Vous trouverez plus d’informations sur la Notions fondamentales sur la notation et les badges pour les développeurs.
Pour plus d’informations sur le moteur de notation avancé, voir Notation et badges avancés.
Tableau de classement configurable component et function simplifie l’affichage des membres et de leurs scores sur un site communautaire.