커뮤니티 점수 및 배지 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
자세한 내용은 점수 책정 및 배지 핵심 사항 개발자를 위한 페이지입니다.
고급 점수 엔진에 대한 자세한 내용은 고급 점수 및 배지.
구성 가능한 리드보드 구성 요소 및 함수 커뮤니티 사이트에서 구성원 및 해당 점수를 간편하게 표시할 수 있습니다.