社群計分和徽章

概覽

AEM Communities計分和徽章功能提供識別和獎勵社群成員的能力。

評分和徽章的主要方面是：

• 指 派徽章以識別成員在社區中的角色

• 基本獎勵 成員以鼓勵其參與（建立的內容數量）

• 高級授予徽 章，以將成員確定為專家（建立的內容質量）

​​請注意，預設不 會啟用徽章獎勵。

徽章

徽章會放置在成員的名下，以指出其角色或在社群中的地位。 徽章可以顯示為影像或名稱。 顯示為影像時，名稱會包含為協助工具的替代文字。

預設情況下，徽章位於存放庫的

• /etc/community/badging/images

如果儲存在不同的位置，則每個人都應該可以讀取這些內容。

徽章在UGC中區別於是指定的徽章，還是根據規則掙得的徽章。 當前，已分配的徽章以文本形式顯示，而已獲得的徽章以影像形式顯示。

徽章管理UI

Communities 徽章控制台提供添加自定義徽章的功能，該徽章可在獲得（授予）成員或成員在社區中承擔特定角色（已分配）時顯示。

指派的徽章

管理員會根據社群中的角色，將角色型徽章指派給社群成員。

已分配（和已喚醒）的徽章儲存在所選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

獎章

評分服務會根據套用至社群中活動的規則，將基於獎勵的徽章授予社群成員。

為了讓徽章顯示為活動的獎勵，必須執行下列兩項操作：

• 對於功能元件，標籤必須為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

自訂徽章

可使用徽章控制台安裝自訂徽章，並在徽章規則中指派或指定。

從徽章控制台安裝時，自訂徽章會自動複製到發佈環境。

啟用計分

預設未啟用計分。 設定及啟用徽章評分與獎勵的基本步驟為：

• 識別收入點規則（計分規則）

• 針對每個分數規則累計的點數，指派徽章（徽章規則）

• 將分數和徽章規則套用至社群網站

• 啟用社區功能的簽名

請參閱快速測試區段，使用論壇和評論的預設評分和徽章規則為社群網站啟用評分。

將規則套用至內容

要啟用計分和徽章，請將屬性scoringRules和badgingRules添加到站點內容樹中的任何節點。

如果網站已發佈，在套用所有規則並啟用元件後，請重新發佈網站。

適用於啟用徽章的元件的規則是當前節點或其上階的規則。

如果節點的類型為cq:Page（建議），則使用CRXDE|Lite將屬性添加到其jcr:content節點。

為元件啟用徽章

只有在編寫模式中編輯元件配置以啟用標籤的元件的實例，計分和標籤規則才有效。

布林屬性allowBadges啟用/禁用元件實例的徽章顯示。 可在論壇、QnA的元件編輯對話框中，通過標籤為​顯示徽章​的複選框配置它並注釋元件。

範例：論壇元件例項的allowBadges

計分規則

評分規則是評分的基礎，用於授予徽章。

很簡單，每個分數規則都是一或多個子規則的清單。 計分規則會套用至社群網站內容，以識別在啟用徽章時要套用的規則。

分數規則是繼承的，但不是加性的。 例如：

• 如果page2包含計分規則2，其上階page1包含計分規則1

• page2元件上的動作將同時叫用rule1和rule2

• 如果兩個規則都包含相同topic/verb的適用子規則：

  • 只有規則2的子規則會影響分數
  • 兩個子規則的分數不會加在一起

當有多個計分規則時，會針對每個規則分別維護分數。

計分規則是類型cq:Page的節點，其jcr:content節點上具有指定定義該節點的子規則的清單的屬性。

分數會儲存在SRP中。

計分子規則

分數子規則包含詳細說明參與社群之值的屬性。

每個計分子規則識別

• 正在追蹤哪些活動
• 涉及哪些特定的社區功能
• 分數

預設情況下，除非子規則指定接收點的內容所有者(forOwner)，否則將向採取操作的成員授予點。

每個子規則可以包含在一個或多個計分規則中。

子規則的名稱通常遵循使用​主旨、物件​和​verb​的模式。 例如：

• member-comment-create
• 成員接受表決

子規則是類型cq:Page的節點，其jcr:content節點上包含指定動詞和主題的屬性。

包含計分規則和子規則

此發行包含論壇功能的兩個計分規則（論壇功能的論壇和評論元件各一個）:

1. /etc/community/scoring/rules/comments計分

   • subRules[] =

     /etc/community/scoring/rules/subrules/member-comment-create

     /etc/community/scoring/rules/sub rules/member-receive-vote

     /etc/community/scoring/rules/subrules/member-give-tope

     /etc/community/scoring/rules/subrules/member-is-readed

2. /etc/community/scoring/rules/forums計分

   • subRules[] =

     /etc/community/scoring/rules/subrules/member-forum-create

     /etc/community/scoring/rules/sub rules/member-receive-vote

     /etc/community/scoring/rules/subrules/member-give-tope

     /etc/community/scoring/rules/subrules/member-is-readed

附註:

• rules和sub-rules節點都屬於cq:Page類型

• subRules是規則節點[] 字串類型的屬 jcr:content 性

• sub-rules 可在各種計分規則之間共用

• 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屬性僅限於哪些評分規則可以與該特定徽章規則配對。

包含徽章規則

此發行包含與論壇和留言計分規則對應的兩個標籤規則。

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

附註:

• rules 節點類型為cq:Page

• rules應位於具有每個人讀取權限的儲存庫位置

  • 規則名稱必須是唯一的，無論位置為何

啟用自訂徽章規則

在製作環境中對標籤規則或影像所做的任何變更或新增，都必須安裝在發佈上。

指派和撤銷徽章

可以使用members console或使用cURL命令以寫程式方式為成員分配徽章。

下列cURL命令顯示指派和撤銷徽章的HTTP要求所需的項目。 基本格式為：

cURL -i -XPOST-H header -u *signin * -F *operation * -F *badge * 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 =徽章影像檔案在存放庫中的位置
例如：/etc/community/badging/images/daldorator/jcr: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的方法。 actions和verbs之間存在​n-1​關係。

對於傳遞的社群元件，下表描述為每個topic定義的verbs，這些可用於計分子規則。

日
歷元件 topicSocialEvent = com/adobe/cq/social/calendar

注
釋ComponentSocialEvent topic= com/adobe/cq/social/comment

檔案
程式庫 topic元件SocialEvent = com/adobe/cq/social/fileLibrary

論
壇元 topic件SocialEvent = com/adobe/cq/social/forum

日
記帳元 topic件SocialEvent = com/adobe/cq/social/journal

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

審
閱ComponentSocialEvent topic= com/adobe/cq/social/review

評
分ComponentSocialEvent topic= com/adobe/cq/social/tally/rating

投票
元件 topicSocialEvent = com/adobe/cq/social/tally/voting

已啟用協
調的元 topic件SocialEvent = com/adobe/cq/social/moderation

自訂元件事件

對於自訂元件，會實例化SocialEvent，將元件的事件記錄為actions，該事件會針對topic而發生。

為了支援計分，SocialEvent需要覆寫方法getVerb()，以便為每個action傳回適當的verb。 針對動作傳回的verb可為常用的POST，或專用於元件的ADD RATING。 actions和verbs之間存在​n-1​關係。

疑難排解

徽章未顯示

如果已將分數和徽章規則套用至網站的內容，但未察覺任何活動的徽章，請確定已為該元件的例項啟用徽章。

請參閱啟用元件的徽章。

計分規則無效

如果已對網站的內容應用了計分和徽章規則，並且為某些操作（但不為其他操作）授予徽章，請檢查徽章規則是否未限制其應用的計分規則。

請參閱標籤規則的scoringRules屬性。

區分大小寫類型

大部分的屬性和值（尤其是動詞）都區分大小寫。 在計分子規則中使用動詞時，必須全部大寫。

如果功能未如預期運作，請確定資料已正確輸入。

快速測試

您可以使用快速入門教學課程（參與）網站，快速嘗試計分和標籤：

• 作者的存取CRXDE Lite

• 瀏覽到基頁：

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

• 新增badgingRules屬性：

  • 名稱: badgingRules
  • 類型: String
  • 選擇​多
  • 選擇​添加
  • 輸入/etc/community/badging/rules/forums-badging
  • 選取 +
  • 輸入/etc/community/badging/rules/comments-badging
  • 選擇​OK

• 添加scorinRules屬性：

  • 名稱: scoringRules
  • 類型: String
  • 選擇​多
  • 選擇​添加
  • 輸入/etc/community/scoring/rules/forums-scoring
  • 選取 +
  • 輸入/etc/community/scoring/rules/comments-scoring
  • 選擇​OK

• 選擇​保存全部

接下來，請確定論壇和注釋元件允許顯示徽章：

• 再次使用CRXDE Lite

• 瀏覽至論壇元件

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

• 如有必要，請新增allowBadges布林屬性，並確定為true

  • 名稱: allowBadges
  • 類型: Boolean
  • 值: true

接下來，重新發佈社群網站。

最後，

• 瀏覽至發佈執行個體上的元件

• 以社群成員身分登入(例如：weston.mccall@dodgit.com /密碼)

• 張貼新論壇主題

• 必須重新整理頁面才會顯示徽章

  • 登出並以不同社群成員身分登入(例如：aaron.mcdonald@mailinator.com /密碼)

• 選擇論壇

這應該能為社群成員爭取到銅牌，因為第一個論壇徽章規則的第一個臨界值是1分，可在論壇貼文上看到。

其他資訊

如需詳細資訊，請參閱開發人員的計分和徽章要點頁面。

有關高級計分引擎的資訊，請參閱高級計分和徽章。

可配置的排行榜元件和函式簡化了成員及其在社區站點上的分數的顯示。

Business.Adobe.com 資源

Cms Cloud Content Intelligence Personalized Communications Mobile Forms Theme Editor Dynamic Forms