Punteggio community e badge communities-scoring-and-badges

Panoramica overview

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

I principali aspetti del punteggio e dei distintivi sono:

Si noti che l'assegnazione dei distintivi è non abilitata per impostazione predefinita.

Badge badges

I badge sono posti 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 nei seguenti punti:

Se vengono memorizzati in una posizione diversa, dovrebbero essere letti e accessibili a tutti.

I distintivi sono differenziati in UGC a seconda che siano stati assegnati o siano stati ottenuti in base alle regole. Al momento, i badge assegnati vengono visualizzati come testo e quelli guadagnati come immagine.

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

La console Badge per community consente di aggiungere distintivi personalizzati che possono essere visualizzati per un membro quando guadagnato (assegnato) o quando assume un ruolo specifico nella community (assegnato).

Badge assegnati assigned-badges

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

I badge assegnati (e assegnati) sono archiviati nel SRP selezionato e non sono direttamente accessibili. Finché non sarà disponibile un’interfaccia utente grafica, l’unico modo per assegnare i badge basati sui ruoli consiste nell’utilizzare codice o cURL. Per le istruzioni cURL, vedere la sezione Assegnare e revocare i badge.

Nella versione sono inclusi tre badge basati sui ruoli:

Distintivi assegnati awarded-badges

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

Affinché i distintivi vengano visualizzati come ricompensa per l’attività, è necessario che si verifichino due cose:

Nella versione sono inclusi tre badge basati su premi:

Badge personalizzati custom-badges

I badge personalizzati possono essere installati utilizzando la Console badge e assegnati o specificati nelle regole di badge.

Se 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 di base per impostare e abilitare il punteggio e l’assegnazione dei distintivi sono i seguenti:

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

Applicare regole al contenuto apply-rules-to-content

Per abilitare il punteggio e i badge, aggiungere le proprietà scoringRules e badgingRules a qualsiasi nodo nella struttura del contenuto del sito.

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

Le regole applicabili a un componente abilitato per i badge sono quelle per il nodo corrente o il suo predecessore.

Se il nodo è di tipo cq:Page (consigliato) e quindi si utilizza CRXDE|Lite, aggiungere le proprietà al nodo jcr:content.

Abilita badge per componente enable-badges-for-component

Le regole di assegnazione e punteggio sono attive solo per le istanze dei componenti per i quali è stato abilitato il contrassegno modificando la configurazione del componente in modalità di creazione.

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

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

Regole punteggio scoring-rules

Le regole di punteggio sono alla base del punteggio per l’assegnazione dei badge.

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

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

In presenza di più regole di punteggio, i punteggi vengono mantenuti separatamente per ciascuna regola.

Le regole di punteggio sono nodi di tipo cq:Page con proprietà nel nodo jcr:content che specificano l'elenco di regole secondarie che lo definiscono.

I punteggi vengono memorizzati in SRP.

Sottoregole punteggio scoring-sub-rules

Le sottoregole di punteggio contengono le proprietà che descrivono nel dettaglio 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 che il proprietario del contenuto riceve i punti ( forOwner).

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

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

I substrati sono nodi di tipo cq:Page con proprietà nel nodo jcr:content che specificano i verbi e argomenti.

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

Nella versione sono incluse due regole di punteggio per la funzione forum (una per ogni componente Forum e Commenti della funzione forum):

Note:

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

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

Regole di assegnazione dei badge badging-rules

Le regole di assegnazione dei badge collegano le regole di assegnazione dei punteggi ai badge specificando:

Le regole di assegnazione dei punteggi sono nodi di tipo cq:Page con proprietà nel nodo jcr:content che correlano le regole di assegnazione dei punteggi a punteggi e badge.

Le regole per i badge sono costituite da una proprietà thresholds obbligatoria che è un elenco ordinato di punteggi mappati ai badge. I punteggi devono essere ordinati in modo crescente. Ad esempio:

Le regole di assegnazione dei punteggi sono associate alle regole di assegnazione dei punteggi, che determinano l’accumulo dei punti. Vedere la sezione con titolo Applica regole al contenuto.

La proprietà scoringRules di una regola di badge limita semplicemente le regole di punteggio che possono essere associate a quella particolare regola di badge.

Regole di assegnazione dei badge incluse included-badging-rules

Nella versione sono incluse due regole di assegnazione dei punteggi che corrispondono alle regole di assegnazione dei punteggi per forum e commenti.

Note:

Attivazione di regole di assegnazione dei badge personalizzate activating-custom-badging-rules

Eventuali modifiche o aggiunte apportate alle regole di badge o alle immagini 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 la console membri o a livello di programmazione utilizzando i comandi cURL.

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

cURL -i -X POST -H intestazione -u firma -F operazione -F distintivo membro-profilo-url

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

accesso = administrator-id:password
ad esempio, admin:admin

operation = ":operation=social:assignBadge" OPPURE ":operation=social:deleteBadge"

badge = "badgeContentPath=badge-image-file"

badge-image-file = percorso del file di immagine del badge nell'archivio
ad esempio, /libs/settings/community/badging/images/moderator/jcr:content/moderator.png

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

Esempi: examples

Assegna un badge moderatore assign-a-moderator-badge

curl -i -X POST -H "Accept:application/json" -u admin:admin -F ":operation=social:assignBadge" -F "badgeContentPath=/libs/settings/community/badging/images/moderator/jcr:content/moderator.png" /home/users/community/updcs9DndLEI74DB9zsB/profile.social.json

Revoca di un distintivo silver assegnato revoke-an-assigned-silver-badge

curl -i -X POST -H "Accept:application/json" -u admin:admin -F ":operation=social:deleteBadge" -F "badgeContentPath=/libs/settings/community/badging/images/silver/jcr:content/silver.png" /home/users/community/updcs9DndLEI74DB9zsB/profile.social.json

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

È possibile creare regole di punteggio e contrassegno per i componenti personalizzati associando gli argomenti dell’evento creati per il componente ai verbi.

Argomenti e verbi topics-and-verbs

Quando i membri interagiscono con le funzionalità delle community, vengono inviati eventi che possono attivare listener asincroni, come notifiche e punteggi.

L'istanza SocialEvent di un componente registra gli eventi come actions che si verificano per un topic. SocialEvent include un metodo per restituire un verb associato all'azione. Esiste una relazione n-1 tra actions e verbs.

Per i componenti community consegnati, le tabelle seguenti descrivono i verbs definiti per ogni topic disponibile nelle sottoregole di punteggio.

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 diario
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 valutazione
SocialEvent topic= com/adobe/cq/social/tally/rating

Componente Votazione
SocialEvent topic= com/adobe/cq/social/tally/voting

Componenti abilitati per 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 actions che si verificano per topic.

Per supportare il punteggio, SocialEvent deve eseguire l'override del metodo getVerb() in modo che venga restituito un verb appropriato per ogni action. Il verb restituito per un'azione può essere uno usato comunemente (ad esempio POST) o uno specializzato per il componente (ad esempio ADD RATING). Esiste una relazione n-1 tra actions e verbs.

Risoluzione dei problemi troubleshooting

I badge non vengono visualizzati badges-are-not-appearing

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

Vedere Abilitare i badge per il componente.

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

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

Vedere la proprietà scoringRules di Regole di assegnazione dei badge.

Tipo sensibile a maiuscole e minuscole case-sensitive-typo

La maggior parte delle proprietà e dei valori, in particolare i verbi, fanno distinzione tra maiuscole e minuscole. I verbi devono essere tutti maiuscoli se utilizzati in una sottoregola di punteggio.

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

Test rapido quick-test

È possibile provare rapidamente a assegnare punteggi e contrassegni utilizzando il sito Esercitazione introduttiva (coinvolgimento):

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

Successivamente, ripubblica il sito della community.

Infine,

Questo dovrebbe far sì che il membro della community riceva un distintivo in bronzo visibile con il suo post sul forum, poiché la prima soglia della regola di assegnazione del badge ai forum è un punteggio di 1.

Informazioni aggiuntive additional-information

Ulteriori informazioni sono disponibili nella pagina Nozioni fondamentali su punteggio e distintivi per gli sviluppatori.

Per informazioni sul motore di punteggio avanzato, vedere Punteggio avanzato e distintivi.

La classifica configurabile componente e funzione semplifica la visualizzazione dei membri e dei relativi punteggi in un sito community.