Die AEM Communities-Scoring- und -Badges-Funktion bietet die Möglichkeit, Community-Mitglieder zu identifizieren und zu belohnen.
Die wichtigsten Aspekte von Scoring und Badges sind:
Zuweisen von Abzeichen die Rolle eines Mitglieds in der Gemeinschaft zu identifizieren.
Grundlegende Vergabe von Abzeichen an die Mitglieder, um ihre Teilnahme zu fördern (Menge der erstellten Inhalte).
Erweiterte Vergabe von Abzeichen Identifizierung der Mitglieder als Experten (Qualität der erstellten Inhalte).
Hinweis die Vergabe von Abzeichen nicht standardmäßig aktiviert.
Die in CRXDE Lite sichtbare Implementierungsstruktur kann sich ändern, sobald die Benutzeroberfläche verfügbar ist.
Abzeichen werden unter dem Namen eines Mitglieds platziert, um entweder ihre Rolle oder ihre Stellung in der Community anzugeben. Abzeichen können entweder als Bild oder als Name angezeigt werden. Wenn der Name als Bild angezeigt wird, wird er als alternativer Text für die Barrierefreiheit eingefügt.
Standardmäßig befinden sich Abzeichen im Repository unter:
/libs/settings/community/badging/images
Wenn sie an einem anderen Speicherort gespeichert sind, sollten sie für alle lesbar sein.
Badges werden in UGC unterschieden, ob sie gemäß den Regeln zugewiesen wurden oder verdient wurden. Derzeit werden zugewiesene Abzeichen als Text und Earned Abzeichen als Bild angezeigt.
Die Gemeinschaften Badges-Konsole können Sie benutzerdefinierte Abzeichen hinzufügen, die für ein Mitglied angezeigt werden können, wenn es eine bestimmte Rolle in der Community spielt (zugewiesen).
Rollenbasierte Abzeichen werden von einem Administrator den Community-Mitgliedern basierend auf ihrer Rolle in der Community zugewiesen.
Zugewiesene (und zuerkannte) Abzeichen werden in der ausgewählten SRP und nicht direkt zugänglich sind. Solange keine grafische Benutzeroberfläche verfügbar ist, können rollenbasierte Abzeichen nur mit Code oder cURL zugewiesen werden. Anweisungen zu cURL finden Sie im Abschnitt mit dem Titel Zuweisen und Sperren von Abzeichen.
In der Version sind drei rollenbasierte Abzeichen enthalten:
Moderator
/libs/settings/community/badging/images/moderator/jcr:content/moderator.png
Gruppenmanager
/libs/settings/community/badging/images/group-manager/jcr:content/group-manager.png
privilegiertes Mitglied
/libs/settings/community/badging/images/privileged-member/jcr:content/privileged-member.png
Belohnungsbasierte Abzeichen werden vom Scoring-Dienst an Community-Mitglieder vergeben, basierend auf Regeln, die auf ihre Aktivität in der Community angewendet werden.
Damit Abzeichen als Belohnung für Aktivitäten angezeigt werden, müssen zwei Dinge geschehen:
In der Version sind drei belohnungsbasierte Abzeichen enthalten:
Gold
/libs/settings/community/badging/images/gold-badge/jcr:content/gold.png
silber
/libs/settings/community/badging/images/silver-badge/jcr:content/silver.png
Bronze
/libs/settings/community/badging/images/bronze-badge/jcr:content/bronze.png
Scoring-Regeln können so konfiguriert werden, dass negative Punkte für Beiträge zugewiesen werden, die als unangemessen gekennzeichnet sind und sich daher auf den Punktwert auswirken. Nachdem ein Badge jedoch verdient wurde, wird es aufgrund von Scoring-Punktreduzierung oder Änderungen der Scoring-Regel nicht automatisch entfernt.
Zugewiesene Abzeichen können wie zugewiesene Abzeichen widerrufen werden. Siehe Zuweisen und Sperren von Abzeichen Abschnitt. Zukünftige Verbesserungen umfassen eine Benutzeroberfläche zur Verwaltung der Abzeichen von Mitgliedern.
Benutzerdefinierte Abzeichen können mit der Badges-Konsole und entweder zugewiesen oder in Badging-Regeln angegeben.
Bei der Installation über die Badges-Konsole werden benutzerdefinierte Abzeichen automatisch in die Veröffentlichungsumgebung repliziert.
Die Auswertung ist standardmäßig nicht aktiviert. Die grundlegenden Schritte zum Einrichten und Aktivieren der Auswertung und Verleihung von Abzeichen sind:
Identifizieren Sie Regeln für Ertragspunkte (Scoring-Regeln).
Für Punkte, die nach Scoring-Regeln gesammelt wurden, weisen Sie Badges (Badging-Regeln).
Anwenden der Scoring- und Badging-Regeln auf eine Community-Site.
Siehe Schnelltest -Abschnitt, um die Scoring-Funktion für eine Community-Site mithilfe der standardmäßigen Scoring- und Badging-Regeln für Foren und Kommentare zu aktivieren.
Um Scoring und Badges zu aktivieren, fügen Sie die Eigenschaften hinzu scoringRules
und badgingRules
zu einem beliebigen Knoten in der Inhaltsstruktur für die Site hinzu.
Wenn die Site bereits veröffentlicht wurde, veröffentlichen Sie die Site erneut, nachdem Sie alle Regeln angewendet und Komponenten aktiviert haben.
Regeln, die für eine Badging-fähige Komponente gelten, sind diejenigen für den aktuellen Knoten oder dessen Vorgänger.
Wenn der Knoten vom Typ cq:Page
(empfohlen) und fügen Sie dann mit CRXDE|Lite die Eigenschaften zu seiner jcr:content
Knoten.
Eigenschaft | Typ | Beschreibung |
---|---|---|
badgingRules | Zeichenfolge | eine Array-Liste von Badging-Regeln |
scoringRules | Zeichenfolge | eine Array-Liste von Scoring-Regeln |
Wenn eine Scoring-Regel anscheinend keine Auswirkungen auf das Verteilen von Abzeichen hat, stellen Sie sicher, dass die Scoring-Regel nicht von der Eigenschaft scoringRules der Badging-Regel blockiert wurde. Siehe Abschnitt mit dem Titel Badging-Regeln.
Die Scoring- und Bading-Regeln sind nur für Instanzen von Komponenten wirksam, die Badging aktiviert haben, indem sie die Komponentenkonfiguration in Authoring-Modus.
eine boolesche Eigenschaft, allowBadges
aktiviert/deaktiviert die Anzeige von Abzeichen für eine Komponenteninstanz. Er kann im Dialogfeld "Komponentenbearbeitung" für Forum-, Fragen- und Kommentar-Komponenten über ein Kontrollkästchen mit der Bezeichnung Anzeigemarken.
Jede Komponente kann überlagert werden, um Abzeichen anhand des in Foren, Fragen und Antworten sowie Kommentaren enthaltenen HBS-Codes anzuzeigen.
Scoring-Regeln sind die Grundlage für die Vergabe von Badges.
Jede Scoring-Regel ist eine Liste mit einer oder mehreren Unterregeln. Scoring-Regeln werden auf den Community-Site-Inhalt angewendet, um die Regeln zu identifizieren, die bei der Aktivierung von Badges angewendet werden sollen.
Scoring-Regeln werden vererbt, sind jedoch nicht additiv. Beispiel:
Wenn Seite 2 die Scoring-Regel2 enthält und ihr Vorgänger Seite 1 die Scoring-Regel 1 enthält.
Eine Aktion auf einer Komponente "Seite 2"ruft sowohl Regel1 als auch Regel2 auf.
Wenn beide Regeln anwendbare Unterregeln für dieselben enthalten topic/verb
:
Wenn es mehr als eine Scoring-Regel gibt, werden die Werte für jede Regel separat beibehalten.
Scoring-Regeln sind Knoten des Typs cq:Page
mit Eigenschaften auf jcr:content
-Knoten, der die Liste der Unterregeln angibt, die ihn definieren.
Die Bewertungen werden im SRP gespeichert.
Best Practice: Benennen Sie jede Scoring-Regel eindeutig.
Die Namen von Scoring-Regeln sollten global eindeutig sein. sollten sie nicht mit demselben Namen enden.
Ein Beispiel für not zu tun:
/libs/settings/community/scoring/rules/site1/forums-scoring
/libs/settings/community/scoring/rules/site2/forums-scoring
Die Scoring-Unterregeln enthalten die Eigenschaften, die die Werte für die Teilnahme an der Community detailliert beschreiben.
Jede Scoring-Unterregel identifiziert:
Standardmäßig werden Punkte dem Mitglied zugewiesen, das eine Aktion durchführt, es sei denn, die Unterregel legt den Eigentümer des Inhalts als Empfänger der Punkte fest ( forOwner
).
Jede Unterregel kann in einer oder mehreren Scoring-Regeln enthalten sein.
Der Name der Unterregel folgt normalerweise dem Muster der Verwendung einer subject, Objekt und verb. Beispiel:
Unterregeln sind Knoten des Typs cq:Page
mit Eigenschaften auf jcr:content
Knoten, der die verbs und topics .
Eigenschaft | Typ | Wert Beschreibung |
---|---|---|
VERB |
Long |
|
topics |
Zeichenfolge |
|
forOwner |
Boolesch |
|
scoringType |
Zeichenfolge |
|
In der Version sind zwei Scoring-Regeln für die Forumsfunktion (jeweils eine für die Komponenten Forum und Kommentare der Funktion Forum ):
/libs/settings/community/scoring/rules/comments-scoring
/libs/settings/community/scoring/rules/forums-scoring
Anmerkungen:
Beide rules
und sub-rules
-Knoten sind vom Typ cq:Page.
subRules
ist ein Attribut des Typs String[] zur Regel jcr:content
Knoten.
sub-rules
kann für verschiedene Scoring-Regeln freigegeben werden.
rules
sollte sich in einem Repository-Speicherort mit Leseberechtigung für alle befinden.
Änderungen oder Ergänzungen an Scoring-Regeln oder -Unterregeln, die in der Autorenumgebung vorgenommen werden, müssen in der Veröffentlichungsumgebung installiert werden.
Badging-Regeln verknüpfen Scoring-Regeln mit Abzeichen, indem Folgendes angegeben wird:
Badging-Regeln sind Knoten des Typs cq:Page
mit Eigenschaften auf jcr:content
-Knoten, der Scoring-Regeln mit Bewertungen und Abzeichen korreliert.
Die Badging-Regeln beinhalten eine obligatorische thresholds
-Eigenschaft, die eine geordnete Liste von Bewertungen darstellt, die Abzeichen zugeordnet sind. Die Werte müssen in zunehmendem Wert geordnet werden. Beispiel:
1|/libs/settings/community/badging/images/bronze-badge/jcr:content/bronze.png
60|/libs/settings/community/badging/images/silver-badge/jcr:content/silver.png
80|/libs/settings/community/badging/images/gold-badge/jcr:content/gold.png
Badging-Regeln werden mit Scoring-Regeln gepaart, die bestimmen, wie Punkte gesammelt werden. Siehe Abschnitt mit dem Titel Regeln auf Inhalt anwenden.
Die scoringRules
-Eigenschaft einer Badging-Regel schränkt einfach ein, welche Scoring-Regeln mit dieser Badging-Regel gepaart werden können.
Best Practice : Badge-Bilder erstellen, die für jede AEM Site eindeutig sind.
Eigenschaft | Typ | Wert Beschreibung |
---|---|---|
Schwellenwerte | Zeichenfolge | (erforderlich) Eine mehrwertige Zeichenfolge des Formulars "number|path"
Beispieleintrag : 80|/libs/settings/community/badging/images/gold-badge/jcr:content/gold.png |
badgingType | Zeichenfolge | (optional) Identifiziert die Scoring-Engine entweder als "Standard"oder als "erweitert". Wenn die erweiterte Scoring-Engine gewünscht wird, lesen Sie Erweiterte Scoring- und Badges. Die Standardeinstellung ist "Standard". |
scoringRules | Zeichenfolge | (optional) Eine Zeichenfolge mit mehreren Werten, um die Badging-Regel auf die von den Scoring-Regeln identifizierten Scoring-Ereignisse zu beschränken |
In der Version sind zwei Badging-Regeln enthalten, die dem Foren und Kommentar-Scoring-Regeln.
/libs/settings/community/badging/rules/comments-badging
/libs/settings/community/badging/rules/forums-badging
Anmerkungen:
rules
-Knoten sind vom Typ cq:Page.
rules
sollte sich in einem Repository-Speicherort mit Leserechte für alle befinden.
Änderungen oder Ergänzungen an Badging-Regeln oder Bildern, die in der Autorenumgebung vorgenommen werden, müssen in der Veröffentlichungsumgebung installiert werden.
Abzeichen können Mitgliedern zugewiesen werden, indem sie entweder Mitgliederkonsole oder programmgesteuert mithilfe von cURL-Befehlen.
Die folgenden cURL-Befehle zeigen, was für eine HTTP-Anfrage zum Zuweisen und Sperren von Badges erforderlich ist. Das Standardformat lautet:
cURL -i -X POST -H header -u Anmeldung -F operation -F badge member-profile-url
header = Benutzerdefinierte Kopfzeile "Accept:application/json", die an den Server übergeben wird (erforderlich)
Anmeldung = administrator-id:password zum Beispiel : admin:admin
operation = ":operation=social:assignBadge" ODER ":operation=social:deleteBadge"
badge = "badgeContentPath=badge-image-file"
badge-image-file = der Speicherort der Badge-Bilddatei im Repository, z. B. : /libs/settings/community/badging/images/moderator/jcr:content/moderator.png
member-profile-url = Endpunkt für das Profil des Mitglieds in der Veröffentlichungsinstanz, z. B. : https://<server>:<port>/home/users/community/riley/profile.social.json
Die member-profile-url:
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
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
Die Verwendung von cURL zum Zuweisen und Sperren von Badges funktioniert für jedes Badge-Bild. Bei der Zuweisung von Badge anstelle von Earned, werden diese als zugewiesene Badges markiert und entsprechend verarbeitet.
Scoring- und Badging-Regeln können für benutzerdefinierte Komponenten erstellt werden, indem die für die Komponente erstellten Ereignisthemen Verben zugeordnet werden.
Wenn Mitglieder mit Communities-Funktionen interagieren, werden Ereignisse gesendet, die asynchrone Listener wie Benachrichtigungen und Scoring Trigger werden können.
Die SocialEvent-Instanz einer Komponente zeichnet die Ereignisse als actions
die für topic
. Das SocialEvent enthält eine Methode zum Zurückgeben einer verb
mit der Aktion verknüpft ist. Es gibt eine n-1 Beziehung actions
und verbs
.
Die folgenden Tabellen beschreiben für die bereitgestellten Communities-Komponenten die verbs
für jeden topic
zur Verwendung in Scoring-Unterregeln.
eine neue boolesche Eigenschaft, allowBadges
aktiviert/deaktiviert die Anzeige von Abzeichen für eine Komponenteninstanz. Es ist in aktualisiert konfigurierbar Dialogfelder zur Komponentenbearbeitung durch ein Kontrollkästchen mit der Beschriftung Anzeigemarken.
Kalenderkomponente
SocialEvent topic
= com/adobe/cq/social/calendar
Verb | Beschreibung |
---|---|
POST | Mitglied erstellt ein Kalenderereignis |
HINZUFÜGEN | Mitgliederkommentare für ein Kalenderereignis |
AKTUALISIEREN | Kalenderereignis oder -kommentar eines Mitglieds wird bearbeitet |
LÖSCHEN | Kalenderereignis oder -kommentar eines Mitglieds wird gelöscht |
Kommentarkomponente
SocialEvent topic
= com/adobe/cq/social/comment
Verb | Beschreibung |
---|---|
POST | Mitglied erstellt einen Kommentar |
HINZUFÜGEN | Mitglied antwortet auf Kommentar |
AKTUALISIEREN | Der Kommentar des Mitglieds wird bearbeitet |
LÖSCHEN | Kommentar des Mitglieds wird gelöscht |
Dateibibliothekskomponente
SocialEvent topic
= com/adobe/cq/social/fileLibrary
Verb | Beschreibung |
---|---|
POST | Mitglied erstellt Ordner |
ANHÄNGEN | Mitglied lädt eine Datei hoch |
AKTUALISIEREN | Mitglied aktualisiert Ordner oder Dateien |
LÖSCHEN | Mitglied löscht Ordner oder Dateien |
Forumkomponente
SocialEvent topic
= com/adobe/cq/social/forum
Verb | Beschreibung |
---|---|
POST | Mitglied erstellt Forumthema |
HINZUFÜGEN | Mitgliederantworten zum Forumthema |
AKTUALISIEREN | Forenthema oder Antwort des Mitglieds wird bearbeitet |
LÖSCHEN | Forenthema oder Antwort des Mitglieds wurde gelöscht |
Journalkomponente
SocialEvent topic
= com/adobe/cq/social/journal
Verb | Beschreibung |
---|---|
POST | Mitglied erstellt einen Blogartikel |
HINZUFÜGEN | Kommentare zu Mitgliedern in einem Blogartikel |
AKTUALISIEREN | Blogartikel oder Kommentar eines Mitglieds wird bearbeitet |
LÖSCHEN | Blogartikel oder Kommentar eines Mitglieds wird gelöscht |
QnA-Komponente
SocialEvent topic
= com/adobe/cq/social/qna
Verb | Beschreibung |
---|---|
POST | Mitglied erstellt eine Frage zur Frage der Fragen |
HINZUFÜGEN | Mitglied erstellt eine Antwort auf Fragen und Antworten |
AKTUALISIEREN | Frage oder Antwort des Mitglieds wird bearbeitet |
SELECT | Antwort des Mitglieds ist ausgewählt |
UNSELECT | Die Antwort des Mitglieds ist deaktiviert. |
LÖSCHEN | Frage oder Antwort des Mitglieds wird gelöscht |
Überprüfungskomponente
SocialEvent topic
= com/adobe/cq/social/review
Verb | Beschreibung |
---|---|
POST | Mitglied erstellt Überprüfung |
AKTUALISIEREN | Die Überprüfung des Mitglieds wird bearbeitet |
LÖSCHEN | Überprüfung durch das Mitglied wird gestrichen |
Bewertungskomponente
SocialEvent topic
= com/adobe/cq/social/tally/rating
Verb | Beschreibung |
---|---|
RATE HINZUFÜGEN | Der Inhalt des Mitglieds wurde bewertet. |
RATE ENTFERNEN | der Inhalt des Mitglieds wurde heruntergestuft |
Abstimmungskomponente
SocialEvent topic
= com/adobe/cq/social/tally/stimmberechtigt
Verb | Beschreibung |
---|---|
ABSTIMMUNG HINZUFÜGEN | Der Inhalt des Mitglieds wurde abgestimmt |
ABSTIMMUNG ENTFERNEN | Der Inhalt des Mitglieds wurde abgelehnt |
Moderationsfähige Komponenten
SocialEvent topic
= com/adobe/cq/social/moderation
Verb | Beschreibung |
---|---|
ABLEHNEN | Inhalt des Mitglieds wird verweigert |
FLAG-AS-INAPPROPRIATE | Inhalt des Mitglieds wird gekennzeichnet |
UNFLAG-AS-INAPPROPRIATE | Inhalt des Mitglieds ist unmarkiert |
AKZEPT | Der Inhalt des Mitglieds wird vom Moderator genehmigt |
SCHLIESSEN | Mitglied schließt Kommentar zu Bearbeitungen und Antworten |
ÖFFNEN | Mitglied wiederholt Kommentar |
Bei einer benutzerdefinierten Komponente wird ein SocialEvent instanziiert, um die Ereignisse der Komponente als actions
die für topic
.
Um die Auswertung zu unterstützen, muss das SocialEvent die Methode überschreiben getVerb()
, damit verb
wird für jeden action
. Die verb
für eine Aktion zurückgegeben wird, kann eine häufig verwendete Aktion sein (z. B. POST
) oder einer für die Komponente spezialisierten Komponente (z. B. ADD RATING
). Es gibt eine n-1 Beziehung actions
und verbs
.
Wenn Scoring- und Badging-Regeln auf den Inhalt der Website angewendet wurden, Abzeichen jedoch nicht für Aktivitäten vergeben werden, stellen Sie sicher, dass Abzeichen für die Instanz dieser Komponente aktiviert wurden.
Siehe Aktivieren von Abzeichen für Komponenten.
Wenn Scoring- und Badging-Regeln auf den Inhalt der Website angewendet wurden und Abzeichen für einige Aktionen, aber nicht für andere zugewiesen werden, überprüfen Sie, ob die Badging-Regel die Scoring-Regeln, für die sie gilt, nicht eingeschränkt hat.
Siehe scoringRules
Eigenschaft von Badging-Regeln.
Bei den meisten Eigenschaften und Werten, insbesondere den Verben, wird zwischen Groß- und Kleinschreibung unterschieden. Verben müssen bei Verwendung in einer Scoring-Unterregel alle UPPERCASE sein.
Wenn die Funktion nicht wie erwartet funktioniert, stellen Sie sicher, dass die Daten korrekt eingegeben wurden.
Mit dem Tutorial "Erste Schritte" Site (engagieren) :
Zugriff auf die CRXDE Lite auf der Autoreninstanz.
Navigieren Sie zur Basisseite:
Fügen Sie die Eigenschaft badgingRules hinzu:
badgingRules
String
/libs/settings/community/badging/rules/forums-badging
ein/libs/settings/community/badging/rules/comments-badging
einFügen Sie die Eigenschaft scoringRules hinzu:
scoringRules
String
/libs/settings/community/scoring/rules/forums-scoring
ein/libs/settings/community/scoring/rules/comments-scoring
einKlicken Sie auf Alle speichern.
Stellen Sie als Nächstes sicher, dass die Forum- und Kommentarkomponenten die Anzeige von Abzeichen zulassen:
Wieder mit CRXDE Lite.
Navigieren Sie zur Forumkomponente .
/content/sites/engage/en/forum/jcr:content/content/primary/forum
Fügen Sie ggf. die boolesche Eigenschaft allowBadges hinzu und stellen Sie sicher, dass sie wahr ist.
allowBadges
Boolean
true
Als Nächstes erneut veröffentlichen die Community-Site.
Abschließend,
Navigieren Sie zur Komponente in der Veröffentlichungsinstanz.
Melden Sie sich als Community-Mitglied an (z. B. : weston.mccall@dodgit.com / password).
Posten Sie ein neues Forumthema.
Die Seite muss aktualisiert werden, damit der Badge angezeigt wird.
Wählen Sie das Forum aus.
Dies sollte dem Community-Mitglied ein Bronzesymbol mit seinem Forumsbeitrag vermitteln, da der erste Schwellenwert der Regel für Forumsabzeichen 1 beträgt.
Weitere Informationen finden Sie unter Grundlagen zu Scoring und Abzeichen für Entwickler.
Informationen zur erweiterten Scoring-Engine finden Sie unter Erweiterte Scoring- und Badges.
Das konfigurierbare Leaderboard component und function vereinfacht die Anzeige von Mitgliedern und deren Ergebnissen auf einer Community-Site.