Communities Scoring and Badges communities-scoring-and-badges

Ökning overview

AEM Communities poäng och badges ger möjlighet att identifiera och belöna communitymedlemmar.

De viktigaste aspekterna på poängsättning och märkning är:

Obs! Att tilldela emblem är inte aktiverat som standard.

Badges badges

Beteckningar placeras under en medlems namn för att ange antingen deras roll eller deras ställning i communityn. Badges kan antingen visas som en bild eller som ett namn. När namnet visas som en bild inkluderas det som alternativ text för tillgänglighet.

Som standard finns emblem i databasen på följande plats:

Om de lagras på en annan plats bör de vara tillgängliga för alla.

UGC har olika märken oavsett om de har tilldelats eller förvärvats enligt reglerna. För närvarande visas tilldelade märken som text och färdiga märken som en bild.

Användargränssnitt för hantering av emblem badge-management-ui

Med konsolen emblem kan du lägga till egna emblem som kan visas för en medlem när den har tjänats in (tilldelats) eller när de har en specifik roll i communityn (tilldelats).

Tilldelade märken assigned-badges

Rollbaserade märken tilldelas av en administratör till communitymedlemmar baserat på deras roll i communityn.

Tilldelade (och tilldelade) märken lagras i den valda SRP och är inte direkt tillgängliga. Det enda sättet att tilldela rollbaserade emblem är att göra det med kod eller cURL tills ett GUI är tillgängligt. Instruktioner för cURL finns i avsnittet Tilldela och återkalla emblem.

I releasen finns tre rollbaserade märken:

Tilldelade märken awarded-badges

Belöningsbaserade märken delas ut av betygstjänsten till communitymedlemmar baserat på regler som tillämpas på deras verksamhet i communityn.

För att emblem ska visas som en belöning för aktivitet måste två saker hända:

I releasen ingår tre belöningsbaserade märken:

Egna märken custom-badges

Anpassade emblem kan installeras med Badges-konsolen och antingen tilldelas eller anges i badging-regler.

Anpassade märken replikeras automatiskt till publiceringsmiljön när de installeras från badges-konsolen.

Aktivera poängsättning enable-scoring

Poängen är inte aktiverad som standard. De grundläggande stegen för att sätta upp och aktivera poängsättning och tilldelning av märken är:

Gå till avsnittet Snabbtest om du vill aktivera poängsättning för en community-webbplats med standardreglerna för bedömning och märkning av forum och kommentarer.

Använd regler för innehåll apply-rules-to-content

Lägg till egenskaperna scoringRules och badgingRules till en nod i platsens innehållsträd om du vill aktivera poängsättning och emblem.

Om webbplatsen redan är publicerad, efter att du har tillämpat alla regler och aktiverat komponenter, publicerar du om den.

Reglerna som gäller för en komponent som har aktiverats för badging är de som gäller för den aktuella noden eller dess överordnade nod.

Om noden är av typen cq:Page (rekommenderas) lägger du sedan till egenskaperna i noden jcr:content med CRXDE|Lite.

Aktivera emblem för komponent enable-badges-for-component

Poängreglerna och reglerna för radavstånd gäller endast för instanser av komponenter som har aktiverat badging genom att redigera komponentkonfigurationen i redigeringsläget.

En boolesk egenskap, allowBadges, aktiverar/inaktiverar visning av emblem för en komponentinstans. Den kan konfigureras i komponentredigeringsdialogrutan för forum-, QnA- och kommentarskomponenter via en kryssruta med namnet Display Badges.

Exempel: allowBadges för instans av forumkomponent example-allowbadges-for-forum-component-instance

Poängregler scoring-rules

Poängregler är grunden för poängsättning för att dela ut märken.

Varje resultatregel är en lista med en eller flera underlinjer. Poängregler tillämpas på communitywebbplatsinnehållet för att identifiera reglerna som ska gälla när emblem är aktiverade.

Poängregler ärvs men är inte additiva. Till exempel:

Om det finns mer än en resultatregel bevaras poängen separat för varje regel.

Poängregler är noder av typen cq:Page med egenskaper på noden jcr:content som anger listan med underlinjer som definierar den.

Bakgrundsmusik lagras i SRP.

Underregler för poängsättning scoring-sub-rules

Värdena för att delta i communityt är de egenskaper som innehåller poängsättningsundergrupperna.

Varje bedömningsdelpensel identifierar:

Som standard tilldelas poäng till den medlem som utför en åtgärd, såvida inte delpennan anger att ägaren av innehållet tar emot punkterna ( forOwner).

Varje subrul kan ingå i en eller flera poängregler.

Namnet på underpennan följer vanligtvis mönstret för att använda ett ämne, objekt och verb. Till exempel:

Underlinjer är noder av typen cq:Page med egenskaper på noden jcr:content som anger verbs and topics .

Inkluderade poängsättningsregler och underregler included-scoring-rules-and-sub-rules

I releasen finns två poängregler för forumfunktionen (en för respektive forum och kommentarkomponenter för forumfunktionen):

Anteckningar:

Aktivera anpassade poängsättningsregler activating-custom-scoring-rules

Alla ändringar eller tillägg som görs i resultatregler eller underlinjer som görs i redigeringsmiljön måste installeras vid publiceringen.

Märkningsregler badging-rules

Regler för märkning länkar till poängregler genom att ange:

Badging-regler är noder av typen cq:Page med egenskaper på dess jcr:content-nod som korrelerar poängregler till poäng och emblem.

Reglerna för märkning består av en obligatorisk thresholds-egenskap som är en ordnad lista med poäng mappade till emblem. Poängen måste ordnas i högre värde. Till exempel:

Betygsregler kombineras med poängregler, som bestämmer hur poäng ackumuleras. Se avsnittet Använd regler för innehåll.

Egenskapen scoringRules i en badging-regel begränsar helt enkelt vilka poängregler som kan paras med den speciella badging-regeln.

Inkluderade märkningsregler included-badging-rules

I utgåvan finns två märkningsregler som motsvarar Forums- och kommentarsbedömningsreglerna.

Anteckningar:

Aktivera anpassade märkningsregler activating-custom-badging-rules

Alla ändringar eller tillägg som görs i märkningsregler eller bilder som gjorts i redigeringsmiljön måste installeras vid publicering.

Tilldela och återkalla märken assign-and-revoke-badges

Märkningar kan tilldelas medlemmar antingen med medlemskonsolen eller via programmering med cURL-kommandon.

Följande cURL-kommandon visar vad som krävs för en HTTP-begäran om att tilldela och återkalla emblem. Grundformatet är:

cURL -i -X POST -H header -u signin -F operation -F badge member-profile-url

header = "Accept:application/json"
anpassad rubrik som ska skickas till servern (obligatoriskt)

inloggning = administrator-id:password
till exempel admin:admin

operation = ":operation=social:assignBadge" OR ":operation=social:deleteBadge"

badge = "badgeContentPath=badge-image-file"

badge-image-file = platsen för badge-bildfilen i databasen
till exempel /libs/settings/community/badging/images/moderator/jcr:content/moderator.png

member-profile-url = slutpunkten för medlemmens profil vid publicering
till exempel https://<server>:<port>/home/users/community/riley/profile.social.json

Exempel: examples

Tilldela ett moderatormärke 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

Återkalla ett tilldelat silvermärke 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

Betyg och märken för anpassade komponenter scoring-and-badges-for-custom-components

Du kan skapa regler för klassificering och märkning för anpassade komponenter genom att koppla händelseavsnitten som skapats för komponenten till verb.

Ämnen och verb topics-and-verbs

När medlemmar interagerar med communityfunktioner skickas händelser som kan utlösa asynkrona avlyssnare, som meddelanden och poängsättning.

En komponents SocialEvent-instans registrerar händelserna som actions som inträffar för en topic. SocialEvent innehåller en metod för att returnera en verb som är associerad med åtgärden. Det finns en n-1-relation mellan actions och verbs.

För de communitykomponenter som levereras beskrivs verbs som definierats för varje topic som är tillgänglig för användning i poängdelsregler i följande tabeller.

Kalenderkomponent
SocialEvent topic= com/adobe/cq/social/calendar

Kommentarskomponent
SocialEvent topic= com/adobe/cq/social/comment

Filbibliotekskomponent
SocialEvent topic= com/adobe/cq/social/fileLibrary

Forumkomponent
SocialEvent topic= com/adobe/cq/social/forum

Journalkomponent
SocialEvent topic= com/adobe/cq/social/journal

QnA-komponent
SocialEvent topic = com/adobe/cq/social/qna

Granskningskomponent
SocialEvent topic= com/adobe/cq/social/review

Värderingskomponent
SocialEvent topic= com/adobe/cq/social/tally/rating

Röstkomponent
SocialEvent topic= com/adobe/cq/social/tally/voice

Modereringsaktiverade komponenter
SocialEvent topic= com/adobe/cq/social/moderation

Anpassade komponenthändelser custom-component-events

För en anpassad komponent instansieras en SocialEvent för att spela in komponentens händelser som actions som inträffar för en topic.

SocialEvent måste åsidosätta metoden getVerb() så att en lämplig verb returneras för varje action för att stödja poängsättningen. verb som returneras för en åtgärd kan vara en vanlig (t.ex. POST) eller en speciell för komponenten (t.ex. ADD RATING). Det finns en n-1-relation mellan actions och verbs.

Felsökning troubleshooting

Inga märken visas badges-are-not-appearing

Om regler för klassificering och märkning har tillämpats på webbplatsens innehåll, men emblem inte tilldelas för någon aktivitet, kontrollerar du att emblem har aktiverats för komponentens förekomst.

Se Aktivera emblem för komponent.

Poängregeln har ingen effekt scoring-rule-has-no-effect

Om regler för poängsättning och märkning har tillämpats på webbplatsens innehåll, och emblem tilldelas för vissa åtgärder, men inte andra, kontrollerar du att badging-regeln inte har begränsat de poängregler som den gäller för.

Se egenskapen scoringRules i Badging Rules.

Skiftlägeskänslig typo case-sensitive-typo

De flesta egenskaper och värden, särskilt verbet, är skiftlägeskänsliga. Verb måste vara VERSALER när de används i en subpensel.

Om funktionen inte fungerar som förväntat kontrollerar du att data har angetts korrekt.

Snabbtest quick-test

Det går snabbt att testa poängsättning och märkning med hjälp av webbplatsen Komma igång med självstudiekursen (engagera):

Kontrollera sedan att forumkomponenterna och kommentarkomponenterna tillåter att märken visas:

Publicera igen på communitywebbplatsen.

Äntligen

Detta bör göra att communitymedlemmen får ett bronze-märke synligt med sitt foruminlägg eftersom den första tröskeln för forumbadging är ett poäng på 1.

Ytterligare information additional-information

Mer information finns på sidan Värderingsläge och emblem Essentials för utvecklare.

Mer information om den avancerade bedömningsmotorn finns i Avancerade poäng och märken.

Den konfigurerbara huvudpanelen component och function förenklar visningen av medlemmar och deras poäng på en communitywebbplats.