Communities-Scoring und -Abzeichen communities-scoring-and-badges

Überblick overview

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:

Hinweis: Das Verteilen von Abzeichen ist standardmäßig nicht aktiviert.

CAUTION
Die in CRXDE Lite sichtbare Implementierungsstruktur kann sich ändern, sobald die Benutzeroberfläche verfügbar ist.

Zeichen badges

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.

Benutzeroberfläche der Badge-Verwaltung badge-management-ui

Mit der Communities 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).

Zugewiesene Abzeichen assigned-badges

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

Zugewiesene (und vergebene) Badges 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 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

    assigned-badges

Ausgegebene Abzeichen awarded-badges

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:

  • Das Abzeichen muss für die Feature-Komponente 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

    zeichen-badges

NOTE
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 Abschnitt Badges zuweisen und widerrufen . Zukünftige Verbesserungen umfassen eine Benutzeroberfläche zur Verwaltung der Abzeichen von Mitgliedern.

Benutzerdefinierte Abzeichen custom-badges

Benutzerdefinierte Badges können mithilfe der Badges Console 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 enable-scoring

Die Auswertung ist standardmäßig nicht aktiviert. Die grundlegenden Schritte zum Einrichten und Aktivieren der Auswertung und Verleihung von Abzeichen sind:

Informationen zum Aktivieren der Scoring-Funktion für eine Community-Site mithilfe der standardmäßigen Scoring- und Badging-Regeln für Foren und Kommentare finden Sie im Abschnitt Schnelltest .

Regeln auf Inhalt anwenden apply-rules-to-content

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 den Typ "cq:Page"(empfohlen) aufweist und dann CRXDE|Lite verwendet, fügen Sie die Eigenschaften seinem Knoten "jcr:content"hinzu.

Eigenschaft
Typ
Beschreibung
badgingRules
Zeichenfolge
eine Array-Liste von Badging-Regeln
scoringRules
Zeichenfolge
eine Array-Liste von Scoring-Regeln
NOTE
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 Rules.

Aktivieren von Abzeichen für Komponenten enable-badges-for-component

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 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 example-allowbadges-for-forum-component-instance

enable-badges-component

NOTE
Jede Komponente kann überlagert werden, um Abzeichen anhand des in Foren, Fragen und Antworten sowie Kommentaren enthaltenen HBS-Codes anzuzeigen.

Bewertungsregeln scoring-rules

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. Zum 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 denselben topic/verb enthalten:

    • Nur die Unterregel aus Regel 2 wirkt sich auf die Punktzahl aus.
    • Die Bewertungen aus beiden Unterregeln werden nicht 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 ihrem jcr:content -Knoten, die die Liste der Unterregeln angeben, die sie definieren.

Die Punktzahl wird im SRP gespeichert.

NOTE
Best Practice: Benennen Sie jede Scoring-Regel eindeutig.
Scoring-Regelnamen sollten global eindeutig sein. Sie sollten nicht mit demselben Namen enden.
Ein Beispiel dafür, was nicht zu tun hat:
/libs/settings/community/scoring/rules/site1/forums-scoring
/libs/settings/community/scoring/rules/site2/forums-scoring

Scoring-Unterregeln scoring-sub-rules

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 dem Mitglied, das eine Aktion durchführt, Punkte zugewiesen, 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 von subject, object und verb. Zum Beispiel:

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

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

Eigenschaft
Typ
Wertbeschreibung
VERB
Long
  • erforderlich; das Verb entspricht einer Ereignisaktion
  • Es muss mindestens eine Verb-Eigenschaft vorhanden sein
  • Das Verb muss in allen GROSSBUCHSTABEN angegeben werden.
  • Es kann mehrere Verb-Eigenschaften geben, aber keine Duplikate.
  • der Wert ist der Wert, der für dieses Ereignis gelten soll
  • der Wert kann positiv oder negativ sein
  • Eine Liste der in der Version unterstützten Verben finden Sie im Abschnitt Themen und Verben .
topics
Zeichenfolge
  • optional; beschränkt die Unterregel auf Community-Komponenten, die nach Ereignisthemen identifiziert werden
  • sofern angegeben: Wert ist eine mehrwertige Zeichenfolge von Ereignisthemen
  • Eine Liste der Themen in der Version finden Sie im Abschnitt Themen und Verben .
  • Die Standardeinstellung ist, auf alle Themen anzuwenden, die mit den Verben verknüpft sind
forOwner
Boolesch
  • optional; nicht relevant, wenn ein Mitglied mit Inhalten handelt, die es besitzt
  • Wenn "true", Bewertung auf den Eigentümer des Inhalts anwenden, auf den reagiert wird
  • Wenn false, Punktzahl auf Teilnehmer anwenden, die eine Aktion durchführen
  • default is false
scoringType
Zeichenfolge
  • optional; gibt die Scoring-Engine an
  • if "basic", gibt die Scoring-Engine auf Basis der Menge an
    • in der Version enthalten
  • Wenn "erweitert", gibt die Scoring-Engine basierend auf Qualität und Menge an
  • Standardwert ist "basic"

Einbezogene Scoring-Regeln und Unterregeln included-scoring-rules-and-sub-rules

In der Version sind zwei Scoring-Regeln für die Forumsfunktion 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/subrules/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 Knoten jcr:content der Regel.

  • sub-rules kann von verschiedenen Scoring-Regeln gemeinsam genutzt werden.

  • rules sollte sich an einem Repository-Speicherort befinden, der für alle Leserechte besitzt.

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

Aktivieren benutzerdefinierter Scoring-Regeln activating-custom-scoring-rules

Ä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-rules

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

  • Bewertungsregel
  • Für die Vergabe eines bestimmten Abzeichens erforderliche Punktzahl

Badging-Regeln sind Knoten des Typs cq:Page mit Eigenschaften auf ihrem jcr:content -Knoten, 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. Zum Beispiel:

  • 1|/libs/settings/community/badging/images/bronze-badge/jcr:content/bronze.png

    • Ein Bronze-Badge wird für einen Punkt verliehen.
  • 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 verliehen.

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

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

NOTE
Best Practice : Erstellen Sie für jede AEM Site eindeutige Badge-Bilder.

badging-rule-configuration

Eigenschaft
Typ
Wertbeschreibung
Schwellenwerte
Zeichenfolge

(erforderlich) Eine mehrwertige Zeichenfolge des Formulars 'number|path'

  • number = Wert
  • | = vertikaler Zeilenchar (U+007C)
  • path = vollständiger Pfad zur Badge-Bild-Ressource

Die Zeichenfolgen müssen so angeordnet sein, dass die Zahlen an Wert zunehmen und zwischen der Zahl und dem Pfad kein Leerzeichen angezeigt wird.
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, finden Sie weitere Informationen unter Erweiterte Scoring- und Abzeichen. Die Standardeinstellung ist "Standard".
scoringRules
Zeichenfolge
(optional) Eine Zeichenfolge mit mehreren Werten, um die Badging-Regel auf die durch die Scoring-Regeln identifizierten Scoring-Ereignisse zu beschränken

Einbezogene Badging-Regeln included-badging-rules

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 weisen den Typ cq:Page auf.

  • rules sollte sich an einem Repository-Speicherort befinden, der für alle Leserechte besitzt.

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

Aktivieren benutzerdefinierter Badging-Regeln activating-custom-badging-rules

Ä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 assign-and-revoke-badges

Kennzeichen können Mitgliedern entweder über die Konsole Mitglieder 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"
Benutzerdefinierter Header, der an den Server übergeben wird (erforderlich)

signin = administrator-id:password
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
Beispiel: /libs/settings/community/badging/images/moderator/jcr:content/moderator.png

member-profile-url = der Endpunkt für das Profil des Mitglieds bei der Veröffentlichung
Beispiel: https://<Server>:<Port>/home/users/community/riley/profile.social.json

NOTE
Die member-profile-url:
  • Kann auf eine Autoreninstanz verweisen, wenn der Tunnel-Dienst aktiviert ist.
  • Kann ein undurchsichtiger, zufälliger Name sein - siehe Sicherheitscheckliste bezüglich der autorisierbaren ID.

Beispiele: examples

Moderatorzeichen zuweisen 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

Verknüpftes Silber-Zeichen sperren 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
NOTE
Die Verwendung von cURL zum Zuweisen und Widerrufen 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 Abzeichen für benutzerdefinierte Komponenten scoring-and-badges-for-custom-components

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 topics-and-verbs

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 eine 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 für jeden topic definierten verbs, der für die Verwendung in Scoring-Unterregeln verfügbar ist.

NOTE
Eine neue boolesche Eigenschaft allowBadges aktiviert/deaktiviert die Anzeige von Abzeichen für eine Komponenteninstanz. Sie kann in aktualisierten Dialogfeldern zur Komponentenbearbeitung über ein Kontrollkästchen mit der Bezeichnung Anzeigemarke konfiguriert werden.

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

Kommentar-Komponente
SocialEvent topic= com/adobe/cq/social/comment

verb
Beschreibung
POST
Mitglied erstellt Kommentare
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 Blog-Artikel
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

Prü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/stimmts

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

Benutzerdefinierte Komponentenereignisse custom-component-events

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

Um die Auswertung zu unterstützen, muss das SocialEvent die Methode getVerb() überschreiben, damit für jeden action ein entsprechendes verb zurückgegeben wird. Die 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 troubleshooting

Abzeichen werden nicht angezeigt badges-are-not-appearing

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 Badges für Komponente aktivieren.

Scoring-Regel hat keine Auswirkung scoring-rule-has-no-effect

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

Typo für Groß-/Kleinschreibung case-sensitive-typo

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 quick-test

Mit der Site Erste Schritte-Tutorial (Interagieren) können Sie schnell versuchen, Scoring und Badging durchzuführen:

  • Auf CRXDE Lite in der Autoreninstanz zugreifen.

  • Navigieren Sie zur Basisseite:

    • /content/sites/engage/en/jcr:content
  • Fügen Sie die Eigenschaft badgingRules hinzu:

    • Name: badgingRules
    • Typ: String
    • Auswählen von Multi
    • Wählen Sie Hinzufügen
    • Geben Sie /libs/settings/community/badging/rules/forums-badging ein
    • Wählen Sie +
    • 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
    • Auswählen von Multi
    • Wählen Sie Hinzufügen
    • Geben Sie /libs/settings/community/scoring/rules/forums-scoring ein
    • Wählen Sie +
    • Geben Sie /libs/settings/community/scoring/rules/comments-scoring ein
    • Wählen Sie OK aus.
  • Klicken Sie auf Alle speichern.

test-scoring-badging

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

test-forum-component

Als Nächstes republish die Community-Site.

Schließlich

  • Navigieren Sie zur Komponente in der Veröffentlichungsinstanz.

  • Melden Sie sich als Community-Mitglied an (z. B. weston.mccall@dodgit.com / Kennwort).

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

bronzebadge

Zusätzliche Informationen additional-information

Weitere Informationen finden Sie auf der Entwickler-Seite Scoring- und Badges-Grundlagen .

Informationen zur erweiterten Scoring-Engine finden Sie unter Erweiterte Scoring- und Badges-Funktion.

Die konfigurierbare Leaderboard-Komponente component und function vereinfacht die Anzeige von Mitgliedern und deren Werten auf einer Community-Site.

recommendation-more-help
81e2cd9d-0789-409d-b87c-2a8ce4f28791