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:
Assegnare un badge per identificare il ruolo di un membro nella community
Assegnazione di base dei badgesto ai membri per incoraggiarne la partecipazione (quantità di contenuto creato)
Assegnazione avanzata di badgto per identificare i membri come esperti (qualità dei contenuti creati)
L’assegnazione dei badge non è abilitata per impostazione predefinita.
La struttura di implementazione visibile in CRXDE Lite è soggetta a modifiche una volta che l’interfaccia utente diventa disponibile.
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.
La console Communities Badges consente di aggiungere badge personalizzati che possono essere visualizzati per un membro al momento della maturazione (assegnazione) o quando assume un ruolo specifico nella community (assegnazione).
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 nell’ SRP selezionato 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 intitolata Assegnare e revocare i badge.
Nella versione sono inclusi tre badge basati sui ruoli:
Moderatore
/etc/community/badging/images/moderator/jcr:content/moderator.png
Gestione dei gruppi
/etc/community/badging/images/group-manager/jcr:content/group-manager.png
Membro privilegiato
/etc/community/badging/images/privileged-member/jcr:content/privileged-member.png
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:
Oro
/etc/community/badging/images/gold-badge/jcr:content/gold.png
Argento
/etc/community/badging/images/silver-badge/jcr:content/silver.png
Bronzo
/etc/community/badging/images/bronze-badge/jcr:content/bronze.png
Le regole di valutazione possono essere configurate per assegnare punti negativi per i post contrassegnati come inappropriati e quindi influenzare il valore del punteggio. Tuttavia, una volta guadagnato un badge, questo non verrà rimosso automaticamente a causa di modifiche della regola di riduzione del punto di punteggio o della regola di punteggio.
I badge assegnati possono essere revocati nello stesso modo dei badge assegnati. Consulta la sezione Assegna e revoca badge . I miglioramenti futuri includeranno un’interfaccia utente per gestire i badge dei membri.
I badge personalizzati possono essere installati utilizzando la console Badge e possono essere assegnati o specificati nelle regole di badging.
Quando vengono installati dalla console Badge , i badge personalizzati vengono replicati automaticamente nell’ambiente di pubblicazione.
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:
Identificare le regole per i punti di guadagno (regole di punteggio)
Per i punti accumulati per regole di punteggio, assegna badge (regole di badging)
Applicare le regole di valutazione e contrassegno a un sito community
Consulta la sezione Test rapido per abilitare il punteggio per un sito community utilizzando le regole di punteggio e contrassegno predefinite per forum e commenti.
Per abilitare il punteggio e i badge, aggiungi le proprietà scoringRules
e badgingRules
a 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à al relativo nodo jcr:content
.
Proprietà | Tipo | Descrizione |
---|---|---|
badgingRules | Stringa[] | un elenco array di regole di badging |
scoringRules | Stringa[] | un elenco array di regole di punteggio |
Se una regola di punteggio sembra non avere alcun effetto sull’assegnazione dei badge, assicurati che la regola di punteggio non sia stata bloccata dalla proprietà scoringRules della regola di badging. Vedere la sezione intitolata Regole di badging.
Le regole di valutazione e di binding sono valide solo per le istanze di componenti che hanno abilitato il contrassegno modificando la configurazione del componente in modalità di authoring.
Una proprietà booleana allowBadges
abilita/disabilita la visualizzazione dei badge per un’istanza di componente. È configurabile nella finestra di dialogo modifica componente per i componenti forum, QnA e commento tramite una casella di controllo denominata Badge di visualizzazione.
Qualsiasi componente può essere sovrapposto per visualizzare i badge utilizzando il codice HBS presente in forum, QnA e commenti come esempio.
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. Esempio:
Se la pagina2 contiene la regola di punteggio2 e la relativa pagina1 contiene la regola di punteggio1
Un'azione su un componente page2 richiama sia la regola1 che la regola2
Se entrambe le regole contengono sub-regole applicabili per lo stesso topic/verb
:
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à sul relativo nodo jcr:content
che specificano l’elenco di regole secondarie che lo definiscono.
I punteggi sono memorizzati in SRP.
Best practice: assegna un nome univoco a ciascuna regola di punteggio.
I nomi delle regole di punteggio devono essere univoci a livello globale; non devono terminare con lo stesso nome.
Un esempio di cosa non fare:
/etc/community/scoring/rules/site1/forums-scoring
/etc/community/scoring/rules/site2/forums-scoring
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, oggetto e verb. Esempio:
Le sub-regole sono nodi di tipo cq:Page
con proprietà sul relativo nodo jcr:content
che specificano i verbi e gli argomenti .
Proprietà | Tipo | Valore Descrizione |
---|---|---|
VERB |
Lungo |
|
topics |
Stringa[] |
|
forOwner |
Booleano |
|
scoringType |
Stringa |
|
Nella versione sono incluse due regole di valutazione per la Funzione forum (una per ciascuna delle componenti Forum e Commenti della funzione Forum):
/etc/community/scoring/rules/comments-scoring
subRules[] =
/etc/community/scoring/rules/sub-rules/membro-comment-create
/etc/community/scoring/rules/sub-rules/Member-receive-vote
/etc/community/scoring/rules/sub-rules/Member-dare-vote
/etc/community/scoring/rules/sub-rules/membro-is-moderated
/etc/community/scoring/rules/forums-scoring
subRules[] =
/etc/community/scoring/rules/sub-rules/membro-forum-create
/etc/community/scoring/rules/sub-rules/Member-receive-vote
/etc/community/scoring/rules/sub-rules/Member-dare-vote
/etc/community/scoring/rules/sub-rules/membro-is-moderated
Note:
I nodi rules
e sub-rules
sono entrambi di tipo cq:Page
subRules
è un attributo di tipo Stringon [] the jcr:content
node della regola
sub-rules
può essere condiviso tra diverse regole di punteggio
rules
devono trovarsi in una posizione archivio con autorizzazione di lettura per tutti
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.
Le regole di contrassegno collegano le regole di punteggio ai badge specificando:
Le regole di contrassegno sono nodi di tipo cq:Page
con proprietà sul relativo nodo jcr:content
che correlano le regole di punteggio a punteggi e badge.
Le regole per il contrassegno consistono in una proprietà obbligatoria thresholds
che è un elenco ordinato di punteggi mappati su badge. I punteggi devono essere ordinati in valore crescente. Esempio:
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
Le regole di badging sono associate alle regole di punteggio, che determinano l’accumulo di punti. Consulta la sezione intitolata Applica regole al contenuto.
La proprietà scoringRules
di una regola di badging limita semplicemente le regole di punteggio che possono essere associate a quella particolare regola di badging.
Procedure consigliate: crea immagini di badge univoche per ogni sito AEM.
Proprietà | Tipo | Valore Descrizione |
---|---|---|
soglie | Stringa[] | (obbligatorio) Stringa con più valori del modulo 'number|path'
Esempio di voce: 80|/etc/community/badging/images/gold-badge/jcr:content/gold.png |
badgingType | Stringa | (facoltativo) Identifica il motore di punteggio come "base" o "avanzato". Se desideri utilizzare un motore di punteggio avanzato, consulta Punteggio avanzato e Badge. Il valore predefinito è "basic". |
scoringRules |
Stringa[] | (facoltativo) Una stringa con più valori per limitare la regola di contrassegno agli eventi di punteggio identificati dalle regole di punteggio |
Nella versione sono incluse due regole di badging corrispondenti alle Regole di valutazione dei forum e dei commenti.
Note:
rules
i nodi sono di tipo cq:Page
rules
devono trovarsi in una posizione archivio con autorizzazione di lettura per tutti
Eventuali modifiche o aggiunte apportate alle regole di badging o alle immagini effettuate nell’ambiente di authoring devono essere installate al momento della pubblicazione.
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 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)
sign = administrator-id:password
ad esempio: admin:admin
operation = ":operation=social:assignBadge" OR ":operation=social:deleteBadge"
badge = "badgeContentPath=badge-image-file"
badge-image-file = posizione del file di 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
Il membro-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’utilizzo di cURL per assegnare e revocare i badge funziona per qualsiasi immagine di badge, ma quando viene assegnata al posto di earned, vengono contrassegnati come badge assegnati e gestiti di conseguenza.
Le regole di valutazione e di contrassegno possono essere create per i componenti personalizzati associando gli argomenti evento creati per il componente ai verbi.
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 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 della community consegnati, le tabelle seguenti descrivono i valori verbs
definiti per ogni topic
disponibile per l'utilizzo in regole secondarie di punteggio.
Una nuova proprietà booleana, allowBadges
, abilita/disabilita la visualizzazione dei badge per un’istanza di componente. Sarà configurabile nelle finestre di dialogo di modifica dei componenti aggiornate tramite una casella di controllo denominata Badge di visualizzazione.
Calendario
ComponentSocialEvent topic
= com/adobe/cq/social/calendar
Verbo | Descrizione |
---|---|
POST | un membro crea un evento calendario |
AGGIUNGI | commenti dei membri su un evento calendario |
AGGIORNA | modifica dell'evento calendario o del commento del membro |
ELIMINA | l'evento o il commento del calendario del membro viene eliminato |
Commenti
ComponentSocialEvent topic
= com/adobe/cq/social/comment
Verbo | Descrizione |
---|---|
POST | crea un commento |
AGGIUNGI | risposta del membro al commento |
AGGIORNA | modifica del commento del membro |
ELIMINA | il commento del membro viene eliminato |
Libreria file
ComponentSocialEvent topic
= com/adobe/cq/social/fileLibrary
Verbo | Descrizione |
---|---|
POST | crea una cartella |
ATTACCO | il membro carica un file |
AGGIORNA | un membro aggiorna una cartella o un file |
ELIMINA | elimina una cartella o un file |
Forum
ComponentSocialEvent topic
= com/adobe/cq/social/forum
Verbo | Descrizione |
---|---|
POST | argomento del forum crea membri |
AGGIUNGI | risposte dei membri all'argomento del forum |
AGGIORNA | argomento forum o risposta del membro viene modificato |
ELIMINA | l'argomento o la risposta del forum del membro è cancellata |
Journal
ComponentSocialEvent topic
= com/adobe/cq/social/journal
Verbo | Descrizione |
---|---|
POST | crea un articolo di blog |
AGGIUNGI | commenti di un membro su un articolo di blog |
AGGIORNA | articolo o commento del blog del membro è modificato |
ELIMINA | l'articolo o il commento del blog del membro è stato cancellato |
QnA
ComponentSocialEvent topic
= com/adobe/cq/social/qna
Verbo | Descrizione |
---|---|
POST | crea una domanda QnA |
AGGIUNGI | crea una risposta QnA |
AGGIORNA | viene modificata la domanda o la risposta QnA del membro |
SELEZIONA | risposta del membro selezionata |
ANNULLA | la risposta del membro è deselezionata |
ELIMINA | la domanda o la risposta QnA del membro viene eliminata |
Recensioni
ComponentSocialEvent topic
= com/adobe/cq/social/review
Verbo | Descrizione |
---|---|
POST | crea revisione |
AGGIORNA | modifica della revisione del membro |
ELIMINA | la revisione del membro viene eliminata |
Rating
ComponentSocialEvent topic
= com/adobe/cq/social/tally/rating
Verbo | Descrizione |
---|---|
AGGIUNGI VALUTAZIONE | il contenuto del membro è stato valutato |
RIMUOVI VALUTAZIONE | il contenuto del membro è stato valutato in modo non corretto |
Voto
ComponentSocialEvent topic
= com/adobe/cq/social/tally/vote
Verbo | Descrizione |
---|---|
AGGIUNGI VOTO | il contenuto del membro è stato votato |
RIMUOVI VOTO | il contenuto del membro è stato respinto |
Componenti abilitati per moderazioneSocialEvent topic
= com/adobe/cq/social/moderation
Verbo | Descrizione |
---|---|
NEGA | contenuto del membro negato |
FLAG-AS INAPPROPRIATO | il contenuto del membro è contrassegnato |
NON APPROPRIATO | il contenuto del membro viene rimosso |
ACCETTARE | il contenuto del membro è approvato dal moderatore |
CHIUDI | il membro chiude il commento alle modifiche e alle risposte |
APERTO | riapre il commento |
Per un componente personalizzato, viene creata un'istanza di SocialEvent per registrare gli eventi del componente come actions
che si verificano per un topic
.
Per supportare il punteggio, SocialEvent deve sovrascrivere il metodo getVerb()
in modo che venga restituito un verb
appropriato per ogni elemento action
. Il verb
restituito per un'azione può essere uno dei più comunemente utilizzati (come POST
) o uno specializzato per il componente (come ADD RATING
). Esiste una relazione n-1 tra actions
e verbs
.
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.
Vedere Abilita badge per componente.
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.
Vedere la proprietà scoringRules
di Regole di contrassegno.
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.
Puoi provare rapidamente a usare il punteggio e il contrassegno utilizzando il sito Esercitazione introduttiva (coinvolgi):
Accedere ad CRXDE Lite sull’autore
Passa alla pagina di base:
Aggiungi la proprietà badgingRules :
badgingRules
String
/etc/community/badging/rules/forums-badging
+
/etc/community/badging/rules/comments-badging
Aggiungi la proprietà scoringRules :
scoringRules
String
/etc/community/scoring/rules/forums-scoring
+
/etc/community/scoring/rules/comments-scoring
Seleziona Salva tutto
Successivamente, assicurati che i componenti forum e commenti consentano la visualizzazione dei badge:
Utilizzare ancora CRXDE Lite
Passa al componente forum
/content/sites/engage/en/forum/jcr:content/content/primary/forum
Aggiungi la proprietà booleana allowBadges, se necessario, e accertati che sia vera
allowBadges
Boolean
true
Successivamente, ripubblicare il sito della community.
Infine,
Passa al componente nell’istanza di pubblicazione
Accedi come membro della community (ad esempio: weston.mccall@dodgit.com / password)
Pubblica un nuovo argomento del forum
La pagina deve essere aggiornata affinché il badge sia visibile
Selezionare il forum
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.
Per ulteriori informazioni, consulta la pagina Punteggio e Badges Essentials per gli sviluppatori.
Per informazioni sul motore di punteggio avanzato, consulta Punteggio avanzato e Badge.
La classifica configurabile component e function semplifica la visualizzazione dei membri e dei relativi punteggi su un sito community.