Grundläggande om poäng och emblem scoring-and-badges-essentials
AEM Communities poäng och badges ger möjlighet att identifiera och belöna communitymedlemmar.
Information om hur du konfigurerar funktionen finns i
Den här sidan innehåller ytterligare teknisk information:
- Så här gör du visa ett märke som bild eller text
- Så här aktiverar du felsökningsloggning
- Så här gör du åtkomst till UGC relaterat till poängsättning och märkning
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
in /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 anges märket Tilldelad att märket tilldelats för ett upparbetat resultat 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:
-
Öppna Adobe Experience Manager Web Console Log Support, till exempel
- http://localhost:4502/system/console/slinglog
-
Välj Add new logger
-
Välj
DEBUG
for Log Level -
Ange ett namn för Log File, till exempel
- logs/scoring-debug.log
-
Ange två Logger (class)-poster (använda
+
ikon)com.adobe.cq.social.scoring
com.adobe.cq.social.badging
-
Välj Save
-
Så här visar du loggposter:
-
Från webbkonsolen
- Under Status meny
- Välj Log Files
- Sök efter loggfilens namn, till exempel
scoring-debug
-
På serverns lokala disk
- Loggfilen är på <server-install-dir>/crx-quickstart/logs/<log-file-name>.log
- Till 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 kan du läsa Community-innehåll och Översikt över lagringsresursprovider.)
Beskrivningarna för att komma åt betygs- och badging-data använder JSRP, eftersom användargenererat innehåll är lätt att komma åt med CRXDE Lite.
JSRP on author: när du experimenterar i redigeringsmiljön resulterar det i användargenererat innehåll som bara är synligt från författarmiljön.
JSRP vid publicering: På samma sätt måste du, om du testar i publiceringsmiljön, ha administratörsbehörighet för en publiceringsinstans i CRXDE Lite. Om publiceringsinstansen körs i produktionsläge (nosampling content runmode), måste du enable 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 den installerade releaser är tillgängliga för utvecklare från Adobe-databasen. Se Använda Maven for Communities: Javadocs.
Platsen och formatet för användargenererat innehåll i databasen kan ändras utan förvarning.
Exempelinställningar example-setup
Skärmbilderna av databasdata kommer från hur du ställer in poängsättning och märkning för ett forum på två olika AEM:
-
En AEM webbplats med ett unikt ID (communitywebbplats skapad med guide):
-
Använda självstudiekursen Komma igång (engagera) som skapats under komma igång, självstudiekurs
-
Hitta forumsidnoden
/content/sites/engage/en/forum/jcr:content
-
Lägga till egenskaper för poängsättning och märkning
-
scoringRules = [/etc/community/scoring/rules/comments-scoring,
/etc/community/scoring/rules/forums-scoring]
-
badgingRules =[/etc/community/badging/rules/comments-scoring,
/etc/community/badging/rules/forums-scoring]
-
-
Hitta 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 Community Components Guide
-
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 = [/etc/community/scoring/rules/comments-scoring, /etc/community/scoring/rules/forums-scoring]
code language-none badgingRules =[/etc/community/badging/rules/comments-scoring, /etc/community/badging/rules/forums-scoring]
-
Hitta 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:
curl -i -X POST -H "Accept:application/json" -u admin:admin -F ":operation=social:assignBadge" -F "badgeContentPath=/etc/community/badging/images/moderator/jcr:content/moderator.png" http://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 detta på det sätt som användaren använder sin forumpost:
-
Poängregelnamnen ska vara globalt unika. de ska inte sluta med samma namn.
Ett exempel på vad not att göra:
/etc/community/scoring/rules/site1/forums-scoring
/etc/community/scoring/rules/site2/forums-scoring -
skapa unika märkesbilder för olika AEM
UGC för åtkomstbedömning access-scoring-ugc
Användning av API:er är att föredra.
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 webbplatsen Geometrixx Engage finns användaren och poängen i en sökväg som är konstruerad med namnet på bedömningsregeln, 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 i en sökväg som konstruerats med namnet på bedömningsregeln, ett standard-ID ( default-site
), ett unikt id och användarens id:
.../scoring/forums-scoring/default-site/b27a17cb4910a9b69fe81fb1b492ba672d2c086e/riley
Ljudspåret 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
Användning av API:er är att föredra.
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/w271Oup2Z4DjnOQrviv/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:
- Ledningsfunktion för att ingå i en community-webbplats eller gruppmall.
- Ledarpanelskomponent, den komponent som finns i Leaderboard-funktionen för att skapa sidor.