Met de functie AEM Communities scoring en badges kunnen leden van de gemeenschap worden geïdentificeerd en beloond.
De belangrijkste aspecten van scoring en badges zijn:
Wijs een badgesto toe om de rol van een lid in de gemeenschap te identificeren
Basis toekenning van badgesto-leden om hun deelname aan te moedigen (hoeveelheid geschapen inhoud)
Geavanceerde toekenning van badgesto om leden te identificeren als experts (kwaliteit van de inhoud die is gemaakt)
Het vermelden van badges is niet standaard ingeschakeld.
De implementatiestructuur die zichtbaar is in CRXDE Lite, kan worden gewijzigd zodra de interface beschikbaar is.
De badges worden onder de naam van een lid geplaatst om hun rol of hun status in de gemeenschap aan te geven. Badges kunnen als een afbeelding of als een naam worden weergegeven. Wanneer de naam als afbeelding wordt weergegeven, wordt deze opgenomen als alternatieve tekst voor toegankelijkheid.
Standaard bevinden badges zich in de dataopslag op
Als ze op een andere locatie zijn opgeslagen, moeten ze door iedereen toegankelijk worden gelezen.
De badges zijn in de UGC verschillend wat betreft de vraag of zij volgens de regels werden toegewezen of verdiend. Momenteel worden toegewezen badges weergegeven als tekst en worden verdiende badges als een afbeelding weergegeven.
De Gemeenschappen Badges console verstrekt de capaciteit om douanebadges toe te voegen die voor een lid kunnen worden getoond wanneer verdiend (toegekend) of wanneer zij een specifieke rol in de (toegewezen) gemeenschap op zich nemen.
Op rollen gebaseerde badges worden door een beheerder toegewezen aan leden van de community op basis van hun rol in de community.
Toegewezen (en geawade) badges worden opgeslagen in de geselecteerde SRP en zijn niet direct toegankelijk. Totdat een GUI beschikbaar is, is het enige middel om op rol-gebaseerde badges toe te wijzen dit met code of cURL. Voor cURL-instructies raadpleegt u de sectie Badges toewijzen en intrekken.
In de release zijn drie badges op basis van rollen opgenomen:
Moderator
/etc/community/badging/images/moderator/jcr:content/moderator.png
Groepsbeheer
/etc/community/badging/images/group-manager/jcr:content/group-manager.png
Geprivilegiseerd lid
/etc/community/badging/images/privileged-member/jcr:content/privileged-member.png
Op basis van beloningen ontvangen de leden van de gemeenschap een toegangspasje met een score op basis van regels die gelden voor hun activiteiten in de gemeenschap.
Om badges als beloning voor activiteit te kunnen weergeven, moeten er twee dingen gebeuren:
De release bevat drie beloningsbadges:
Goud
/etc/community/badging/images/gold-badge/jcr:content/gold.png
Zilver
/etc/community/badging/images/silver-badge/jcr:content/silver.png
Brons
/etc/community/badging/images/bronze-badge/jcr:content/bronze.png
Scoreregels kunnen worden geconfigureerd om negatieve punten toe te wijzen voor posten die als onjuist zijn gemarkeerd en beïnvloeden zo de score. Als een badge echter eenmaal is behaald, wordt deze niet automatisch verwijderd vanwege wijzigingen in de score- of scoringregel.
Toegewezen badges kunnen op dezelfde wijze worden ingetrokken als toegewezen badges. Zie de sectie Badges toewijzen en intrekken. De toekomstige verbeteringen zullen een UI omvatten om de badges van leden te beheren.
Aangepaste badges kunnen worden geïnstalleerd met de Badges-console en worden toegewezen aan of opgegeven in badgingregels.
Wanneer deze vanaf de Badges-console zijn geïnstalleerd, worden aangepaste badges automatisch naar de publicatieomgeving gerepliceerd.
Scores is niet standaard ingeschakeld. De basisstappen voor het opzetten en mogelijk maken van scoring en toekenning van badges zijn:
Regels identificeren voor het verdienen van punten (scoring regels)
Wijs badges (badgregels) toe voor punten die volgens scoringregels zijn geaccumuleerd.
De regels voor scoring en badges toepassen op een gemeenschapssite
Zie de sectie Snelle test om het scoren voor een gemeenschapssite in te schakelen met de standaardregels voor scoring en badging voor forums en opmerkingen.
Als u scoring en badges wilt inschakelen, voegt u de eigenschappen scoringRules
en badgingRules
toe aan een willekeurig knooppunt in de inhoudsstructuur voor de site.
Als de site al is gepubliceerd nadat alle regels zijn toegepast en componenten zijn ingeschakeld, publiceert u de site opnieuw.
De regels die op een badging-toegelaten component van toepassing zijn zijn die voor de huidige knoop of zijn voorvader.
Als het knooppunt van het type cq:Page
(aanbevolen) is, voegt u met behulp van CRXDE|Lite de eigenschappen toe aan het jcr:content
knooppunt.
Eigenschap | Type | Beschrijving |
---|---|---|
badgingRules | Tekenreeks[] | een arraylijst met badging rules |
scoringRules | Tekenreeks[] | een arraylijst met scoringregels |
Als een het scoren regel geen effect op het verlenen van badges lijkt te hebben, zorg ervoor de het scoren regel niet door het scoringRules bezit van de merkingsregel is geblokkeerd. Zie de sectie Badging Rules.
De het scoren en het inkleuren regels zijn in feite slechts voor instanties van componenten die merkings door de componentenconfiguratie in auteurswijze te uitgeven hebben toegelaten.
Een booleaanse eigenschap, allowBadges
, schakelt de weergave van badges voor een componentinstantie in of uit. Het is configureerbaar in component uitgeeft dialoog voor forum, QnA en commentaarcomponenten door een checkbox geëtiketteerd de Badges van de Vertoning.
Elke component kan worden bedekt om badges weer te geven met behulp van de GB-code in forums, QnA en opmerkingen als voorbeeld.
Scoreregels vormen de basis voor scoring met het oog op het toekennen van badges.
Heel eenvoudig, is elke het scoren regel een lijst van één of meerdere sub-regels. Scoreregels worden toegepast op de inhoud van de communautaire plaats om de regels te identificeren om toe te passen wanneer de badges worden toegelaten.
Scoreregels worden overgeërfd, maar niet additief. Bijvoorbeeld:
Als page2 het schrapen regel2 bevat en zijn voorouder page1 het schrapen regel1 bevat
Een actie op een page2 component zal zowel rule1 als rule2 aanhalen
Indien beide regels toepasselijke subregels voor dezelfde topic/verb
bevatten:
Wanneer er meer dan één scoreregel is, worden de scores afzonderlijk gehandhaafd voor elke regel.
Scoreregels zijn knooppunten van het type cq:Page
met eigenschappen op zijn jcr:content
knooppunt die de lijst van subregels specificeren die het bepalen.
Scores worden opgeslagen in SRP.
Beste praktijken: Geef elke scoreregel een unieke naam.
Namen van scoreregelregels moeten globaal uniek zijn. ze mogen niet met dezelfde naam eindigen.
Een voorbeeld van wat not moet doen:
/etc/community/scoring/rules/site1/forums-scoring
/etc/community/scoring/rules/site2/forums-scoring
De scoringsubregels bevatten de eigenschappen die de waarden voor deelname aan de gemeenschap in detail beschrijven.
Elke scoring-subregel identificeert
Standaard worden punten toegewezen aan het lid dat de handeling uitvoert, tenzij de subregel de eigenaar van de inhoud opgeeft als ontvangende punten ( forOwner
).
Elke subregel kan in een of meer scoreregels worden opgenomen.
De naam van de subregel volgt doorgaans het patroon van het gebruik van een onderwerp, object en werkb. Bijvoorbeeld:
Subregels zijn knooppunten van het type cq:Page
met eigenschappen op zijn jcr:content
knooppunt die werkwoorden en onderwerpen specificeren.
Eigenschap | Type | Waarde Beschrijving |
---|---|---|
VERB |
Lang |
|
topics |
Tekenreeks[] |
|
forOwner |
Boolean |
|
scoringType |
Tekenreeks |
|
In de release zijn twee scoreregels opgenomen voor de functie Forum Function (een voor de componenten Forum en Comments van de functie Forum):
/etc/community/scoring/rules/comments-scoring
subRules[] =
/etc/community/scoring/rules/sub-rules/member-comment-create
/etc/community/scoring/rules/sub-rules/member-receive-voice
/etc/community/scoring/rules/sub-rules/member-giving-voice
/etc/community/scoring/rules/sub-rules/member-is-moderated
/etc/community/scoring/rules/forums-scoring
subRules[] =
/etc/community/scoring/rules/sub-rules/member-forum-create
/etc/community/scoring/rules/sub-rules/member-receive-voice
/etc/community/scoring/rules/sub-rules/member-giving-voice
/etc/community/scoring/rules/sub-rules/member-is-moderated
Opmerkingen:
Zowel rules
als sub-rules
knooppunten zijn van het type cq:Page
subRules
is een attribuut van type [] Stringon de jcr:content
knoop van de regel
sub-rules
kunnen worden gedeeld door verschillende scoreregels
rules
moet zich bevinden op een opslagplaats met leesmachtigingen voor iedereen
Wijzigingen of toevoegingen aan de in de ontwerpomgeving aangebrachte scoreregels of subregels moeten bij publicatie worden geïnstalleerd.
De regels van de Badging koppelen het scoring regels aan badges door te specificeren:
Badgingregels zijn knooppunten van het type cq:Page
met eigenschappen op het jcr:content
knooppunt dat de correlatiereisen aan scores en badges bevat.
De regels voor badging bestaan uit een verplichte thresholds
eigenschap die een geordende lijst is met scores die zijn toegewezen aan badges. De scores moeten in stijgende waarde worden bevolen. Bijvoorbeeld:
1|/etc/community/badging/images/bronze-badge/jcr:content/bronze.png
60|/etc/community/badging/images/silver-badge/jcr:content/silver.png
80|/etc/community/badging/images/gold-badge/jcr:content/gold.png
De regels van de Badging zijn gepareerd met het scoring regels, die bepalen hoe de punten zich ophopen. Zie de sectie Regels toepassen op inhoud.
Het scoringRules
bezit op een merkingsregel beperkt eenvoudig welke het schrapen regels met die bepaalde merkingsregel kunnen worden geparineerd.
Beste praktijken: maak badge-afbeeldingen die uniek zijn voor elke AEM site.
Eigenschap | Type | Waarde Beschrijving |
---|---|---|
drempelwaarden | Tekenreeks[] | (vereist) Een tekenreeks met meerdere waarden in de notatie 'number|path'
Voorbeeld: 80|/etc/community/badging/images/gold-badge/jcr:content/gold.png |
badgingType | Tekenreeks | (optioneel) Hiermee wordt de scoring-engine aangeduid als "basic" of "advanced". Zie Geavanceerde scores en Badges als u de geavanceerde scoring-engine wilt gebruiken. De standaardwaarde is "basic". |
scoringRules |
Tekenreeks[] | (optioneel) Een tekenreeks met meerdere waarden waarmee de merkingsregel wordt beperkt tot het scoren van gebeurtenissen die door de scoreregels worden geïdentificeerd |
In de release zijn twee Badging Rules opgenomen die overeenkomen met de Forums and Comments Scoring Rules.
Opmerkingen:
rules
knooppunten zijn van het type cq:Page
rules
moet zich bevinden op een opslagplaats met leesmachtigingen voor iedereen
Wijzigingen of toevoegingen aan badgingregels of afbeeldingen die in de ontwerpomgeving zijn aangebracht, moeten bij publicatie worden geïnstalleerd.
Badges kunnen aan leden worden toegewezen met behulp van de ledenconsole of via programmacode met behulp van cURL-opdrachten.
De volgende cURL-opdrachten tonen wat nodig is voor een HTTP-aanvraag voor het toewijzen en intrekken van badges. De basisindeling is:
cURL -i -X POST -H header -u *signin * -F *operation * -F *badge * member-profile-url
header = "Accept:application/json"
aangepaste header die aan de server moet worden doorgegeven (vereist)
sign = administrator-id:password
bijvoorbeeld: admin:admin
operation = ":operation=social:assignBadge" OF ":operation=social:deleteBadge"
badge = "badgeContentPath=badge-image-file"
badge-image-file = de locatie van het afbeeldingsbestand van de badge in de opslagplaats
bijvoorbeeld: /etc/community/badging/images/moderator/jcr:content/moderator.png
member-profile-url = het eindpunt voor het profiel van het lid bij publiceren
bijvoorbeeld: https://<server>:<port>/home/users/community/riley/profile.social.json
De member-profile-url
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" /home/users/community/updcs9DndLEI74DB9zsB/profile.social.json
curl -i -X POST -H "Accept:application/json" -u admin:admin -F ":operation=social:deleteBadge" -F "badgeContentPath=/etc/community/badging/images/silver/jcr:content/silver.png" /home/users/community/updcs9DndLEI74DB9zsB/profile.social.json
Het gebruik van cURL om badges toe te wijzen en in te trekken werkt voor elke badge-afbeelding, maar als deze is toegewezen in plaats van verdiend, worden ze gemarkeerd als toegewezen badges en dienovereenkomstig afgehandeld.
Het scoren en het merkteken de regels kunnen voor douanecomponenten worden gecreeerd door de gebeurtenisonderwerpen te associëren die voor de component met werkwoorden worden gecreeerd.
Wanneer leden communiceren met functies van gemeenschappen, worden gebeurtenissen verzonden die asynchrone listeners, zoals meldingen en scoring, kunnen activeren.
De instantie SocialEvent van een component registreert de gebeurtenissen als actions
die voor topic
voorkomen. De SocialEvent bevat een methode om een verb
te retourneren die aan de handeling is gekoppeld. Er is een n-1 verhouding tussen actions
en verbs
.
Voor de geleverde communitycomponenten, beschrijven de volgende tabellen verbs
gedefinieerd voor elke topic
beschikbaar voor gebruik in scoring subrules.
Een nieuwe booleaanse eigenschap, allowBadges
, schakelt de weergave van badges voor een componentinstantie in of uit. Het zal configureerbaar in bijgewerkte component geven dialoogvensters door een checkbox geëtiketteerd de Badges van de Vertoning zijn.
Agenda
ComponentSocialEvent topic
= com/adobe/cq/social/agenda
Verb | Beschrijving |
---|---|
POST | lid maakt een agendagebeurtenis |
TOEVOEGEN | opmerkingen van leden over een agendagebeurtenis |
BIJWERKEN | agendagebeurtenis of commentaar van lid wordt bewerkt |
DELETE | agendagebeurtenis of commentaar van lid wordt verwijderd |
Opmerkingen
ComponentSocialEvent topic
= com/adobe/cq/social/comment
Verb | Beschrijving |
---|---|
POST | lid maakt een opmerking |
TOEVOEGEN | reactie van lid op opmerking |
BIJWERKEN | commentaar van lid is bewerkt |
DELETE | commentaar van lid is verwijderd |
File Library
ComponentSocialEvent topic
= com/adobe/cq/social/fileLibrary
Verb | Beschrijving |
---|---|
POST | lid maakt een map |
ATTACH | lid uploadt een bestand |
BIJWERKEN | lid werkt een map of bestand bij |
DELETE | lid verwijdert een map of bestand |
Forum
ComponentSocialEvent topic
= com/adobe/cq/social/forum
Verb | Beschrijving |
---|---|
POST | lid maakt forum-onderwerp |
TOEVOEGEN | reacties van leden op forum onderwerp |
BIJWERKEN | onderwerp of antwoord van lid wordt bewerkt |
DELETE | forumonderwerp of antwoord van lid wordt verwijderd |
Journal
ComponentSocialEvent topic
= com/adobe/cq/social/Journal
Verb | Beschrijving |
---|---|
POST | lid maakt een blogartikel |
TOEVOEGEN | commentaar van leden op blogartikel |
BIJWERKEN | blogartikel of commentaar van lid wordt bewerkt |
DELETE | blogartikel of commentaar van lid is verwijderd |
QnA
ComponentSocialEvent topic
= com/adobe/cq/social/qna
Verb | Beschrijving |
---|---|
POST | lid maakt een QnA-vraag |
TOEVOEGEN | lid maakt een QnA-antwoord |
BIJWERKEN | Vraag of antwoord van lid wordt bewerkt |
SELECT | het antwoord van lid is geselecteerd |
SELECTEREN OPHEFFEN | het antwoord van het lid is gedeselecteerd |
DELETE | Vraag of antwoord van lid wordt verwijderd |
Reviews
ComponentSocialEvent topic
= com/adobe/cq/social/review
Verb | Beschrijving |
---|---|
POST | lid maakt beoordeling |
BIJWERKEN | beoordeling door lid wordt bewerkt |
DELETE | beoordeling door lid is verwijderd |
Classificatie
ComponentSocialEvent topic
= com/adobe/cq/social/tally/rating
Verb | Beschrijving |
---|---|
WAARDERING TOEVOEGEN | de inhoud van het lid is opgegeven |
RATING VERWIJDEREN | de inhoud van het lid is neergezet |
Stemmen
ComponentSocialEvent topic
= com/adobe/cq/social/tally/steming
Verb | Beschrijving |
---|---|
STEMMING TOEVOEGEN | de inhoud van het lid is in stemming gebracht |
STEMMING VERWIJDEREN | over de inhoud van het lid is gestemd |
Moderation-enabled
ComponentsSocialEvent topic
= com/adobe/cq/social/moderation
Verb | Beschrijving |
---|---|
DENKEN | inhoud van lid wordt geweigerd |
VLAG ALS ONJUIST | inhoud van lid is gemarkeerd |
ONGESCHIKTE LAG ALS ONJUIST | inhoud van lid is ongemarkeerd |
ACCEPTEREN | de inhoud van het lid wordt goedgekeurd door moderator |
SLUITEN | lid sluit commentaar op bewerkingen en reacties |
OPENEN | opmerking opnieuw openen lid |
Voor een douanecomponent, wordt een SocialEvent geconcretiseerd om de gebeurtenissen van de component als actions
te registreren die voor topic
voorkomen.
Ter ondersteuning van scoring moet de SocialEvent de methode getVerb()
overschrijven, zodat een geschikte verb
wordt geretourneerd voor elke action
. De verb
die voor een handeling wordt geretourneerd, kan een handeling zijn die veel wordt gebruikt (zoals POST
) of een instructie die is gespecialiseerd voor de component (zoals ADD RATING
). Er is een n-1 verhouding tussen actions
en verbs
.
Als op de inhoud van de website wel scoring- en badingregels zijn toegepast, maar er geen badges worden gereserveerd voor enige activiteit, moet u ervoor zorgen dat badges zijn ingeschakeld voor de instantie van die component.
Zie Badges inschakelen voor component.
Als op de inhoud van de website scoring- en badingregels zijn toegepast en badges worden toegekend voor bepaalde acties, maar niet voor andere, controleert u of de regel voor badging de scoringregels waarop deze van toepassing is, niet heeft beperkt.
Zie de scoringRules
eigenschap van Badging Rules.
De meeste eigenschappen en waarden, met name de werkwoorden, zijn hoofdlettergevoelig. Bij gebruik in een scoringsubregel moeten de hoekpunten allemaal HOOFDLETTERS zijn.
Als de functie niet naar behoren werkt, controleert u of de gegevens correct zijn ingevoerd.
Het is mogelijk om snel scoring en badging te proberen met behulp van de Aan de slag-zelfstudie-site (engageren):
CRXDE Lite benaderen bij auteur
Blader naar de basispagina:
Voeg de eigenschap badgingRules toe:
badgingRules
String
/etc/community/badging/rules/forums-badging
invoeren+
/etc/community/badging/rules/comments-badging
invoerenVoeg de eigenschap scoringRules toe:
scoringRules
String
/etc/community/scoring/rules/forums-scoring
invoeren+
/etc/community/scoring/rules/comments-scoring
invoerenSelecteer Save All
Zorg er daarna voor dat de forum- en commentaarcomponenten het weergeven van badges toestaan:
Opnieuw CRXDE Lite gebruiken
Bladeren naar de forumcomponent
/content/sites/engage/en/forum/jcr:content/content/primary/forum
Voeg de Booleaanse eigenschap allowBadges toe, indien nodig, en zorg ervoor dat dit waar is
allowBadges
Boolean
true
Vervolgens kunt u de communitysite opnieuw publiceren.
Tot slot:
Bladeren naar de component in de publicatie-instantie
Aanmelden als lid van de gemeenschap (bijvoorbeeld: weston.mccall@dodgit.com/password)
Plaats een nieuw forumonderwerp
De badge wordt alleen weergegeven als de pagina is vernieuwd
Selecteer het forum
Dit zou het lid van de gemeenschap een bronzen badge moeten verdienen die met hun forumpost zichtbaar is omdat de eerste drempel van de forums-badging regel een score van 1 is.
Meer informatie vindt u op de pagina Scoring and Badges Essentials voor ontwikkelaars.
Zie Geavanceerde scores en Badges voor informatie over de geavanceerde scoring-engine.
Het configureerbare Leaderboard component en function vereenvoudigt de weergave van leden en hun scores op een communitysite.