La funzione punteggio e distintivi AEM Communities consente di identificare e premiare i membri della community.
I principali aspetti del punteggio e dei simboli sono:
Assegnare i badge per identificare il ruolo di un membro nella community
Attribuzione di base di badgesto ai membri per incoraggiarne la partecipazione (quantità di contenuto creato)
Assegnazione avanzata di badgesto per identificare i membri come esperti (qualità del contenuto creato)
Tenere presente che l'assegnazione dei simboli 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 distintivi sono posti sotto il nome di un membro per indicare il suo ruolo o la sua posizione nella comunità. I simboli possono essere visualizzati come immagine o come nome. Quando viene visualizzata come immagine, il nome viene incluso come testo alternativo per l'accessibilità.
Per impostazione predefinita, i simboli si trovano nella directory archivio in
Se memorizzati in un percorso diverso, tutti dovrebbero essere accessibili in lettura.
I distintivi sono differenziati in UGC se sono stati assegnati o sono stati guadagnati in base alle regole. Al momento, i simboli assegnati vengono visualizzati come testo e i simboli acquisiti vengono visualizzati come immagine.
La console Community Badges offre la possibilità di aggiungere distintivi personalizzati che possono essere visualizzati per un membro al momento della ricezione (assegnazione) o quando assumono un ruolo specifico nella comunità (assegnazione).
I simboli basati sul ruolo vengono assegnati da un amministratore ai membri della community in base al loro ruolo nella comunità.
I simboli assegnati (e avvertiti) sono memorizzati nell' SRP selezionato e non sono direttamente accessibili. Fino a quando non sarà disponibile un'interfaccia utente grafica, l'unico modo per assegnare i simboli basati sui ruoli è farlo con codice o cURL. Per le istruzioni cURL, vedere la sezione intitolata Assegna e revoca distintivi.
Nella versione sono inclusi tre simboli basati sui ruoli:
Moderatore
/etc/community/badging/images/moderator/jcr:content/moderator.png
Manager gruppo
/etc/community/badging/images/group-manager/jcr:content/group-manager.png
Membro privilegiato
/etc/community/badging/images/privileged-member/jcr:content/privileged-member.png
Il servizio di assegnazione dei punteggi viene assegnato ai membri della comunità in base alle regole applicate alla loro attività nella comunità.
Affinché i simboli possano essere visualizzati come una ricompensa per l'attività, devono accadere due cose:
Nel rilascio sono inclusi tre simboli basati sulla ricompensa:
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 punteggio possono essere configurate per assegnare punti negativi ai post contrassegnati come inappropriati e quindi per influenzare il valore del punteggio. Tuttavia, una volta ottenuto un contrassegno, questo non verrà rimosso automaticamente a causa di modifiche alla regola di riduzione del punto di punteggio o di valutazione.
I simboli assegnati possono essere revocati allo stesso modo dei simboli assegnati. Vedere la sezione Assegna e revoca distintivi. I miglioramenti futuri includeranno un'interfaccia utente per gestire i simboli dei membri.
I simboli personalizzati possono essere installati utilizzando la console Badges e possono essere assegnati o specificati nelle regole di contrassegno.
Se installati dalla console Badge, i simboli personalizzati vengono replicati automaticamente nell’ambiente di pubblicazione.
Il punteggio non è abilitato per impostazione predefinita. I passaggi di base per l’impostazione e l’abilitazione del punteggio e dell’assegnazione dei simboli sono:
Identificare le regole per i punti di guadagno (regole di punteggio)
Per i punti accumulati per le regole di punteggio, assegnare simboli (regole di contrassegno)
Applicazione delle regole di punteggio e contrassegno a un sito community
Consultate 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 simboli, 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 attivato i componenti, ripubblicate il sito.
Le regole applicabili a un componente abilitato per il contrassegno sono quelle relative al nodo corrente o al suo predecessore.
Se il nodo è di tipo cq:Page
(consigliato), aggiungere le proprietà al nodo jcr:content
utilizzando CRXDE|Lite.
Proprietà | Tipo | Descrizione |
---|---|---|
badgingRules | Stringa[] | un elenco di array di regole di contrassegno |
scoringRules | Stringa[] | un elenco di array di regole di punteggio |
Se una regola di punteggio non ha alcun effetto sull'assegnazione dei simboli, assicurarsi che la regola di punteggio non sia stata bloccata dalla proprietà ScoringRules della regola di assegnazione contrassegno. Vedere la sezione intitolata Regole di assegnazione dei tag.
Le regole di punteggio e di binding sono valide solo per le istanze di componenti che hanno attivato il contrassegno modificando la configurazione del componente in modalità di authoring.
Una proprietà booleana, allowBadges
, attiva/disattiva la visualizzazione dei simboli per un’istanza di componente. È configurabile nella finestra di dialogo di modifica dei componenti per i componenti forum, QnA e commento tramite una casella di controllo con l'etichetta Display Badges.
Qualsiasi componente può essere sovrapposto per visualizzare i simboli utilizzando come esempio il codice HBS presente nei forum, QnA e nei commenti.
Le regole di punteggio sono alla base del punteggio ai fini dell'assegnazione dei distintivi.
Molto semplicemente, ogni regola di punteggio è un elenco di una o più regole secondarie. Le regole di punteggio vengono applicate al contenuto del sito della community per identificare le regole da applicare quando i simboli sono abilitati.
Le regole di punteggio vengono ereditate ma non aggiunte. Esempio:
Se la pagina2 contiene la regola di punteggio2 e la pagina precedente contiene la regola di punteggio1
Un'azione su un componente pagina2 richiamerà sia regola1 che 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à nel nodo jcr:content
che specificano l'elenco di regole secondarie che lo definiscono.
I punteggi sono memorizzati in SRP.
Best practice: assegnate 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.
Esempio di operazione not:
/etc/community/scoring/rules/site1/forums-scoring
/etc/community/scoring/rules/site2/forums-scoring
Le regole secondarie del punteggio contengono le proprietà che descrivono i valori per la partecipazione alla comunità.
Ogni regola secondaria di punteggio identifica
Per impostazione predefinita, i punti vengono assegnati al membro che esegue l'azione, a meno che la regola secondaria non specifichi che il proprietario del contenuto riceve i punti ( forOwner
).
Ciascuna regola secondaria può essere inclusa in una o più regole di punteggio.
Il nome della regola secondaria segue in genere il pattern di utilizzo di un oggetto oggetto, oggetto e verb. Esempio:
Le regole secondarie sono nodi di tipo cq:Page
con proprietà sul nodo jcr:content
che specificano i verbi e i topic e .
Proprietà | Tipo | Valore Descrizione |
---|---|---|
VERB |
Lungo |
|
topics |
Stringa[] |
|
forOwner |
Booleano |
|
scoringType |
Stringa |
|
Nella release sono incluse due regole di punteggio 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/membro-dare-voto
/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/membro-dare-voto
/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 [] sul jcr:content
nodo della regola
sub-rules
può essere condiviso tra diverse regole di punteggio
rules
devono trovarsi in una posizione di repository con l'autorizzazione di lettura per tutti
Eventuali modifiche o aggiunte apportate alle regole di punteggio o alle regole secondarie nell’ambiente di authoring devono essere installate al momento della pubblicazione.
Le regole di assegnazione del tag collegano le regole di punteggio ai simboli specificando:
Le regole di contrassegno sono nodi di tipo cq:Page
con proprietà sul nodo jcr:content
che collegano le regole di punteggio a valutazioni e simboli.
Le regole per il contrassegno consistono in una proprietà obbligatoria thresholds
che è un elenco ordinato di punteggi mappati a simboli. 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 a regole di punteggio, che determinano come si accumulano i punti. Vedere la sezione intitolata Applica regole a contenuto.
La proprietà scoringRules
di una regola di contrassegno limita semplicemente le regole di punteggio che possono essere associate a quella regola di contrassegno specifica.
Procedura consigliata: create immagini di contrassegno univoche per ciascun sito AEM.
Proprietà | Tipo | Valore Descrizione |
---|---|---|
threshold | Stringa[] | (obbligatorio) Stringa con più valori del formato 'numero|percorso'
Voce di esempio: 80|/etc/community/badging/images/gold-badge/jcr:content/gold.png |
badgingType | Stringa | (facoltativo) Identifica il motore di valutazione come "base" o "avanzato". Se si desidera utilizzare il motore di valutazione avanzato, vedere Advanced Scoring and Badges. Il valore predefinito è "basic". |
scoringRules |
Stringa[] | (facoltativo) Una stringa multivalore per limitare la regola di contrassegno agli eventi di punteggio identificati dalle regole di punteggio |
Nella release sono incluse due regole di badging corrispondenti alle regole di punteggio per forum e commenti.
Note:
rules
i nodi sono di tipo cq:Page
rules
devono trovarsi in una posizione di repository con l'autorizzazione di lettura per tutti
Eventuali modifiche o aggiunte apportate alle regole di contrassegno o alle immagini nell’ambiente di authoring devono essere installate al momento della pubblicazione.
I distintivi possono essere assegnati ai membri utilizzando la console dei membri o a livello di programmazione utilizzando i comandi cURL.
I seguenti comandi cURL mostrano quanto è necessario per una richiesta HTTP di assegnazione e revoca dei simboli. 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 trasmettere al server (richiesta)
signin = administrator-id:password
ad esempio: admin:admin
operation = ":operation=social:assignBadge" OPPURE ":operation=social:deleteBadge"
badge = "badgeContentPath=badge-image-file"
badge-image-file = posizione del file di immagine del contrassegno nell’archivio
ad esempio: /etc/community/badging/images/moderator/jcr:content/moderator.png
Member-profile-url = l’endpoint per il profilo del membro al momento della pubblicazione
ad esempio: https://<server>:<porta>/home/users/community/riley/profile.social.json
membro-profilo-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 simboli funziona per qualsiasi immagine contrassegno, ma quando viene assegnata al posto di quella ottenuta, vengono contrassegnati come simboli assegnati e gestiti di conseguenza.
Le regole di punteggio e contrassegno possono essere create per i componenti personalizzati associando gli argomenti evento creati per il componente ai verbi.
Quando i membri interagiscono con le funzionalità delle community, 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 elemento verb
associato all'azione. Esiste una relazione n-1 tra actions
e verbs
.
Per i componenti forniti dalle comunità, le tabelle seguenti descrivono la verbs
definita per ogni topic
disponibile per l'uso in sub-regole di punteggio.
Una nuova proprietà booleana, allowBadges
, abilita/disabilita la visualizzazione dei simboli per un'istanza di componente. Sarà configurabile nelle finestre di dialogo di modifica dei componenti aggiornate tramite una casella di controllo con etichetta Display Badges.
Calendar
ComponentSocialEvent topic
= com/adobe/cq/social/Calendar
Verbo | Descrizione |
---|---|
POST | membro crea un evento del calendario |
AGGIUNGI | commenti dei membri su un evento del calendario |
AGGIORNA | evento del calendario del membro o commento modificato |
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 | commento del membro è stato modificato |
ELIMINA | commento del membro è eliminato |
Libreria file
ComponentSocialEvent topic
= com/adobe/cq/social/fileLibrary
Verbo | Descrizione |
---|---|
POST | create una cartella |
ATTACCO | il membro carica un file |
AGGIORNA | il membro aggiorna una cartella o un file |
ELIMINA | il membro elimina una cartella o un file |
Forum
ComponentSocialEvent topic
= com/adobe/cq/social/forum
Verbo | Descrizione |
---|---|
POST | membro crea argomento del forum |
AGGIUNGI | risposte dei membri all'argomento del forum |
AGGIORNA | argomento forum o risposta del membro è modificato |
ELIMINA | l'argomento o la risposta del forum del membro viene eliminata |
Journal
ComponentSocialEvent topic
= com/adobe/cq/social/journal
Verbo | Descrizione |
---|---|
POST | un membro crea un articolo di blog |
AGGIUNGI | commenti dei membri su un articolo di blog |
AGGIORNA | articolo o commento del blog del membro è stato modificato |
ELIMINA | l'articolo o il commento del blog del membro viene eliminato |
QnA
ComponentSocialEvent topic
= com/adobe/cq/social/qna
Verbo | Descrizione |
---|---|
POST | un membro crea una domanda QnA |
AGGIUNGI | un membro crea una risposta QnA |
AGGIORNA | la domanda o la risposta QnA del membro viene modificata |
SELECT | la 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 | il membro crea una revisione |
AGGIORNA | revisione membro |
ELIMINA | la revisione del membro viene eliminata |
Valutazione
ComponentSocialEvent topic
= com/adobe/cq/social/tally/rating
Verbo | Descrizione |
---|---|
AGGIUNGI VALUTAZIONE | il contenuto del membro è stato valutato |
RIMUOVI VALUTAZIONE | il contenuto del membro non è stato valutato |
Voto
ComponentSocialEvent topic
= com/adobe/cq/social/tally/Votazione
Verbo | Descrizione |
---|---|
AGGIUNGI VOTO | il contenuto del membro è stato votato |
RIMUOVI VOTO | il contenuto del membro è stato respinto |
Moderation enabled
ComponentsSocialEvent topic
= com/adobe/cq/social/moderation
Verbo | Descrizione |
---|---|
NEGA | contenuto del membro negato |
FLAG-AS-INAPPROPRIATE | il contenuto del membro è contrassegnato |
INAPPROPRIATO | contenuto del membro non contrassegnato |
ACCETTARE | il contenuto del membro è approvato dal moderatore |
CHIUDI | il membro chiude il commento alle modifiche e alle risposte |
APRI | riapre commento membro |
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 sostituire il metodo getVerb()
in modo che venga restituito un verb
appropriato per ogni action
. La verb
restituita per un'azione può essere utilizzata comunemente (come POST
) o una specifica 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 punteggio e contrassegno, ma i simboli non vengono avvertiti per alcuna attività, accertatevi che i simboli siano stati abilitati per l'istanza del componente in questione.
Vedere Abilitare i simboli per il componente.
Se al contenuto del sito Web sono state applicate regole di punteggio e contrassegno e i simboli vengono assegnati per alcune azioni, ma non per altre, verificate che la regola di contrassegno non abbia limitato le regole di punteggio a cui si applica.
Vedere la proprietà scoringRules
di Regole di Badging.
La maggior parte delle proprietà e dei valori, in particolare i verbi, sono sensibili alle maiuscole/minuscole. I verbi devono essere tutti UPPERCASE se utilizzati in una regola secondaria di punteggio.
Se la funzione non funziona come previsto, verificare che i dati siano stati immessi correttamente.
È possibile provare rapidamente il punteggio e il contrassegno utilizzando il sito Esercitazione iniziale (interazione):
Accesso CRXDE Lite all'autore
Passa alla pagina di base:
Aggiungere la proprietà badgingRules:
badgingRules
String
/etc/community/badging/rules/forums-badging
+
/etc/community/badging/rules/comments-badging
Aggiungere la proprietà scoringRules:
scoringRules
String
/etc/community/scoring/rules/forums-scoring
+
/etc/community/scoring/rules/comments-scoring
Selezionare Salva tutto
Assicuratevi quindi che i componenti forum e commenti consentano la visualizzazione dei simboli:
Nuovo utilizzo di CRXDE Lite
Passare 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
Quindi, ripubblicare il sito della community.
Infine,
Individuare il componente nell’istanza di pubblicazione
Accedi come membro della community (ad esempio: weston.mccall@dodgit.com / password)
Pubblicare un nuovo argomento del forum
Per visualizzare il contrassegno, è necessario aggiornare la pagina
Selezionate il forum
Questo dovrebbe far sì che il membro della comunità un distintivo di bronzo visibile con il post del forum a causa della prima soglia della regola di tessitura del forum è un punteggio di 1.
Ulteriori informazioni sono disponibili nella pagina Scoring and Badges Essentials per gli sviluppatori.
Per informazioni sul motore di valutazione avanzato, vedere Advanced Scoring and Badges (Punteggio avanzato e Badge).
La componente e la funzione configurabili semplifica la visualizzazione dei membri e dei loro punteggi su un sito community.