커뮤니티 점수 및 배지

개요

AEM Communities 점수 및 배지 기능은 커뮤니티 구성원을 식별하고 포상하는 기능을 제공합니다.

점수부여 및 배지의 주요 특징은 다음과 같습니다.

• 커뮤니티 에서 구성원의 역할을 식별하는 배지 할당

• 참가 를 장려하기 위한 배지 멤버의 기본 제공(컨텐츠 생성 수량)

• 배지 배지에 대한 고급 보상으로 구성원을 전문가(생성된 컨텐츠의 품질)로 식별합니다

​​기본적으로 배지 수여가 활성화되지 않습니다.

배지

배지를 회원명부에 올려놓고 회원들의 역할이나 지역 사회 내 지위를 나타내는 배지도 있다. 배지는 이미지 또는 이름으로 표시될 수 있습니다. 이미지로 표시되면 액세스 가능성이 있는 대체 텍스트로 이름이 포함됩니다.

기본적으로 배지는 다음 리포지토리에 있습니다.

• /etc/community/badging/images

다른 위치에 저장된 경우 모든 사람이 읽을 수 있어야 합니다.

배지는 UGC에서 할당된 배지 또는 받은 배지가 규칙에 따라 차별화된다. 현재, 지정된 배지는 텍스트로 표시되고 획득된 배지는 이미지로 나타납니다.

배지 관리 UI

커뮤니티 배지 콘솔은(는) 수익을 낼 때 또는 커뮤니티에서 특정 역할을 수행할 때(지정된) 회원에게 표시될 수 있는 사용자 지정 배지를 추가하는 기능을 제공합니다.

지정된 배지

역할 기반 배지는 관리자가 커뮤니티에서의 역할에 따라 커뮤니티 구성원에게 지정합니다.

지정된(및 꺼진) 배지는 선택한 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

수상 배지

보상 기반 배지는 지역 사회의 활동에 적용된 규칙에 따라 지역 사회 구성원들에게 점수 부여 서비스에 의해 수여됩니다.

배지가 활동에 대한 보상으로 나타나게 하려면, 일어나야 하는 두 가지 사항이 있습니다.

• 배지는 기능 구성 요소에 대해 enabled여야 합니다.
• 점수부여 및 배지 규칙은 구성 요소가 배치된 페이지(또는 상위 페이지)에 적용되어야 합니다

이번 릴리스에는 세 가지 현상금이 걸려 있습니다.

• 골드

  /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

사용자 지정 배지

사용자 지정 배지는 배지 콘솔을 사용하여 설치하고 배지 규칙에 할당하거나 지정할 수 있습니다.

Badge 콘솔에서 설치되면 사용자 지정 배지가 게시 환경에 자동으로 복제됩니다.

점수 책정 활성화

기본적으로 점수는 활성화되지 않습니다. 배지 점수 책정 및 수상을 위한 기본 단계는 다음과 같습니다.

• 학습 포인트에 대한 규칙 식별(점수 규칙)

• 점수 규칙당 누적된 포인트에 대해 배지(배지 규칙)를 지정하십시오.

• 커뮤니티 사이트에 점수 및 배지 규칙 적용

• 커뮤니티 기능에 대한 배지 활성화

포럼 및 댓글에 대한 기본 점수 및 배지 규칙을 사용하여 커뮤니티 사이트에 대한 점수를 활성화하려면 빠른 테스트 섹션을 참조하십시오.

컨텐츠에 규칙 적용

점수부여 및 배지를 사용하려면 속성 scoringRules 및 badgingRules을 사이트의 컨텐츠 트리의 노드에 추가합니다.

사이트가 이미 게시되어 있는 경우, 모든 규칙을 적용하고 구성 요소를 활성화한 후 사이트를 다시 게시하십시오.

배지 사용 구성 요소에 적용되는 규칙은 현재 노드 또는 해당 조상에 대한 규칙입니다.

노드가 cq:Page (권장) 유형인 경우 CRXDE|Lite를 사용하여 속성을 해당 jcr:content노드에 추가합니다.

구성 요소에 대한 배지 활성화

점수부여 및 배지 규칙은 작성 모드에서 구성 요소 구성을 편집하여 배지를 활성화한 구성 요소의 인스턴스에만 적용됩니다.

부울 속성 allowBadges은 구성 요소 인스턴스에 대한 배지 표시를 활성화/비활성화합니다. 구성 요소 편집 대화 상자에서 포럼, QnA 및 배지 표시 확인란을 통해 구성 요소를 구성할 수 있습니다.

예: 포럼 구성 요소 인스턴스에 대한 allowBadge

점수 규칙

채점 규칙은 배지 수상을 위한 채점의 기초입니다.

매우 간단하게, 각 점수 규칙은 하나 이상의 하위 규칙 목록입니다. 배지가 활성화될 때 적용할 규칙을 식별하기 위해 커뮤니티 사이트 콘텐츠에 점수부여 규칙이 적용됩니다.

점수 규칙은 상속되지만 첨가제는 아닙니다. 예:

• page2에 점수부여 규칙2가 포함되어 있고 해당 상위 페이지1에 점수부여 규칙1이 포함되어 있는 경우

• page2 구성 요소에 대한 작업은 rule1과 rule2를 모두 호출합니다

• 두 규칙에 동일한 topic/verb에 대해 적용 가능한 하위 규칙이 포함되어 있는 경우:

  • rule2의 하위 규칙만 점수에 영향을 줍니다.
  • 두 하위 규칙의 점수는 함께 추가되지 않습니다

둘 이상의 점수 규칙이 있는 경우 각 규칙에 대해 점수가 별도로 유지됩니다.

점수 규칙은 cq:Page 유형의 노드로서 이 규칙을 정의하는 하위 규칙 목록을 지정하는 jcr:content 노드에 속성이 있습니다.

점수는 SRP에 저장됩니다.

점수 하위 규칙

점수 하위 규칙에는 커뮤니티에 참여할 값을 자세히 설명하는 속성이 포함됩니다.

각 점수 하위 규칙이 식별됨

• 추적 중인 활동
• 어떤 특정 커뮤니티 기능이 포함됩니까?
• 점수 몇 점을 받았습니까

하위 규칙이 컨텐츠의 소유자를 수신 포인트( forOwner)로 지정하지 않는 한 기본적으로 작업 수행 멤버에게 점수가 부여됩니다.

각 하위 규칙은 하나 이상의 점수 규칙에 포함될 수 있습니다.

하위 규칙의 이름은 일반적으로 subject, object 및 verb​를 사용하는 패턴을 따릅니다. 예:

• member-comment-create
• 회원 가입 투표

하위 규칙은 동사와 항목 을 지정하는 jcr:content노드에 속성이 있는 cq:Page 유형의 노드입니다.

점수 규칙 및 하위 규칙 포함

릴리스에는 포럼 함수에 대한 두 개의 점수 규칙이 포함됩니다(포럼 기능과 포럼 기능의 댓글 구성 요소에 대해 각각 하나씩).

1. /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

2. /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

  • 청동 배지는 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속성은 해당 특정 배지 규칙과 연결할 수 있는 점수 규칙을 제한합니다.

배지 규칙 포함

이 릴리스에는 포럼 및 댓글 점수 규칙에 해당하는 두 가지 배지 규칙이 포함됩니다.

• /etc/community/badging/rules/comments-badging
• /etc/community/badging/rules/forums-badging

메모:

• 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

사용자 지정 구성 요소에 대한 점수 및 배지

구성 요소에 대해 생성된 이벤트 항목을 동사와 연결하여 사용자 지정 구성 요소에 대해 점수 및 배지 규칙을 만들 수 있습니다.

항목 및 동사

구성원이 커뮤니티 기능과 상호 작용할 때 알림 및 점수 책정 등의 비동기 수신기를 트리거할 수 있는 이벤트가 전송됩니다.

구성 요소의 SocialEvent 인스턴스가 이벤트를 topic에 대해 발생하는 actions으로 기록합니다. SocialEvent에는 작업과 연결된 verb을 반환하는 메서드가 포함되어 있습니다. n-1 관계가 actions와 verbs 사이에 있습니다.

전달된 커뮤니티 구성 요소의 경우 다음 표에서는 점수 하위 규칙에서 사용할 수 있는 각 topic에 대해 정의된 verbs에 대해 설명합니다.

Calendar
ComponentSocialEvent topic= com/adobe/cq/social/calendar

댓글
ComponentSocialEvent topic= com/adobe/cq/social/comment

파일 라이브러리
ComponentSocialEvent topic= com/adobe/cq/social/fileLibrary

Forum
ComponentSocialEvent topic= com/adobe/cq/social/forum

저널
ComponentSocialEvent topic= com/adobe/cq/social/journal

QnA
ComponentSocialEvent topic = com/adobe/cq/social/qna

Review
ComponentSocialEvent topic= com/adobe/cq/social/review

등급
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 액세스

• 기본 페이지로 이동합니다.

  • /content/sites/engage/en/jcr:content

• badgingRules 속성을 추가합니다.

  • 이름: badgingRules
  • 유형: String
  • Multi 선택
  • 추가 선택
  • /etc/community/badging/rules/forums-badging 입력
  • 선택 +
  • /etc/community/badging/rules/comments-badging 입력
  • 확인 선택

• scoringRules 등록 정보를 추가합니다.

  • 이름: scoringRules
  • 유형: String
  • Multi 선택
  • 추가 선택
  • /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)

• 새 포럼 주제 게시

• 배지가 표시되려면 페이지를 새로 고쳐야 합니다

  • 다른 커뮤니티 구성원으로 로그아웃하고 로그인합니다(예: aaron.mcdonald@mailinator.com / password)

• 포럼 선택

이렇게 하면 첫 번째 포럼 배지 규칙의 첫 번째 임계값이 1로 인해 커뮤니티 멤버가 포럼 게시물에 표시되는 청동 배지를 받게 됩니다.

추가 정보

개발자를 위한 점수 및 배지 필수 패키지 페이지에서 자세한 정보를 찾을 수 있습니다.

고급 점수 엔진에 대한 자세한 내용은 고급 점수 및 배지를 참조하십시오.

구성 가능한 리드 보드 구성 요소 및 함수는 커뮤니티 사이트에서 구성원 및 해당 점수를 간편하게 표시할 수 있도록 해줍니다.