Communities-Scoring und -Abzeichen

Übersicht

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:

• Weisen Sie Badgesten zu, um die Rolle eines Mitglieds in der Community zu identifizieren.

• Grundlegende Vergabe von Badgesto-Mitgliedern, um ihre Teilnahme zu fördern (Menge der erstellten Inhalte).

• Fortgeschrittene Vergabe von Badgesto identifizieren Mitglieder als Experten (Qualität der Inhalte erstellt).

​​Beachten Sie, dass die Vergabe von Badges nicht standardmäßig aktiviert ist.

Zeichen

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.

Abzeichen werden in UGC dahingehend unterschieden, ob sie gemäß den Regeln zugewiesen wurden oder verdient wurden. Derzeit werden zugewiesene Abzeichen als Text und Earned Abzeichen als Bild angezeigt.

Benutzeroberfläche der Badge-Verwaltung

Die Communities Badges-Konsole bietet die Möglichkeit, benutzerdefinierte Abzeichen hinzuzufügen, die für ein Mitglied angezeigt werden können, wenn es eine bestimmte Rolle in der Community spielt (zugewiesen).

Zugewiesene Abzeichen

Rollenbasierte Abzeichen werden von einem Administrator den Community-Mitgliedern basierend auf ihrer Rolle in der Community zugewiesen.

Zugewiesene (und erwartete) Zeichen werden im ausgewählten SRP gespeichert und sind nicht direkt zugänglich. 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 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

  

Ausgezeichnete Abzeichen

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:

• Die Abzeichen müssen für die Funktionskomponente enabled sein.
• Scoring- und Badging-Regeln müssen angewendet auf die Seite (oder den Vorgänger) angewendet werden, auf der die Komponente platziert wird.

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

  

Benutzerdefinierte Abzeichen

Benutzerdefinierte Badges können mit der Badges-Konsole installiert und in Badging-Regeln zugewiesen oder angegeben werden.

Bei der Installation über die Badges-Konsole werden benutzerdefinierte Abzeichen automatisch in die Veröffentlichungsumgebung repliziert.

Scoring aktivieren

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) zu.

• Wenden Sie die Scoring- und Badging-Regeln auf eine Community-Site an.

• Aktivieren Sie Badging für Community-Funktionen.

Lesen Sie den Abschnitt Schnelltest , um die Auswertung für eine Community-Site mithilfe der standardmäßigen Scoring- und Badging-Regeln für Foren und Kommentare zu aktivieren.

Regeln auf Inhalt anwenden

Um Scoring und Badges zu aktivieren, fügen Sie die Eigenschaften 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) ist, fügen Sie mithilfe von CRXDE|Lite die Eigenschaften seinem Knoten jcr:content hinzu.

Aktivieren von Abzeichen für Komponenten

Die Scoring- und Bading-Regeln gelten nur für Instanzen von Komponenten, die das Badging durch Bearbeiten der Komponentenkonfiguration im Authoring-Modus aktiviert haben.

Eine boolesche Eigenschaft allowBadges aktiviert/deaktiviert die Anzeige von Abzeichen für eine Komponenteninstanz. Sie kann im Dialogfeld zur Komponentenbearbeitung für Forum-, QnA- und Kommentarkomponenten über ein Kontrollkästchen mit der Bezeichnung Anzeigemarken konfiguriert werden.

Beispiel : allowBadges für die Instanz der Forum-Komponente

Scoring-Regeln

Scoring-Regeln sind die Grundlage für die Bewertung zum Zweck der Vergabe von Badges.

Jede Scoring-Regel ist ganz einfach 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 dasselbe topic/verb enthalten:

  • Nur die Unterregel aus Regel 2 wirkt sich auf das Ergebnis aus.
  • Die Bewertungen aus beiden Unterregeln werden nicht zusammen hinzugefügt.

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 dem Knoten jcr:content , die die Liste der Unterregeln angeben, die sie definieren.

Die Bewertungen werden im SRP gespeichert.

Scoring-Unterregeln

Die Scoring-Unterregeln enthalten die Eigenschaften, die die Werte für die Teilnahme an der Community detailliert beschreiben.

Jede Scoring-Unterregel identifiziert:

• Welche Aktivitäten werden verfolgt?
• Welche speziellen Community-Funktionen sind betroffen?
• Wie viele Punkte werden vergeben?

Standardmäßig werden Punkte an das Mitglied vergeben, das eine Aktion durchführt, es sei denn, die Unterregel gibt den Eigentümer des Inhalts an, der die Punkte erhält ( forOwner).

Jede Unterregel kann in einer oder mehreren Scoring-Regeln enthalten sein.

Der Name der Unterregel folgt normalerweise dem Muster der Verwendung eines Betreffs , Objekts und Verb. Beispiel:

• member-comment-create
• member-receive-Votum

Unterregeln sind Knoten des Typs cq:Page mit Eigenschaften auf dem Knoten jcr:content, die die Verben und Themen angeben.

Einbezogene Scoring-Regeln und Unterregeln

In der Version sind zwei Scoring-Regeln für die Forumfunktion enthalten (jeweils eine für die Forum- und Kommentarkomponenten der Forumsfunktion):

1. /libs/settings/community/scoring/rules/comments-scoring

   • subRules[] =
     /libs/settings/community/scoring/rules/sub-rules/member-comment-create
     /libs/settings/community/scoring/rules/sub-rules/member-receive-voice
     /libs/settings/community/scoring/rules/sub-rules/member-given-Votum
     /libs/settings/community/scoring/rules/sub-rules/member-is-moderated

2. /libs/settings/community/scoring/rules/forums-scoring

   • subRules[] =
     /libs/settings/community/scoring/rules/sub-rules/member-forum-create
     /libs/settings/community/scoring/rules/sub-rules/member-receive-voice
     /libs/settings/community/scoring/rules/sub-rules/member-given-Votum
     /libs/settings/community/scoring/rules/sub-rules/member-is-moderated

Anmerkungen:

• Die Knoten rules und sub-rules weisen den Typ cq:Page auf.

• subRules ist ein Attribut vom Typ [] String im jcr:content Knoten der Regel.

• sub-rules kann für verschiedene Scoring-Regeln freigegeben werden.

• rules sollte sich in einem Repository-Speicherort mit Leseberechtigung für alle befinden.

  • Regelnamen müssen unabhängig vom Speicherort eindeutig sein.

Aktivieren benutzerdefinierter Scoring-Regeln

Ä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

Badging-Regeln verknüpfen Scoring-Regeln mit Abzeichen, indem Folgendes angegeben wird:

• Scoring-Regel
• Für ein bestimmtes Zeichen erforderliche Punktzahl

Badging-Regeln sind Knoten des Typs cq:Page mit Eigenschaften auf dem Knoten jcr:content , die Scoring-Regeln mit Bewertungen und Abzeichen korrelieren.

Die Badging-Regeln bestehen aus einer obligatorischen thresholds-Eigenschaft, bei der es sich um eine geordnete Liste von Bewertungen handelt, 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

  • Ein Bronze-Badge wird für 1 Punkt erwartet.

• 60|/libs/settings/community/badging/images/silver-badge/jcr:content/silver.png

  • Wenn 60 Punkte gesammelt wurden, wird ein Silberabzeichen vergeben.

• 80|/libs/settings/community/badging/images/gold-badge/jcr:content/gold.png

  • Wenn 80 Punkte gesammelt wurden, wird ein Goldabzeichen erwartet.

Badging-Regeln werden mit Scoring-Regeln gepaart, die bestimmen, wie Punkte gesammelt werden. Siehe Abschnitt Regeln auf Inhalt anwenden.

Die scoringRules-Eigenschaft einer Badging-Regel beschränkt einfach, welche Scoring-Regeln mit dieser Badging-Regel gepaart werden können.

Einbezogene Badging-Regeln

In der Version sind zwei Badging-Regeln enthalten, die den Foren und Kommentar-Scoring-Regeln entsprechen.

• /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 Leseberechtigung für alle befinden.

  • Regelnamen müssen unabhängig vom Speicherort eindeutig sein.

Aktivieren benutzerdefinierter Badging-Regeln

Änderungen oder Ergänzungen an Badging-Regeln oder Bildern, die in der Autorenumgebung vorgenommen werden, müssen in der Veröffentlichungsumgebung installiert werden.

Zuteilen und Entziehen von Abzeichen

Kennzeichen können Mitgliedern entweder über die Mitgliederkonsole oder programmgesteuert über cURL-Befehle zugewiesen werden.

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 signin -F operation -F badge member-profile-url

header = "Accept:application/json" benutzerdefinierte Kopfzeile zum Übergeben an den Server (erforderlich)

signin = administrator-id:password zum Beispiel : admin:admin

operation = ":operation=social:assignBadge" OR ":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

Beispiele:

Moderatorzeichen zuweisen

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

Verknüpftes Silber-Zeichen sperren

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

Scoring und Abzeichen für benutzerdefinierte Komponenten

Scoring- und Badging-Regeln können für benutzerdefinierte Komponenten erstellt werden, indem die für die Komponente erstellten Ereignisthemen Verben zugeordnet werden.

Themen und Verben

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 auf, die für topic auftreten. Das SocialEvent enthält eine Methode, mit der eine mit der Aktion verknüpfte verb zurückgegeben wird. Es gibt eine n-1-Beziehung zwischen actions und verbs.

Für die bereitgestellten Communities-Komponenten beschreiben die folgenden Tabellen die verbs, die für jeden topic definiert sind, der zur Verwendung in Scoring-Unterregeln verfügbar ist.

Calendar
ComponentSocialEvent topic= com/adobe/cq/social/calendar

Kommentare
ComponentSocialEvent topic= com/adobe/cq/social/comment

File Library
ComponentSocialEvent topic= com/adobe/cq/social/fileLibrary

Forum
ComponentSocialEvent topic= com/adobe/cq/social/forum

Journal
ComponentSocialEvent topic= com/adobe/cq/social/journal

QnA
ComponentSocialEvent topic = com/adobe/cq/social/qna

Reviews
ComponentSocialEvent topic= com/adobe/cq/social/review

Bewertung
ComponentSocialEvent topic= com/adobe/cq/social/tally/rating

Voting
ComponentSocialEvent topic= com/adobe/cq/social/tally/stimmte

Moderationsfähige
KomponentenSocialEvent topic= com/adobe/cq/social/moderation

Benutzerdefinierte Komponentenereignisse

Bei einer benutzerdefinierten Komponente wird ein SocialEvent instanziiert, um die Ereignisse der Komponente als actions aufzuzeichnen, die für ein topic auftreten.

Um die Auswertung zu unterstützen, muss das SocialEvent die Methode getVerb() überschreiben, damit für jedes action ein entsprechendes verb zurückgegeben wird. Das für eine Aktion zurückgegebene verb kann eine häufig verwendete (z. B. POST) oder für die Komponente spezialisierte (z. B. ADD RATING) sein. Es gibt eine n-1-Beziehung zwischen actions und verbs.

Fehlerbehebung

Abzeichen werden nicht angezeigt

Wenn Scoring- und Badging-Regeln auf den Inhalt der Website angewendet wurden, Abzeichen jedoch für keine Aktivität erwartet werden, stellen Sie sicher, dass Abzeichen für die Instanz dieser Komponente aktiviert wurden.

Siehe Enable Badges for Component.

Scoring-Regel hat keine Auswirkung

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 die scoringRules-Eigenschaft von Badging Rules.

Groß-/Kleinschreibung

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.

Schnelltest

Mit der Website Erste Schritte-Tutorial (Interagieren) können Sie schnell Scoring und Badging ausprobieren:

• Zugriff auf die CRXDE Lite auf der Autoreninstanz.

• Navigieren Sie zur Basisseite:

  • /content/sites/engage/en/jcr:content

• Fügen Sie die Eigenschaft badgingRules hinzu:

  • Name: badgingRules
  • Typ: String
  • Wählen Sie Multi
  • Wählen Sie Hinzufügen
  • Geben Sie /libs/settings/community/badging/rules/forums-badging ein
  • Wählen Sie nun eine der folgenden Optionen aus +
  • Geben Sie /libs/settings/community/badging/rules/comments-badging ein
  • Wählen Sie OK aus

• Fügen Sie die Eigenschaft scoringRules hinzu:

  • Name: scoringRules
  • Typ: String
  • Wählen Sie Multi
  • Wählen Sie Hinzufügen
  • Geben Sie /libs/settings/community/scoring/rules/forums-scoring ein
  • Wählen Sie nun eine der folgenden Optionen aus +
  • Geben Sie /libs/settings/community/scoring/rules/comments-scoring ein
  • Wählen Sie OK aus

• Wählen Sie Alle speichern aus.

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.

  • Name: allowBadges
  • Typ: Boolean
  • Wert: true

Als Nächstes republish 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.

  • Melden Sie sich ab und melden Sie sich als anderes Community-Mitglied an (z. B.: aaron.mcdonald@mailinator.com/password).

• 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.

Zusätzliche Informationen

Weitere Informationen finden Sie auf der Seite Scoring- und Badges-Grundlagen 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.