커뮤니티 점수 및 배지 communities-scoring-and-badges
개요 overview
AEM Communities 점수 및 배지 기능은 커뮤니티 구성원을 식별하고 포상하는 기능을 제공합니다.
점수부여 및 배지의 주요 특징은 다음과 같습니다.
참고 그 배지는 기본적으로 활성화되지 않음.
배지 badges
배지를 회원명부에 올려놓고 회원들의 역할이나 지역 사회 내 지위를 나타내는 배지도 있다. 배지는 이미지 또는 이름으로 표시될 수 있습니다. 이미지로 표시되면 액세스 가능성이 있는 대체 텍스트로 이름이 포함됩니다.
기본적으로 배지는 다음 리포지토리에 있습니다.
- /etc/community/badging/images
다른 위치에 저장된 경우 모든 사람이 읽을 수 있어야 합니다.
배지는 UGC에서 할당된 배지 또는 받은 배지가 규칙에 따라 차별화된다. 현재, 지정된 배지는 텍스트로 표시되고 획득된 배지는 이미지로 나타납니다.
배지 관리 UI badge-management-ui
커뮤니티 배지 콘솔 은(는) 획득할 때(수상) 또는 커뮤니티에서 특정 역할을 수행할 때(지정된) 회원에게 표시할 수 있는 사용자 지정 배지를 추가할 수 있는 기능을 제공합니다.
지정된 배지 assigned-badges
역할 기반 배지는 관리자가 커뮤니티에서 자신의 역할에 따라 커뮤니티 구성원에게 지정합니다.
지정된(및 꺼진) 배지는 선택한 위치에 저장됩니다 SRP 및에 직접 액세스할 수 없습니다. GUI를 사용할 수 있을 때까지 역할 기반 배지를 할당하는 유일한 방법은 코드나 cURL을 사용하여 할당하는 것입니다. cURL 지침은 배지 할당 및 취소.
이번 릴리스에는 세 가지 역할 기반 배지가 포함되어 있습니다.
-
중재자
/etc/community/badging/images/moderator/jcr:content/moderator.png
-
그룹 관리자
/etc/community/badging/images/group-manager/jcr:content/group-manager.png
-
권한이 있는 구성원
/etc/community/badging/images/privileged-member/jcr:content/privileged-member.png
수상 배지 awarded-badges
보상 기반 배지는 지역 사회의 활동에 적용된 규칙에 따라 지역 사회 구성원들에게 점수 부여 서비스에 의해 수여됩니다.
배지가 활동에 대한 보상으로 나타나게 하려면, 일어나야 하는 두 가지 사항이 있습니다.
이번 릴리스에는 세 가지 현상금이 걸려 있습니다.
-
골드
/etc/community/badging/images/gold-badge/jcr:content/gold.png
-
실버
/etc/community/badging/images/silver-badge/jcr:content/silver.png
-
브론즈
/etc/community/badging/images/bronze-badge/jcr:content/bronze.png
사용자 지정 배지 custom-badges
사용자 지정 배지는 배지 콘솔 및 을 배지 규칙에 할당하거나 지정합니다.
Badge 콘솔에서 설치되면 사용자 지정 배지가 게시 환경에 자동으로 복제됩니다.
점수 책정 활성화 enable-scoring
기본적으로 점수는 활성화되지 않습니다. 배지 점수 책정 및 수상을 위한 기본 단계는 다음과 같습니다.
-
소득 포인트에 대한 규칙 식별(점수 규칙)
자세한 내용은 빠른 테스트 포럼 및 댓글에 대한 기본 점수 및 배지 규칙을 사용하여 커뮤니티 사이트에 대한 점수 책정 활성화 섹션을 참조하십시오.
컨텐츠에 규칙 적용 apply-rules-to-content
점수부여 및 배지를 활성화하려면 속성을 추가합니다 scoringRules
및 badgingRules
을 눌러 사이트에 대한 컨텐츠 트리의 임의의 노드에 추가합니다.
사이트가 이미 게시되어 있는 경우, 모든 규칙을 적용하고 구성 요소를 활성화한 후 사이트를 다시 게시하십시오.
배지 사용 구성 요소에 적용되는 규칙은 현재 노드 또는 해당 조상에 대한 규칙입니다.
노드가 유형인 경우 cq:Page
(권장) 그런 다음 CRXDE|Lite를 사용하여 속성을 해당 속성에 추가합니다 jcr:content
노드 아래에 있어야 합니다.
구성 요소에 대한 배지 활성화 enable-badges-for-component
점수부여 및 배지 규칙은 구성 요소의에서 구성 요소 구성을 편집하여 배지를 활성화한 구성 요소의 인스턴스에만 적용됩니다 작성 모드.
부울 속성, allowBadges
에서는 구성 요소 인스턴스에 대한 배지 표시를 활성화/비활성화합니다. 구성 가능한 템플릿은 구성 요소 편집 대화 상자 포럼, QnA 및 아래에 레이블이 지정된 확인란을 통해 구성 요소 설명 배지 표시.
예: 포럼 구성 요소 인스턴스에 대한 allowBadge example-allowbadges-for-forum-component-instance
점수 규칙 scoring-rules
채점 규칙은 배지 수상을 위한 채점의 기초입니다.
매우 간단하게, 각 점수 규칙은 하나 이상의 하위 규칙 목록입니다. 배지가 활성화될 때 적용할 규칙을 식별하기 위해 커뮤니티 사이트 콘텐츠에 점수부여 규칙이 적용됩니다.
점수 규칙은 상속되지만 첨가제는 아닙니다. 예:
-
page2에 점수부여 규칙2가 포함되어 있고 해당 상위 페이지1에 점수부여 규칙1이 포함되어 있는 경우
-
page2 구성 요소에 대한 작업은 rule1과 rule2를 모두 호출합니다
-
두 규칙에 동일한 규칙에 적용 가능한 하위 규칙이 포함되어 있는 경우
topic/verb
:- rule2의 하위 규칙만 점수에 영향을 줍니다.
- 두 하위 규칙의 점수는 함께 추가되지 않습니다
둘 이상의 점수 규칙이 있는 경우 각 규칙에 대해 점수가 별도로 유지됩니다.
점수 규칙은 유형의 노드입니다 cq:Page
속성을 jcr:content
정의하는 하위 규칙 목록을 지정하는 노드입니다.
점수는 SRP에 저장됩니다.
/etc/community/scoring/rules/site1/forums-scoring
/etc/community/scoring/rules/site2/forums-scoring
점수 하위 규칙 scoring-sub-rules
점수 하위 규칙에는 커뮤니티에 참여할 값을 자세히 설명하는 속성이 포함됩니다.
각 점수 하위 규칙이 식별됨
- 추적 중인 활동
- 어떤 특정 커뮤니티 기능이 포함됩니까?
- 점수 몇 점을 받았습니까
기본적으로 하위 규칙이 컨텐츠의 소유자를 수신 포인트로 지정하지 않는 한 조치 수행 멤버에게 점수가 부여됩니다( forOwner
).
각 하위 규칙은 하나 이상의 점수 규칙에 포함될 수 있습니다.
하위 규칙의 이름은 일반적으로 제목, 개체 및 동사. 예:
- member-comment-create
- 회원 가입 투표
하위 규칙은 유형의 노드입니다 cq:Page
속성을 jcr:content
지정할 노드 동사 및 주제 .
점수 규칙 및 하위 규칙 포함 included-scoring-rules-and-sub-rules
릴리스에 포함된 값은 포럼 함수 (포럼 기능의 포럼 및 주석 구성 요소에 대해 각각 하나씩):
-
/etc/community/scoring/rules/comments-scoring
-
subRules[] =
/etc/community/scoring/rules/sub-rules/member-comment-create
/etc/community/scoring/rules/sub-rules/member-receive-voke
/etc/community/scoring/rules/sub-rules/member-give-voke
/etc/community/scoring/rules/sub-rules/member-is-advertising
-
-
/etc/community/scoring/rules/forums-scoring
-
subRules[] =
/etc/community/scoring/rules/sub-rules/member-forum-create
/etc/community/scoring/rules/sub-rules/member-receive-voke
/etc/community/scoring/rules/sub-rules/member-give-voke
/etc/community/scoring/rules/sub-rules/member-is-advertising
-
메모:
-
둘 다
rules
및sub-rules
노드는 cq:Page 유형입니다. -
subRules
는 String 유형의 속성입니다.[] 규칙jcr:content
노드 -
sub-rules
다양한 점수 규칙 간에 공유할 수 있습니다 -
rules
모든 사용자에 대해 읽기 권한이 있는 저장소 위치에 있어야 합니다- 규칙 이름은 위치에 관계없이 고유해야 합니다
사용자 지정 점수 규칙 활성화 activating-custom-scoring-rules
작성 환경에서 수행한 점수 규칙 또는 하위 규칙에 대한 변경 사항이나 추가 사항은 게시에 설치해야 합니다.
배지 규칙 badging-rules
배지 규칙은 다음을 지정하여 점수 책정 규칙을 배지에 연결합니다.
- 어느 점수 규칙
- 특정 배지에 표시되어야 하는 점수
배지 규칙은 유형의 노드입니다 cq:Page
속성을 jcr:content
점수 및 배지에 점수 규칙을 상관 관계가 있는 노드입니다.
배지 규칙은 필수 항목으로 구성됩니다 thresholds
배지에 매핑된 점수의 순서가 지정된 속성입니다. 점수에 대해서는 값을 더 높게 매겨야 한다. 예:
-
1|/etc/community/badging/images/bronze-badge/jcr:content/bronze.png
- 청동 배지는 1점을 얻으면 착용한다
-
60|/etc/community/badging/images/silver-badge/jcr:content/silver.png
- 60점이 적립되면 은 배지가 주어진다
-
80|/etc/community/badging/images/gold-badge/jcr:content/gold.png
- 80점이 쌓여 금 배지를 만들기도 한다
배지 규칙은 점수가 누적되는 방식을 결정하는 점수 규칙과 쌍을 이루었습니다. 제목이 있는 섹션을 참조하십시오. 컨텐츠에 규칙 적용.
다음 scoringRules
배지 규칙의 속성은 특정 배지 규칙과 연결할 수 있는 점수 규칙을 제한합니다.
배지 규칙 포함 included-badging-rules
릴리스에 포함된 두 가지 배지 규칙은 포럼 및 댓글 점수 규칙.
- /etc/community/badging/rules/comments-badging
- /etc/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 *배지 * member-profile-url
헤더 = "Accept:application/json"
서버에 전달할 사용자 지정 헤더(필수)
서명 = administrator-id:password
예: admin:admin
작업 = ":operation=social:assignBadge" OR ":operation=social:deleteBadge"
배지 = "badgeContentPath=badge-image-file"
badge-image-file = 저장소에서 배지 이미지 파일의 위치
예: content/moderator.png
member-profile-url = 게시 시 구성원 프로필에 대한 끝점입니다.
예: https://<server>:<port>/home/users/community/riley/profile.social.json
- 다음 경우에 작성자 인스턴스를 참조할 수 있습니다. 터널 서비스 이 활성화되어 있습니다.
- 알 수 없는 임의 이름일 수 있습니다. Security 검사 목록 인증 가능한 ID와 관련하여
예: examples
중재자 배지 할당 assign-a-moderator-badge
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
할당된 실버 배지 취소 revoke-an-assigned-silver-badge
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
사용자 지정 구성 요소에 대한 점수 및 배지 scoring-and-badges-for-custom-components
구성 요소에 대해 생성된 이벤트 항목을 동사와 연결하여 사용자 지정 구성 요소에 대해 점수 및 배지 규칙을 만들 수 있습니다.
항목 및 동사 topics-and-verbs
구성원이 커뮤니티 기능과 상호 작용할 때 알림 및 점수 책정 등의 비동기 수신기를 트리거할 수 있는 이벤트가 전송됩니다.
구성 요소의 SocialEvent 인스턴스가 이벤트를 actions
그것은 topic
. SocialEvent에는 verb
관련 작업을 수행한 후, 다음 항목이 있습니다 n-1 관계 간 actions
및 verbs
.
제공된 커뮤니티 구성 요소의 경우 다음 표에서는 verbs
각 topic
사용 가능 하위 규칙 점수 책정.
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/qna
구성 요소 검토
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
사용자 지정 구성 요소의 경우 SocialEvent가 인스턴스화하여 구성 요소의 이벤트를 actions
그것은 topic
.
점수를 지원하려면 SocialEvent가 메서드를 재정의해야 합니다 getVerb()
그래서 적절한 verb
에 대해 반환됨 action
. 다음 verb
작업에 대해 반환되는 것은 일반적으로 사용되는 것(예: POST
) 또는 각 구성 요소의 전문( 예: ADD RATING
). 다음 항목이 있습니다 n-1 관계 간 actions
및 verbs
.
문제 해결 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
- 선택 다중
- 선택 추가
- Enter 키
/etc/community/badging/rules/forums-badging
- 선택
+
- Enter 키
/etc/community/badging/rules/comments-badging
- 선택 확인
- 이름:
-
scoringRules 등록 정보를 추가합니다.
- 이름:
scoringRules
- 유형:
String
- 선택 다중
- 선택 추가
- Enter 키
/etc/community/scoring/rules/forums-scoring
- 선택
+
- Enter 키
/etc/community/scoring/rules/comments-scoring
- 선택 확인
- 이름:
-
선택 모두 저장
그런 다음 포럼 및 주석 구성 요소를 통해 배지를 표시할 수 있는지 확인합니다.
-
다시 CRXDE Lite 사용
-
포럼 구성 요소로 이동합니다
/content/sites/engage/en/forum/jcr:content/content/primary/forum
-
필요한 경우 allowBadge 부울 속성을 추가하고 true인지 확인합니다.
- 이름:
allowBadges
- 유형:
Boolean
- 값:
true
- 이름:
다음, 다시 게시 커뮤니티 사이트입니다.
마지막으로
-
게시 인스턴스에서 구성 요소를 찾습니다
-
커뮤니티 구성원으로 로그인(예: weston.mccall@dodgit.com / password)
-
새 포럼 주제 게시
-
배지가 표시되려면 페이지를 새로 고쳐야 합니다
- 다른 커뮤니티 구성원으로 로그아웃하고 로그인합니다(예: aaron.mcdonald@mailinator.com / password)
-
포럼 선택
이렇게 하면 첫 번째 포럼 배지 규칙의 첫 번째 임계값이 1로 인해 커뮤니티 멤버가 포럼 게시물에 표시되는 청동 배지를 받게 됩니다.
추가 정보 additional-information
자세한 내용은 점수 책정 및 배지 핵심 사항 개발자를 위한 페이지입니다.
고급 점수 엔진에 대한 자세한 내용은 고급 점수 및 배지.
구성 가능한 리드보드 구성 요소 및 함수 커뮤니티 사이트에서 구성원 및 해당 점수를 간편하게 표시할 수 있습니다.