커뮤니티 점수 및 배지 communities-scoring-and-badges
개요 overview
AEM Communities 점수 및 배지 기능은 커뮤니티 구성원을 식별하고 보상하는 기능을 제공합니다.
채점 및 배지의 주요 측면은 다음과 같습니다.
참고 배지의 수여가 기본적으로 활성화되지 않았습니다.
배지 badges
회원들의 역할 또는 지역사회에서의 지위를 나타내기 위해 회원 이름 아래에 배지를 배치합니다. 배지는 이미지 또는 이름으로 표시될 수 있습니다. 이미지로 표시되는 경우 이 이름은 접근성을 위해 대체 텍스트로 포함됩니다.
기본적으로 배지는 저장소의 다음 위치에 있습니다.
/libs/settings/community/badging/images
다른 위치에 저장되는 경우 모든 사용자가 읽을 수 있어야 합니다.
배지는 UGC에서 규칙에 따라 할당되었는지 혹은 습득되었는지에 따라 차별화된다. 현재 할당된 배지는 텍스트로 표시되고 획득한 배지는 이미지로 표시됩니다.
배지 관리 UI badge-management-ui
커뮤니티 배지 콘솔을(를) 사용하면 회원들이 획득(낙찰)하거나 커뮤니티에서 특정 역할(할당)을 수행할 때 회원에게 표시할 수 있는 사용자 지정 배지를 추가할 수 있습니다.
할당된 배지 assigned-badges
역할 기반 배지는 관리자가 커뮤니티에서의 역할에 따라 커뮤니티 구성원에게 할당합니다.
할당된(및 부여된) 배지는 선택한 SRP에 저장되며 직접 액세스할 수 없습니다. GUI를 사용할 수 있을 때까지 역할 기반 배지를 할당하는 유일한 방법은 코드 또는 cURL을 사용하는 것입니다. cURL 지침은 배지 할당 및 해지 섹션을 참조하십시오.
릴리스에는 다음과 같은 세 가지 역할 기반 배지가 포함되어 있습니다.
-
중재자
/libs/settings/community/badging/images/moderator/jcr:content/moderator.png
-
그룹 관리자
/libs/settings/community/badging/images/group-manager/jcr:content/group-manager.png
-
권한이 있는 구성원
/libs/settings/community/badging/images/privileged-member/jcr:content/privileged-member.png
수여된 배지 awarded-badges
리워드 기반 배지는 커뮤니티 활동에서 적용된 규칙에 따라 커뮤니티 구성원에게 채점 서비스에서 부여됩니다.
배지가 활동에 대한 보상으로 나타나려면 다음 두 가지 상황이 발생해야 합니다.
이번 릴리스에는 3가지 보상 기반 배지가 포함됐다.
-
골드
/libs/settings/community/badging/images/gold-badge/jcr:content/gold.png
-
실버
/libs/settings/community/badging/images/silver-badge/jcr:content/silver.png
-
브론즈
/libs/settings/community/badging/images/bronze-badge/jcr:content/bronze.png
사용자 정의 배지 custom-badges
사용자 지정 배지는 배지 콘솔을 사용하여 설치하고 배지 규칙에 할당되거나 지정할 수 있습니다.
배지 콘솔에서 설치하면 사용자 지정 배지가 게시 환경에 자동으로 복제됩니다.
채점 활성화 enable-scoring
채점은 기본적으로 활성화되어 있지 않습니다. 채점 및 배지 수여를 설정하고 활성화하는 기본 단계는 다음과 같습니다.
-
점수를 얻기 위한 규칙을 식별합니다(점수 규칙).
포럼 및 댓글에 대한 기본 채점 및 배지 규칙을 사용하여 커뮤니티 사이트에 대한 채점을 활성화하려면 빠른 테스트 섹션을 참조하십시오.
콘텐츠에 규칙 적용 apply-rules-to-content
채점 및 배지를 사용하려면 사이트의 콘텐츠 트리에 있는 노드에 속성 scoringRules
및 badgingRules
을(를) 추가하십시오.
사이트가 이미 게시된 경우 모든 규칙을 적용하고 구성 요소를 활성화한 후 사이트를 다시 게시합니다.
배지 활성화 구성 요소에 적용되는 규칙은 현재 노드 또는 해당 상위 요소에 대한 규칙입니다.
노드가 cq:Page
(권장) 유형인 경우 CRXDE|Lite를 사용하여 해당 jcr:content
노드에 속성을 추가하십시오.
구성 요소에 대한 배지 활성화 enable-badges-for-component
채점 및 배지 규칙은 작성 모드에서 구성 요소 구성을 편집하여 배지를 사용하도록 설정한 구성 요소 인스턴스에만 적용됩니다.
부울 속성 allowBadges
은(는) 구성 요소 인스턴스에 대한 배지 표시를 활성화/비활성화합니다. 배지 표시 확인란을 통해 포럼, QnA 및 댓글 구성 요소에 대한 구성 요소 편집 대화 상자에서 구성할 수 있습니다.
예 : 포럼 구성 요소 인스턴스에 대한 allowBadges example-allowbadges-for-forum-component-instance
채점 규칙 scoring-rules
채점 규칙은 배지를 수여하기 위한 채점의 기초입니다.
각 채점 규칙은 하나 이상의 하위 규칙 목록입니다. 채점 규칙은 커뮤니티 사이트 콘텐츠에 적용되어 배지가 활성화될 때 적용할 규칙을 식별합니다.
채점 규칙은 상속되지만 가산되지는 않습니다. 예:
-
page2에 채점 규칙2가 포함되어 있고 상위 page1에 채점 규칙1이 포함된 경우.
-
page2 구성 요소에 대한 작업은 rule1과 rule2를 모두 호출합니다.
-
두 규칙 모두에 동일한
topic/verb
에 적용 가능한 하위 규칙이 포함되어 있는 경우:- rule2의 하위 규칙만 점수에 영향을 줍니다.
- 두 하위 규칙의 점수는 추가되지 않습니다.
채점 규칙이 두 개 이상인 경우, 점수는 각 규칙마다 별도로 유지된다.
채점 규칙은 해당 jcr:content
노드에 속성이 있는 cq:Page
유형의 노드이며, 해당 노드를 정의하는 하위 규칙 목록을 지정합니다.
점수는 SRP에 저장됩니다.
/libs/settings/community/scoring/rules/site2/forums-scoring
채점 하위 규칙 scoring-sub-rules
채점 하위 규칙에는 커뮤니티에 참여하기 위한 값을 자세히 설명하는 속성이 포함됩니다.
각 채점 하위 규칙은 다음을 식별합니다.
- 어떤 활동이 추적 중입니까?
- 어떤 특정 커뮤니티 기능이 관련됩니까?
- 몇 점이 주어집니까?
하위 규칙이 콘텐츠 소유자를 포인트(forOwner
)를 받는 것으로 지정하지 않는 한 기본적으로 작업을 수행하는 멤버에게 포인트가 부여됩니다.
각 하위 규칙은 하나 이상의 채점 규칙에 포함될 수 있습니다.
하위 규칙의 이름은 일반적으로 subject, object 및 verb 을(를) 사용하는 패턴을 따릅니다. 예:
- member-comment-create
- 회원 수신 투표
하위 규칙은 동사 및 항목을(를) 지정하는 jcr:content
노드에 속성이 있는 cq:Page
유형의 노드입니다.
채점 규칙 및 하위 규칙 포함 included-scoring-rules-and-sub-rules
릴리스에는 포럼 함수에 대한 두 개의 채점 규칙(포럼 기능의 포럼 및 댓글 구성 요소에 대해 각각 하나씩)이 포함되어 있습니다.
-
/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-vote
/libs/settings/community/scoring/rules/sub-rules/member-give-vote
/libs/settings/community/scoring/rules/sub-rules/member-is-moderated
- subRules[] =
-
/libs/settings/community/scoring/rules/forums-scoring
- subRules[] =
/libs/settings/community/scoring/rules/sub-rules/member-forum-create
/libs/settings/community/scoring/rules/sub-rules/member-receive-vote
/libs/settings/community/scoring/rules/sub-rules/member-give-vote
/libs/settings/community/scoring/rules/sub-rules/member-is-moderated
- subRules[] =
메모:
-
rules
및sub-rules
노드가 모두 cq:Page 유형입니다. -
subRules
은(는) 규칙의jcr:content
노드에 있는 String[] 형식의 특성입니다. -
sub-rules
은(는) 다양한 채점 규칙 간에 공유될 수 있습니다. -
rules
은(는) 모든 사용자에 대한 읽기 권한이 있는 저장소 위치에 있어야 합니다.- 규칙 이름은 위치에 관계없이 고유해야 합니다.
사용자 지정 점수 규칙 활성화 activating-custom-scoring-rules
작성 환경에서 수행한 채점 규칙 또는 하위 규칙에 대한 변경 또는 추가 사항은 게시에 설치해야 합니다.
배지 규칙 badging-rules
배지 규칙은 다음을 지정하여 점수 규칙을 배지에 연결합니다.
- 채점 규칙
- 특정 배지를 수여하는 데 필요한 점수
배지 규칙은 점수 규칙 및 배지와 상관 관계가 있는 속성이 jcr:content
노드에 있는 cq:Page
유형의 노드입니다.
배지 규칙은 배지에 매핑된 점수의 순서가 지정된 항목인 필수 thresholds
속성으로 구성됩니다. 점수는 값을 늘려서 주문해야 합니다. 예:
-
1|/libs/settings/community/badging/images/bronze-badge/jcr:content/bronze.png
- 브론즈 배지는 1점 획득으로 수여된다.
-
60|/libs/settings/community/badging/images/silver-badge/jcr:content/silver.png
- 실버 배지는 60점이 누적되면 수여된다.
-
80|/libs/settings/community/badging/images/gold-badge/jcr:content/gold.png
- 골드 배지는 80점이 적립되면 수여된다.
배지 규칙은 점수가 누적되는 방법을 결정하는 점수 규칙과 쌍을 이룹니다. 콘텐츠에 규칙 적용 섹션을 참조하십시오.
배지 규칙의 scoringRules
속성은 해당 특정 배지 규칙과 연결할 수 있는 점수 규칙을 제한합니다.
포함된 배지 규칙 included-badging-rules
릴리스에는 포럼 및 댓글 점수 규칙에 해당하는 두 개의 배지 규칙이 포함되어 있습니다.
-
/libs/settings/community/badging/rules/comments-badging
-
/libs/settings/community/badging/rules/forums-badging
메모:
-
rules
개 노드가 cq:Page 유형입니다. -
rules
은(는) 모든 사용자에 대한 읽기 권한이 있는 저장소 위치에 있어야 합니다.- 규칙 이름은 위치에 관계없이 고유해야 합니다.
사용자 지정 배지 규칙 활성화 activating-custom-badging-rules
작성 환경에서 만들어진 배지 규칙 또는 이미지에 대한 변경 사항 또는 추가 사항은 게시에 설치해야 합니다.
배지 할당 및 취소 assign-and-revoke-badges
구성원 콘솔을 사용하거나 프로그래밍 방식으로 cURL 명령을 사용하여 구성원에게 배지를 할당할 수 있습니다.
다음 cURL 명령은 배지 할당 및 취소를 위한 HTTP 요청에 필요한 사항을 보여 줍니다. 기본 형식은 다음과 같습니다.
cURL -i -X POST -H 헤더 -u 로그인 -F 작업 -F 배지 구성원-프로필-url
header = "Accept:application/json"
서버에 전달할 사용자 지정 헤더(필수)
로그인 = administrator-id:password
예: admin:admin
작업 = ":operation=social:assignBadge" 또는 ":operation=social:deleteBadge"
배지 = "badgeContentPath=badge-image-file"
badge-image-file = 저장소의 배지 이미지 파일 위치
예: /libs/settings/community/badging/images/moderator/jcr:content/moderator.png
member-profile-url = 게시할 때 구성원 프로필의 끝점입니다
예: https://<server>:<port>/home/users/community/riley/profile.social.json
예: examples
중재자 배지 할당 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
할당된 실버 배지 취소 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
사용자 지정 구성 요소에 대한 점수 및 배지 scoring-and-badges-for-custom-components
구성 요소에 대해 만들어진 이벤트 주제를 동사와 연결하여 사용자 지정 구성 요소에 대한 점수 및 배지 규칙을 만들 수 있습니다.
주제 및 동사 topics-and-verbs
구성원이 커뮤니티 기능과 상호 작용할 때 알림 및 점수와 같은 비동기 리스너를 트리거할 수 있는 이벤트가 전송됩니다.
구성 요소의 SocialEvent 인스턴스가 이벤트를 topic
에 대해 발생하는 actions
(으)로 기록합니다. SocialEvent에는 작업과 연결된 verb
을(를) 반환하는 메서드가 포함되어 있습니다. actions
과(와) verbs
사이에 n-1 관계가 있습니다.
전달된 커뮤니티 구성 요소의 경우 다음 표에서는 채점 하위 규칙에서 사용할 수 있는 각 topic
에 대해 정의된 verbs
을(를) 설명합니다.
allowBadges
은(는) 구성 요소 인스턴스에 대한 배지 표시를 활성화/비활성화합니다. 배지 표시 확인란으로 업데이트된 구성 요소 편집 대화 상자에서 구성할 수 있습니다.달력 구성 요소
SocialEvent topic
= com/adobe/cq/social/calendar
댓글 구성 요소
SocialEvent topic
= com/adobe/cq/social/comment
파일 라이브러리 구성 요소
SocialEvent topic
= com/adobe/cq/social/fileLibrary
포럼 구성 요소
SocialEvent topic
= com/adobe/cq/social/forum
저널 구성 요소
SocialEvent topic
= com/adobe/cq/social/journal
QnA 구성 요소
SocialEvent topic
= com/adobe/cq/social/q
구성 요소 검토
SocialEvent topic
= com/adobe/cq/social/review
구성 요소 평가
SocialEvent topic
= com/adobe/cq/social/tally/rating
투표 구성 요소
SocialEvent topic
= com/adobe/cq/social/tally/voting
중재 사용 구성 요소
SocialEvent topic
= com/adobe/cq/social/moderation
사용자 지정 구성 요소 이벤트 custom-component-events
사용자 지정 구성 요소의 경우 구성 요소의 이벤트를 topic
에 대해 발생하는 actions
(으)로 기록하도록 SocialEvent가 인스턴스화됩니다.
채점을 지원하려면 각 action
에 대해 적절한 verb
이(가) 반환되도록 SocialEvent가 getVerb()
메서드를 재정의해야 합니다. 작업에 대해 반환된 verb
은(는) 일반적으로 사용되는 것(예: POST
) 또는 구성 요소에 특화된 것(예: ADD RATING
)일 수 있습니다. actions
과(와) verbs
사이에 n-1 관계가 있습니다.
문제 해결 troubleshooting
배지가 표시되지 않음 badges-are-not-appearing
채점 및 배지 규칙이 웹 사이트의 콘텐츠에 적용되었지만, 배지가 활동에 대해 부여되지 않는 경우 해당 구성 요소의 인스턴스에 대해 배지가 활성화되었는지 확인하십시오.
구성 요소에 대한 배지 사용을 참조하십시오.
채점 규칙이 적용되지 않음 scoring-rule-has-no-effect
채점 및 배지 규칙이 웹 사이트 콘텐츠에 적용되었으며 배지가 일부 작업에 대해 부여되고 있지만 다른 작업에 대해 부여되지 않은 경우 배지 규칙이 적용되는 채점 규칙을 제한하지 않았는지 확인하십시오.
배지 규칙의 scoringRules
속성을 참조하십시오.
대/소문자 오타 case-sensitive-typo
대부분의 속성 및 값, 특히 동사는 대/소문자를 구분합니다. 채점 하위 규칙에서 동사는 모두 대문자로 사용해야 합니다.
기능이 예상대로 작동하지 않는 경우 데이터가 올바르게 입력되었는지 확인하십시오.
빠른 테스트 quick-test
시작 자습서(참여) 사이트 를 사용하여 채점 및 배지를 빠르게 시도할 수 있습니다.
-
작성자의 CRXDE Lite에 액세스합니다.
-
기본 페이지로 이동합니다.
- /content/sites/engage/en/jcr:content
-
badgingRules 속성을 추가합니다.
- 이름:
badgingRules
- 유형:
String
- 다중 선택
- 추가 선택
/libs/settings/community/badging/rules/forums-badging
입력- + 선택
/libs/settings/community/badging/rules/comments-badging
입력- 확인 선택
- 이름:
-
scoringRules 속성을 추가합니다.
- 이름:
scoringRules
- 유형:
String
- 다중 선택
- 추가 선택
/libs/settings/community/scoring/rules/forums-scoring
입력- + 선택
/libs/settings/community/scoring/rules/comments-scoring
입력- 확인 선택
- 이름:
-
모두 저장 을 선택합니다.
그런 다음 포럼 및 댓글 구성 요소에서 배지를 표시할 수 있는지 확인합니다.
-
다시 CRXDE Lite 사용.
-
포럼 구성 요소 찾아보기
/content/sites/engage/en/forum/jcr:content/content/primary/forum
-
필요한 경우 allowBadges 부울 속성을 추가하고 true인지 확인합니다.
- 이름:
allowBadges
- 유형:
Boolean
- 값:
true
- 이름:
다음으로 커뮤니티 사이트를 다시 게시합니다.
마지막으로,
-
게시 인스턴스에서 구성 요소를 찾습니다.
-
커뮤니티 구성원으로 로그인합니다(예: weston.mccall@dodgit.com / 암호).
-
Post에 새 포럼 주제가 추가되었습니다.
-
배지를 표시하려면 페이지를 새로 고쳐야 합니다.
- 로그아웃한 후 다른 커뮤니티 구성원으로 로그인합니다(예: aaron.mcdonald@mailinator.com/password).
-
포럼을 선택합니다.
커뮤니티 회원은 첫 번째 포럼 배지 규칙의 첫 번째 임계값이 1이기 때문에 포럼 게시물이 표시되는 브론즈 배지를 받게 됩니다.
추가 정보 additional-information
자세한 내용은 개발자를 위한 채점 및 배지 기본 사항 페이지에서 확인할 수 있습니다.
고급 채점 엔진에 대한 자세한 내용은 고급 채점 및 배지를 참조하십시오.
구성 가능한 순위표 구성 요소 및 함수을(를) 사용하면 커뮤니티 사이트에 구성원과 점수를 쉽게 표시할 수 있습니다.