Grundläggande om poäng och emblem scoring-and-badges-essentials
AEM Communities poäng och brickor identifierar och belönar communitymedlemmar.
Information om hur du konfigurerar funktionen finns i
Den här sidan innehåller ytterligare teknisk information:
- Visa ett märke som bild eller text
- Så här aktiverar du omfattande felsökningsloggning
- Så här får du åtkomst till UGC för poäng och badging
Visar emblem displaying-badges
Om ett märke visas som text eller bild styrs på klientsidan i HBS-mallen.
Sök till exempel efter this.isAssigned
i /libs/social/forum/components/hbs/topic/list-item.hbs
:
{{#each author.badges}}
{{#if this.isAssigned}}
<div class="scf-badge-text">
{{this.title}}
</div>
{{/if}}
{{/each}}
{{#each author.badges}}
{{#unless this.isAssigned}}
<img class="scf-badge-image" alt="{{this.title}}" title="{{this.title}}" src="{{this.imageUrl}}" />
{{/unless}}
{{/each}}
Om värdet är true anger isAssigned
att märket har tilldelats en roll och att märket ska visas som text.
Om värdet är false anger isAssigned
att märket har tilldelats för ett upparbetat poäng och att märket ska visas som en bild.
Alla ändringar av detta beteende bör göras i ett anpassat skript (antingen åsidosätt eller övertäckning). Se Anpassning på klientsidan.
Felsökningslogg för poängsättning och märkning debug-log-for-scoring-and-badging
En anpassad loggfil kan konfigureras för felsökning av poängsättning och badging. Innehållet i loggfilen kan sedan tillhandahållas kundsupporten om problem uppstår med funktionen.
Detaljerade instruktioner finns på Skapa en anpassad loggfil.
Så här konfigurerar du snabbt en slinglog-fil:
-
Få åtkomst till loggstödet för Adobe Experience Manager Web Console, till exempel
- https://localhost:4502/system/console/slinglog
-
Välj Lägg till ny loggare
-
Välj
DEBUG
för Loggnivå -
Ange ett namn för loggfilen, till exempel
- logs/scoring-debug.log
-
Ange två Logger-poster (klass) (med ikonen
+
)com.adobe.cq.social.scoring
com.adobe.cq.social.badging
-
Välj Spara
-
Så här visar du loggposter:
-
Från webbkonsolen
- Under menyn Status
- Välj Loggfiler
- Sök efter loggfilens namn, till exempel
scoring-debug
-
På serverns lokala disk
-
Loggfilen finns på <server-install-dir>/crx-quickstart/logs/<log-file-name>.log
-
Exempel:
.../crx-quickstart/logs/scoring-debug.log
-
UGC för poängsättning och märkning ugc-for-scoring-and-badging
Det går att visa användargenererat innehåll som är relaterat till poängsättning och märkning när den valda SRP är antingen JSRP eller MSRP, men inte ASRP. (Om du inte känner till dessa termer läser du Community Content Storage och Storage Resource Provider Overview.)
Beskrivningarna för att komma åt betygs- och badging-data använder JSRP, eftersom UGC är lätt att komma åt med CRXDE Lite.
JSRP på författare: Om du experimenterar i författarmiljön resulterar det i UGC som bara är synligt från författarmiljön.
JSRP vid publicering: Om du testar i publiceringsmiljön måste du även ha administratörsbehörighet för en publiceringsinstans i CRXDE Lite. Om publiceringsinstansen körs i produktionsläge (noSampleContent Run Mode) måste du aktivera CRXDE Lite.
Basplatsen för UGC på JSRP är /content/usergenerated/asi/jcr/
.
API:er för klassificering och märkning scoring-and-badging-apis
Följande API:er kan användas:
De senaste Javadocs-filerna för det installerade funktionspaketet är tillgängliga för utvecklare från Adobe-databasen. Se Använda Maven för Communities: Javadocs.
Platsen och formatet för användargenererat innehåll i databasen kan ändras utan varning.
Exempelinställningar example-setup
Skärmbilder av databasdata kommer från konfiguration av poängsättning och märkning för ett forum på två olika AEM:
-
En AEM med ett unikt ID (communitywebbplatsen har skapats med guiden):
-
Använda självstudiekursen Komma igång (engagerande) som skapades under självstudiekursen Komma igång
-
Hitta forumsidnoden
/content/sites/engage/en/forum/jcr:content
-
Lägga till egenskaper för poängsättning och märkning
code language-none scoringRules = [/libs/settings/community/scoring/rules/comments-scoring, /libs/settings/community/scoring/rules/forums-scoring]
code language-none badgingRules =[/libs/settings/community/badging/rules/comments-scoring, /libs/settings/community/badging/rules/forums-scoring]
-
Leta reda på forumkomponentnoden
/content/sites/engage/en/forum/jcr:content/content/primary/forum
(sling:resourceType = social/forum/components/hbs/forum
) -
Lägg till egenskap för att visa emblem
allowBadges = true
-
En användare loggar in, skapar ett forumämne och tilldelas ett bronze-märke
-
-
En AEM utan ett unikt ID:
-
Använda guiden Community Components
-
Hitta forumsidnoden
/content/community-components/en/forum/jcr:content
-
Lägga till egenskaper för poängsättning och märkning
code language-none scoringRules = [/libs/settings/community/scoring/rules/comments-scoring, /libs/settings/community/scoring/rules/forums-scoring]
code language-none badgingRules =[/libs/settings/community/badging/rules/comments-badging, /libs/settings/community/badging/rules/forums-badging]
-
Leta reda på forumkomponentnoden
/content/community-components/en/forum/jcr:content/content/forum
(sling:resourceType = social/forum/components/hbs/forum
) -
Lägg till egenskap för att visa emblem
allowBadges = true
-
En användare loggar in, skapar ett forumämne och tilldelas ett bronze-märke
-
-
En användare tilldelas ett moderatormärke med cURL:
code language-shell 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" https://localhost:4503/home/users/community/w271OOup2Z4DjnOQrviv/profile.social.json
När en användare har fått två bronze-märken och tilldelats ett moderatormärke visas användaren med sitt foruminlägg på följande sätt:
-
Poängregelnamn ska vara globalt unika. De får inte sluta med samma namn.
Ett exempel på vad inte ska göra:
/libs/settings/community/scoring/rules/site1/forums-scoring
/libs/settings/community/scoring/rules/site2/forums-scoring -
Skapa unika märkesbilder för olika AEM
UGC för åtkomstbedömning access-scoring-ugc
Du bör använda API:erna.
I undersökningssyfte, till exempel med JSRP, är baskamappen som innehåller poäng
/content/usergenerated/asi/jcr/scoring
Den underordnade noden för scoring
är resultatregelns namn. Det bästa sättet är alltså att betygsregelnamn på en server är globalt unika.
För Geometrixx Engage-webbplatsen är användaren, och poängen för den, i en sökväg som konstruerats med resultatregelnamnet, webbplatsens webbplats-ID ( engage-ba81p
), ett unikt ID och användarens ID:
.../scoring/forums-scoring/engage-ba81p/6d179715c0e93cb2b20886aa0434ca9b5a540401/riley
För stödwebbplatsen för Community Components finns användaren, och poängen för den, i en sökväg som konstruerats med bedömningsregelnamnet, ett standard-ID ( default-site
), ett unikt ID och användarens ID:
.../scoring/forums-scoring/default-site/b27a17cb4910a9b69fe81fb1b492ba672d2c086e/riley
Poängen lagras i egenskapen scoreValue_tl
som bara kan innehålla ett värde eller indirekt referera till en atomicCounter.
Access Badging UGC access-badging-ugc
Du bör använda API:erna.
I undersökningssyfte, till exempel med JSRP, är baskappen som innehåller information om tilldelade eller tilldelade märken
/content/usergenerated/asi/jcr
Följs av sökvägen till användarens profil och avslutas i en badges-mapp, till exempel:
/home/users/community/w271OOup2Z4DjnOQrviv/profile/badges
Tilldelad bricka awarded-badge
Tilldelat märke assigned-badge
Ytterligare information additional-information
Så här visar du en sorterad lista med medlemmar baserat på punkter:
- Ledarpanelsfunktion för inkludering i en community-webbplats eller gruppmall.
- Ledarpanelskomponent, den aktuella komponenten i Leaderboard-funktionen, för sidredigering.