Punteggio e badge delle community communities-scoring-and-badges

Panoramica overview

La funzione di valutazione e badge di AEM Communities consente di identificare e premiare i membri della community.

I principali aspetti del punteggio e dei badge sono:

Nota l'assegnazione dei badge è non abilitato per impostazione predefinita.

Badge badges

I badge vengono inseriti sotto il nome di un membro per indicare il suo ruolo o la sua posizione nella comunità. I badge possono essere visualizzati come immagine o come nome. Quando viene visualizzato come immagine, il nome viene incluso come testo alternativo per l’accessibilità.

Per impostazione predefinita, i badge si trovano nell’archivio all’indirizzo

Se vengono memorizzati in una posizione diversa, tutti devono essere accessibili in lettura.

I distintivi sono differenziati in UGC per quanto riguarda il fatto che siano stati assegnati o sono stati guadagnati in base alle regole. Al momento, i badge assegnati vengono visualizzati come testo e i badge guadagnati vengono visualizzati come immagine.

Interfaccia utente per la gestione dei badge badge-management-ui

Le Comunità Console badge offre la possibilità di aggiungere badge personalizzati che possono essere visualizzati per un membro guadagnato (assegnato) o quando assume un ruolo specifico nella comunità (assegnato).

Badge assegnati assigned-badges

I badge basati sul ruolo vengono assegnati da un amministratore ai membri della community in base al loro ruolo nella community.

I badge assegnati (e awared) sono memorizzati nel SRP e non sono direttamente accessibili. Fino a quando non è disponibile un’interfaccia grafica, l’unico modo per assegnare i badge basati su ruoli consiste nel farlo con codice o cURL. Per istruzioni su cURL, consulta la sezione con titolo Assegnare e revocare i badge.

Nella versione sono inclusi tre badge basati sui ruoli:

Badge aggiudicati awarded-badges

I badge basati sui premi vengono assegnati dal servizio di punteggio ai membri della comunità in base alle regole applicate alla loro attività nella comunità.

Affinché i badge vengano visualizzati come ricompensa per l’attività, devono verificarsi due eventi:

Nella versione sono inclusi tre badge basati su premi:

Badge personalizzati custom-badges

I badge personalizzati possono essere installati utilizzando Console badge e viene assegnato o specificato nelle regole di badging.

Quando vengono installati dalla console Badge , i badge personalizzati vengono replicati automaticamente nell’ambiente di pubblicazione.

Abilita punteggio enable-scoring

Il punteggio non è abilitato per impostazione predefinita. I passaggi fondamentali per l’impostazione e l’abilitazione del punteggio e del rilascio dei badge sono i seguenti:

Consulta la sezione Test rapido per abilitare il punteggio per un sito community utilizzando le regole di valutazione e contrassegno predefinite per forum e commenti.

Applica regole al contenuto apply-rules-to-content

Per abilitare il punteggio e i badge, aggiungi le proprietà scoringRules e badgingRulesa qualsiasi nodo della struttura del contenuto del sito.

Se il sito è già pubblicato, dopo aver applicato tutte le regole e aver abilitato i componenti, ripubblica il sito.

Le regole che si applicano a un componente abilitato per i badging sono quelle per il nodo corrente o per il relativo predecessore.

Se il nodo è di tipo cq:Page (consigliato), quindi, utilizzando CRXDE|Lite, aggiungi le proprietà ai relativi jcr:contentnodo.

Abilita badge per componente enable-badges-for-component

Le regole di valutazione e di binding sono in vigore solo per le istanze di componenti che hanno abilitato il badging modificando la configurazione del componente in modalità di authoring.

Proprietà booleana, allowBadges, abilita/disabilita la visualizzazione dei badge per un’istanza di un componente. È configurabile nella finestra di dialogo modifica componente per i componenti forum, QnA e commento tramite una casella di controllo etichettata Badge di visualizzazione.

Esempio: allowBadges per l’istanza del componente Forum example-allowbadges-for-forum-component-instance

Regole di valutazione scoring-rules

Le regole di valutazione sono alla base del punteggio allo scopo di assegnare i badge.

Molto semplicemente, ogni regola di punteggio è un elenco di una o più regole secondarie. Le regole di valutazione vengono applicate al contenuto del sito della community per identificare le regole da applicare quando i badge sono abilitati.

Le regole di valutazione vengono ereditate ma non aggiunte. Ad esempio:

Se è presente più di una regola di punteggio, i punteggi vengono mantenuti separatamente per ogni regola.

Le regole di punteggio sono nodi di tipo cq:Page con proprietà jcr:contentnodo che specifica l’elenco di regole secondarie che lo definiscono.

I punteggi sono memorizzati in SRP.

Regole di valutazione secondarie scoring-sub-rules

Le regole del punteggio contengono le proprietà che descrivono i valori per la partecipazione alla community.

Ogni sottoregola di punteggio identifica

Per impostazione predefinita, i punti vengono assegnati al membro che esegue un'azione, a meno che la regola secondaria non specifichi il proprietario del contenuto come destinatario dei punti ( forOwner).

Ogni regola secondaria può essere inclusa in una o più regole di punteggio.

Il nome della regola secondaria in genere segue il pattern di utilizzo di un oggetto, oggetto e verbo. Ad esempio:

Le sub-regole sono nodi di tipo cq:Page con proprietà jcr:contentnodo che specifica verbi e argomenti .

Regole di valutazione e sottoregole incluse included-scoring-rules-and-sub-rules

Nella versione sono incluse due regole di punteggio per Funzione Forum (uno per ciascuno dei componenti Forum e Commenti della funzione Forum):

Note:

Attivazione di regole di valutazione personalizzate activating-custom-scoring-rules

Eventuali modifiche o aggiunte apportate alle regole di punteggio o alle sotto-regole apportate nell’ambiente di authoring devono essere installate al momento della pubblicazione.

Regole di contrassegno badging-rules

Le regole di contrassegno collegano le regole di punteggio ai badge specificando:

Le regole di accesso sono nodi di tipo cq:Page con proprietà jcr:contentnodo che collega le regole di punteggio a punteggi e badge.

Le regole per il contrassegno consistono in un thresholdsche è un elenco ordinato di punteggi mappati su badge. I punteggi devono essere ordinati in valore crescente. Ad esempio:

Le regole di badging sono associate alle regole di punteggio, che determinano l’accumulo di punti. Vedi la sezione con titolo Applica regole al contenuto.

La scoringRulesin una regola di badging è sufficiente limitare quali regole di punteggio possono essere associate a quella particolare regola di badging.

Regole di contrassegno incluse included-badging-rules

Nella versione sono incluse due regole di badging corrispondenti alla variabile Regole di valutazione per forum e commenti.

Note:

Attivazione di regole di badging personalizzate activating-custom-badging-rules

Eventuali modifiche o aggiunte apportate alle regole di badging o alle immagini effettuate nell’ambiente di authoring devono essere installate al momento della pubblicazione.

Assegnare e revocare i badge assign-and-revoke-badges

I badge possono essere assegnati ai membri utilizzando console membri o utilizzando i comandi cURL a livello di programmazione.

I seguenti comandi cURL mostrano cosa è necessario per una richiesta HTTP per l’assegnazione e la revoca dei badge. Il formato di base è:

cURL -i -X POST -H header -u *signin * -F *operation * -F *badge * membro-profile-url

header = "Accept:application/json"
intestazione personalizzata da passare al server (richiesta)

segno = administrator-id:password
ad esempio: admin:admin

funzionamento = ":operation=social:assignBadge" OR ":operation=social:deleteBadge"

badge = "badgeContentPath=badge-image-file"

badge-image-file = posizione del file immagine del badge nell'archivio
ad esempio: /etc/community/badging/images/moderator/jcr:content/moderator.png

membro-profile-url = endpoint per il profilo del membro al momento della pubblicazione
ad esempio: https://<server>:<port>/home/users/community/riley/profile.social.json

Esempi: examples

Assegnare un badge del moderatore 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

Revoca di un badge d'argento assegnato 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

Punteggio e badge per componenti personalizzati scoring-and-badges-for-custom-components

Le regole di valutazione e di contrassegno possono essere create per i componenti personalizzati associando gli argomenti evento creati per il componente ai verbi.

Argomenti e verbi topics-and-verbs

Quando i membri interagiscono con le funzioni di Communities, vengono inviati eventi che possono attivare listener asincroni, come notifiche e punteggio.

L'istanza SocialEvent di un componente registra gli eventi come actionsche si verificano per topic. SocialEvent include un metodo per restituire un verbassociato all’azione. C'è un n-1 rapporto tra actionse verbs.

Per i componenti comunità consegnati, le tabelle seguenti descrivono verbsdefiniti per ciascuna topicdisponibile per l'utilizzo in assegnazione del punteggio alle regole secondarie.

Componente calendario
SocialEvent topic= com/adobe/cq/social/calendar

Componente Commenti
SocialEvent topic= com/adobe/cq/social/comment

Componente libreria file
SocialEvent topic= com/adobe/cq/social/fileLibrary

Componente Forum
SocialEvent topic= com/adobe/cq/social/forum

Componente Journal
SocialEvent topic= com/adobe/cq/social/journal

Componente QnA
SocialEvent topic = com/adobe/cq/social/qna

Componente Recensioni
SocialEvent topic= com/adobe/cq/social/review

Componente di valutazione
SocialEvent topic= com/adobe/cq/social/tally/rating

Componente di voto
SocialEvent topic= com/adobe/cq/social/tally/vote

Componenti abilitati per la moderazione
SocialEvent topic= com/adobe/cq/social/moderation

Eventi dei componenti personalizzati custom-component-events

Per un componente personalizzato, viene creata un'istanza di SocialEvent per registrare gli eventi del componente come actionsche si verificano per topic.

Per supportare il punteggio, SocialEvent deve sovrascrivere il metodo getVerb() in modo che verbviene restituito per ogni action. La verb restituita per un’azione può essere comunemente utilizzata (ad esempio POST) o uno specializzato per il componente (ad esempio ADD RATING). C'è un n-1 rapporto tra actionse verbs.

Risoluzione dei problemi troubleshooting

I badge non compaiono badges-are-not-appearing

Se al contenuto del sito web sono state applicate regole di valutazione e contrassegno, ma non sono stati avvertiti badge per alcuna attività, assicurati che i badge siano stati abilitati per l’istanza del componente.

Vedi Abilita badge per componente.

La regola di punteggio non ha alcun effetto scoring-rule-has-no-effect

Se sono state applicate regole di punteggio e contrassegno al contenuto del sito web e i badge vengono assegnati per alcune azioni, ma non per altre, verifica che la regola di badging non abbia limitato le regole di punteggio a cui si applica.

Consulta la sezione scoringRulesproprietà di Regole di contrassegno.

Typo sensibile a maiuscole e minuscole case-sensitive-typo

La maggior parte delle proprietà e dei valori, in particolare i verbi, sono sensibili all'uso di maiuscole e minuscole. I verbi devono essere tutti UPPERCASE quando utilizzati in una regola secondaria di punteggio.

Se la funzione non funziona come previsto, verifica che i dati siano stati immessi correttamente.

Test rapido quick-test

È possibile provare rapidamente il punteggio e il contrassegno utilizzando il Esercitazione introduttiva (interattiva) sito:

Successivamente, assicurati che i componenti forum e commenti consentano la visualizzazione dei badge:

Successivamente, ripubblicare il sito della community.

Infine,

Questo dovrebbe guadagnare al membro della comunità un badge di bronzo visibile con il loro post sul forum a causa della prima soglia della regola di badging del forum che è un punteggio di 1.

Informazioni aggiuntive additional-information

Per ulteriori informazioni, consulta Nozioni di base sul punteggio e sui badge per sviluppatori.

Per informazioni sul motore di punteggio avanzato, consulta Punteggio e badge avanzati.

La classifica configurabile component e Funzione semplifica la visualizzazione dei membri e dei loro punteggi su un sito community.