AEM Communities 점수 및 배지 기능은 커뮤니티 구성원을 식별하고 포상하는 기능을 제공합니다.
점수부여 및 배지의 주요 특징은 다음과 같습니다.
커뮤니티 에서 구성원의 역할을 식별하는 배지 할당
참가 를 장려하기 위한 배지 멤버의 기본 제공(컨텐츠 생성 수량)
배지 배지에 대한 고급 보상으로 구성원을 전문가(생성된 컨텐츠의 품질)로 식별합니다
기본적으로 배지 수여가 활성화되지 않습니다.
CRXDE Lite에 표시되는 구현 구조는 UI를 사용할 수 있게 되면 변경될 수 있습니다.
배지를 회원명부에 올려놓고 회원들의 역할이나 지역 사회 내 지위를 나타내는 배지도 있다. 배지는 이미지 또는 이름으로 표시될 수 있습니다. 이미지로 표시되면 액세스 가능성이 있는 대체 텍스트로 이름이 포함됩니다.
기본적으로 배지는 다음 리포지토리에 있습니다.
다른 위치에 저장된 경우 모든 사람이 읽을 수 있어야 합니다.
배지는 UGC에서 할당된 배지 또는 받은 배지가 규칙에 따라 차별화된다. 현재, 지정된 배지는 텍스트로 표시되고 획득된 배지는 이미지로 나타납니다.
커뮤니티 배지 콘솔은(는) 수익을 낼 때 또는 커뮤니티에서 특정 역할을 수행할 때(지정된) 회원에게 표시될 수 있는 사용자 지정 배지를 추가하는 기능을 제공합니다.
역할 기반 배지는 관리자가 커뮤니티에서의 역할에 따라 커뮤니티 구성원에게 지정합니다.
지정된(및 꺼진) 배지는 선택한 SRP에 저장되며 직접 액세스할 수 없습니다. GUI를 사용할 수 있을 때까지 역할 기반 배지를 할당하는 유일한 방법은 코드나 cURL을 사용하여 할당하는 것입니다. URL 지침은 배지 지정 및 취소 섹션을 참조하십시오.
이번 릴리스에는 세 가지 역할 기반 배지가 포함되어 있습니다.
중재자
/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
보상 기반 배지는 지역 사회의 활동에 적용된 규칙에 따라 지역 사회 구성원들에게 점수 부여 서비스에 의해 수여됩니다.
배지가 활동에 대한 보상으로 나타나게 하려면, 일어나야 하는 두 가지 사항이 있습니다.
이번 릴리스에는 세 가지 현상금이 걸려 있습니다.
골드
/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
점수 규칙은 부적절한 것으로 플래그가 지정된 게시물에 대해 음수를 할당하도록 구성되어 있어서 점수 값에 영향을 줄 수 있습니다. 그러나 배지가 획득되면 점수 포인트 감소 또는 점수 규칙 변경 때문에 배지가 자동으로 제거되지 않습니다.
수여된 배지는 지정된 배지와 동일한 방식으로 취소할 수 있습니다. 배지 지정 및 취소 섹션을 참조하십시오. 향후 개선 사항에는 구성원의 배지를 관리할 UI가 포함됩니다.
사용자 지정 배지는 배지 콘솔을 사용하여 설치하고 배지 규칙에 할당하거나 지정할 수 있습니다.
Badge 콘솔에서 설치되면 사용자 지정 배지가 게시 환경에 자동으로 복제됩니다.
기본적으로 점수는 활성화되지 않습니다. 배지 점수 책정 및 수상을 위한 기본 단계는 다음과 같습니다.
학습 포인트에 대한 규칙 식별(점수 규칙)
포럼 및 댓글에 대한 기본 점수 및 배지 규칙을 사용하여 커뮤니티 사이트에 대한 점수를 활성화하려면 빠른 테스트 섹션을 참조하십시오.
점수부여 및 배지를 사용하려면 속성 scoringRules
및 badgingRules
을 사이트의 컨텐츠 트리의 노드에 추가합니다.
사이트가 이미 게시되어 있는 경우, 모든 규칙을 적용하고 구성 요소를 활성화한 후 사이트를 다시 게시하십시오.
배지 사용 구성 요소에 적용되는 규칙은 현재 노드 또는 해당 조상에 대한 규칙입니다.
노드가 cq:Page
(권장) 유형인 경우 CRXDE|Lite를 사용하여 속성을 해당 jcr:content
노드에 추가합니다.
속성 | 유형 | 설명 |
---|---|---|
배지 규칙 | String[] | 배지 규칙 목록 |
scoringRules | 문자열[] | 채점 규칙 배열 목록 |
점수 규칙이 배지 수여에 영향을 주지 않는 것으로 나타나면 배지 규칙의 scoringRules 속성에 의해 점수 규칙이 차단되지 않았는지 확인합니다. 배지 규칙이라는 섹션을 참조하십시오.
점수부여 및 배지 규칙은 작성 모드에서 구성 요소 구성을 편집하여 배지를 활성화한 구성 요소의 인스턴스에만 적용됩니다.
부울 속성 allowBadges
은 구성 요소 인스턴스에 대한 배지 표시를 활성화/비활성화합니다. 구성 요소 편집 대화 상자에서 포럼, QnA 및 배지 표시 확인란을 통해 구성 요소를 구성할 수 있습니다.
포럼, QnA 및 댓글에 있는 HBS 코드를 사용하여 배지를 표시하도록 구성 요소를 오버레이할 수 있습니다.
채점 규칙은 배지 수상을 위한 채점의 기초입니다.
매우 간단하게, 각 점수 규칙은 하나 이상의 하위 규칙 목록입니다. 배지가 활성화될 때 적용할 규칙을 식별하기 위해 커뮤니티 사이트 콘텐츠에 점수부여 규칙이 적용됩니다.
점수 규칙은 상속되지만 첨가제는 아닙니다. 예:
page2에 점수부여 규칙2가 포함되어 있고 해당 상위 페이지1에 점수부여 규칙1이 포함되어 있는 경우
page2 구성 요소에 대한 작업은 rule1과 rule2를 모두 호출합니다
두 규칙에 동일한 topic/verb
에 대해 적용 가능한 하위 규칙이 포함되어 있는 경우:
둘 이상의 점수 규칙이 있는 경우 각 규칙에 대해 점수가 별도로 유지됩니다.
점수 규칙은 cq:Page
유형의 노드로서 이 규칙을 정의하는 하위 규칙 목록을 지정하는 jcr:content
노드에 속성이 있습니다.
점수는 SRP에 저장됩니다.
우수 사례: 각 점수 규칙의 이름을 고유하게 지정합니다.
점수 규칙 이름은 전역적으로 고유해야 합니다. 같은 이름으로 끝나면 안 됩니다.
이하지 않을 작업의 예:
/etc/community/scoring/rules/site1/forums-scoring
/etc/community/scoring/rules/site2/forums-scoring
점수 하위 규칙에는 커뮤니티에 참여할 값을 자세히 설명하는 속성이 포함됩니다.
각 점수 하위 규칙이 식별됨
하위 규칙이 컨텐츠의 소유자를 수신 포인트( forOwner
)로 지정하지 않는 한 기본적으로 작업 수행 멤버에게 점수가 부여됩니다.
각 하위 규칙은 하나 이상의 점수 규칙에 포함될 수 있습니다.
하위 규칙의 이름은 일반적으로 subject, object 및 verb를 사용하는 패턴을 따릅니다. 예:
하위 규칙은 동사와 항목 을 지정하는 jcr:content
노드에 속성이 있는 cq:Page
유형의 노드입니다.
속성 | 유형 | 값 설명 |
---|---|---|
VERB |
긴 |
|
topics |
String[] |
|
forOwner |
부울 |
|
scoringType |
문자열 |
|
릴리스에는 포럼 함수에 대한 두 개의 점수 규칙이 포함됩니다(포럼 기능과 포럼 기능의 댓글 구성 요소에 대해 각각 하나씩).
/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
모든 사용자에 대해 읽기 권한이 있는 저장소 위치에 있어야 합니다
작성 환경에서 수행한 점수 규칙 또는 하위 규칙에 대한 변경 사항이나 추가 사항은 게시에 설치해야 합니다.
배지 규칙은 다음을 지정하여 점수 책정 규칙을 배지에 연결합니다.
배지 규칙은 점수 및 배지에 점수 규칙을 상호 연결하는 jcr:content
노드의 속성을 가진 cq:Page
유형의 노드입니다.
배지 규칙은 배지에 매핑되는 순차적인 점수 목록인 필수 thresholds
속성으로 구성됩니다. 점수에 대해서는 값을 더 높게 매겨야 한다. 예:
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
배지 규칙은 점수가 누적되는 방식을 결정하는 점수 규칙과 쌍을 이루었습니다. 컨텐츠에 규칙 적용 섹션을 참조하십시오.
배지 규칙의 scoringRules
속성은 해당 특정 배지 규칙과 연결할 수 있는 점수 규칙을 제한합니다.
우수 사례: 각 AEM 사이트에 고유한 배지 이미지를 만듭니다.
속성 | 유형 | 값 설명 |
---|---|---|
임계값 | 문자열[] | (필수) 'number|path' 형식의 다중 값 문자열입니다
항목 예: 80|/etc/community/badging/images/gold-badge/jcr:content/gold.png |
badgingType | 문자열 | (선택 사항) 점수 엔진을 "기본" 또는 "고급"으로 식별합니다. 고급 점수 엔진이 필요한 경우 고급 점수 및 배지를 참조하십시오. 기본값은 "기본"입니다. |
scoringRules |
문자열[] | (선택 사항) 점수부여 규칙으로 식별된 점수 이벤트로 배지 규칙을 제한하는 다중 값 문자열입니다 |
이 릴리스에는 포럼 및 댓글 점수 규칙에 해당하는 두 가지 배지 규칙이 포함됩니다.
메모:
rules
노드는 cq:Page 유형입니다.
rules
모든 사용자에 대해 읽기 권한이 있는 저장소 위치에 있어야 합니다
배지 규칙 또는 작성 환경에서 수행된 이미지에 대한 모든 변경 사항 또는 추가 사항은 게시에 설치해야 합니다.
배지는 멤버 콘솔을 사용하거나 프로그래밍 방식으로 cURL 명령을 사용하여 멤버에 할당할 수 있습니다.
다음 cURL 명령은 배지를 할당하고 취소하는 HTTP 요청에 필요한 사항을 보여 줍니다. 기본 형식은 다음과 같습니다.
cURL -i -X POST -H 헤더 -u *signin * -F *operation * -F *배지 * member-profile-url
header = "Accept:application/json"
서버에 전달할 사용자 지정 헤더(필수)
signin = administrator-id:password
예: admin:admin
operation = ":operation=social:assignBadge" OR ":operation=social:deleteBadge"
badge = "badgeContentPath=badge-image-file"
badge-image-file = 저장소에서 배지 이미지 파일의 위치
예: content/moderator.png
member-profile-url = 게시 시 구성원 프로필에 대한 끝점입니다.
예: https://<server>:<port>/home/users/community/riley/profile.social.json
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
cURL을 사용하여 배지 할당 및 해제가 모든 배지 이미지에 작동하지만, 배지 대신 할당되면 배지로 표시되고 그에 따라 처리됩니다.
구성 요소에 대해 생성된 이벤트 항목을 동사와 연결하여 사용자 지정 구성 요소에 대해 점수 및 배지 규칙을 만들 수 있습니다.
구성원이 커뮤니티 기능과 상호 작용할 때 알림 및 점수 책정 등의 비동기 수신기를 트리거할 수 있는 이벤트가 전송됩니다.
구성 요소의 SocialEvent 인스턴스가 이벤트를 topic
에 대해 발생하는 actions
으로 기록합니다. SocialEvent에는 작업과 연결된 verb
을 반환하는 메서드가 포함되어 있습니다. n-1 관계가 actions
와 verbs
사이에 있습니다.
전달된 커뮤니티 구성 요소의 경우 다음 표에서는 점수 하위 규칙에서 사용할 수 있는 각 topic
에 대해 정의된 verbs
에 대해 설명합니다.
새 부울 속성인 allowBadges
은 구성 요소 인스턴스에 대한 배지 표시를 활성화/비활성화합니다. 배지 표시 확인란을 통해 업데이트된 구성 요소 편집 대화 상자에서 구성할 수 있습니다.
Calendar
ComponentSocialEvent topic
= com/adobe/cq/social/calendar
동사 | 설명 |
---|---|
POST | 구성원이 달력 이벤트를 만듭니다. |
추가 | 달력 이벤트에 대한 구성원 댓글 |
업데이트 | 구성원의 달력 이벤트 또는 댓글이 편집됨 |
삭제 | 구성원의 달력 이벤트 또는 주석이 삭제됩니다. |
댓글
ComponentSocialEvent topic
= com/adobe/cq/social/comment
동사 | 설명 |
---|---|
POST | 멤버가 주석 만들기 |
추가 | 댓글 달기 |
업데이트 | 구성원의 댓글이 편집되었습니다. |
삭제 | 구성원 주석이 삭제되었습니다. |
파일 라이브러리
ComponentSocialEvent topic
= com/adobe/cq/social/fileLibrary
동사 | 설명 |
---|---|
POST | 구성원이 폴더를 만듭니다. |
첨부 | 구성원이 파일을 업로드합니다. |
업데이트 | 구성원이 폴더 또는 파일을 업데이트합니다 |
삭제 | 구성원이 폴더 또는 파일을 삭제합니다. |
Forum
ComponentSocialEvent topic
= com/adobe/cq/social/forum
동사 | 설명 |
---|---|
POST | 구성원이 포럼 주제 작성 |
추가 | 포럼 주제에 대한 회신 |
업데이트 | 구성원의 포럼 주제 또는 응답이 편집됨 |
삭제 | 구성원의 포럼 주제 또는 응답이 삭제됨 |
저널
ComponentSocialEvent topic
= com/adobe/cq/social/journal
동사 | 설명 |
---|---|
POST | 구성원이 블로그 문서를 만듭니다. |
추가 | 블로그 문서에 대한 구성원 댓글 |
업데이트 | 구성원의 블로그 기사 또는 댓글이 편집됨 |
삭제 | 구성원의 블로그 문서 또는 댓글이 삭제됨 |
QnA
ComponentSocialEvent topic
= com/adobe/cq/social/qna
동사 | 설명 |
---|---|
POST | 구성원이 QnA 질문을 만듭니다. |
추가 | 멤버가 QnA 응답을 생성합니다. |
업데이트 | 구성원의 QnA 질문 또는 답변이 편집됨 |
선택 | 멤버 답변 선택 |
선택 취소 | 멤버 응답 선택 취소 |
삭제 | 구성원의 QnA 질문 또는 답변이 삭제됩니다. |
Review
ComponentSocialEvent topic
= com/adobe/cq/social/review
동사 | 설명 |
---|---|
POST | 멤버 검토 만들기 |
업데이트 | 구성원 검토 편집 |
삭제 | 구성원 검토 삭제 |
등급
ComponentSocialEvent topic
= com/adobe/cq/social/tally/rating
동사 | 설명 |
---|---|
등급 추가 | 구성원의 콘텐츠가 평가되었습니다. |
등급 제거 | 구성원의 콘텐츠가 다운되었습니다. |
투표
ComponentSocialEvent topic
= com/adobe/cq/social/tally/voting
동사 | 설명 |
---|---|
투표 추가 | 회원의 컨텐츠가 투표되었다 |
투표 제거 | 회원의 컨텐츠가 부결되었다 |
Moderation-enabled
ComponentsSocialEvent topic
= com/adobe/cq/social/moderation
동사 | 설명 |
---|---|
거부 | 구성원의 콘텐츠가 거부됨 |
기가 부적절한 | 구성원의 컨텐츠에 플래그가 지정됩니다. |
부적절한 플래그 지정 | 구성원의 컨텐츠가 플래그가 지정되지 않았습니다. |
수락 | 조정자가 회원 콘텐츠를 승인함 |
닫기 | 구성원이 편집 및 회신에 대한 댓글 닫기 |
열기 | 구성원 주석 다시 열기 |
사용자 지정 구성 요소의 경우 SocialEvent가 인스턴스화되어 구성 요소의 이벤트를 topic
에 대해 발생하는 actions
으로 기록합니다.
점수를 지원하려면 각 action
에 대해 적절한 verb
이 반환되도록 SocialEvent가 메서드 getVerb()
을 재정의해야 합니다. 작업에 대해 반환되는 verb
은 일반적으로 사용되는 하나(예: POST
) 또는 구성 요소에 특화된 하나(예: ADD RATING
)일 수 있습니다. n-1 관계가 actions
와 verbs
사이에 있습니다.
웹 사이트의 콘텐츠에 점수 및 배지 규칙이 적용되었지만 배지가 없는 경우 해당 구성 요소의 인스턴스에 대해 배지가 활성화되어 있는지 확인하십시오.
구성 요소용 배지 활성화를 참조하십시오.
웹 사이트의 콘텐츠에 점수부여 및 배지 규칙이 적용되었으며 배지가 일부 작업에 대해 수여되지만 다른 것은 아닌 경우 배지 규칙이 적용되는 점수 규칙을 제한하지 않았는지 확인하십시오.
배지 규칙의 scoringRules
속성을 참조하십시오.
대부분의 속성과 값, 특히 동사는 대/소문자를 구분합니다. 점수 하위 규칙에서 사용할 경우 동사는 모두 대문자로 사용해야 합니다.
기능이 예상대로 작동하지 않으면 데이터가 올바르게 입력되었는지 확인하십시오.
시작 자습서 (참여) 사이트를 사용하여 점수를 매기고 배지를 신속하게 시도할 수 있습니다.
작성자에 대한 CRXDE Lite 액세스
기본 페이지로 이동합니다.
badgingRules 속성을 추가합니다.
badgingRules
String
/etc/community/badging/rules/forums-badging
입력+
/etc/community/badging/rules/comments-badging
입력scoringRules 등록 정보를 추가합니다.
scoringRules
String
/etc/community/scoring/rules/forums-scoring
입력+
/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)
새 포럼 주제 게시
배지가 표시되려면 페이지를 새로 고쳐야 합니다
포럼 선택
이렇게 하면 첫 번째 포럼 배지 규칙의 첫 번째 임계값이 1로 인해 커뮤니티 멤버가 포럼 게시물에 표시되는 청동 배지를 받게 됩니다.
개발자를 위한 점수 및 배지 필수 패키지 페이지에서 자세한 정보를 찾을 수 있습니다.
고급 점수 엔진에 대한 자세한 내용은 고급 점수 및 배지를 참조하십시오.
구성 가능한 리드 보드 구성 요소 및 함수는 커뮤니티 사이트에서 구성원 및 해당 점수를 간편하게 표시할 수 있도록 해줍니다.