AEM Communities評分和徽章功能提供識別及獎勵社群成員的能力。
評分和徽章的主要方面包括:
注意 獎勵徽章是 預設為未啟用.
UI可供使用時,CRXDE Lite中顯示的實作結構可能會有所變更。
徽章會放置在成員的名稱下,以表示其在社群中的角色或地位。 徽章可以顯示為影像或名稱。 當顯示為影像時,名稱會包含為協助工具的替代文字。
依預設,徽章位於以下位置的存放庫中:
/libs/settings/community/badging/images
若儲存在其他位置,應讓每個人都可讀取這些檔案。
在UGC中會區分徽章,不論它們是依照規則指派或贏取。 目前,指派的徽章會顯示為文字,而贏取的徽章會顯示為影像。
社群 徽章主控台 可讓您新增自訂徽章,當成員贏取(授予)或在社群中擔任特定角色(已指派)時,徽章會針對該成員顯示。
管理員會根據社群成員在社群中的角色,為其指派角色型徽章。
指派(和授予)徽章會儲存在選取的 SRP 和無法直接存取。 在GUI可用之前,指派角色型徽章的唯一方法是使用程式碼或cURL。 如需cURL指示,請參閱標題為 指派和撤銷徽章.
此版本包含三個角色型徽章:
版主
/libs/settings/community/badging/images/moderator/jcr:content/moderator.png
群組管理員
/libs/settings/community/badging/images/group-manager/jcr:content/group-manager.png
有特殊許可權的成員
/libs/settings/community/badging/images/privileged-member/jcr:content/privileged-member.png
評分服務會根據社群成員活動中套用的規則,將獎勵型徽章授予社群成員。
若要讓徽章顯示為活動的獎勵,必須發生以下兩個情況:
此版本包含三個獎勵型徽章:
金級
/libs/settings/community/badging/images/gold-badge/jcr:content/gold.png
銀級
/libs/settings/community/badging/images/silver-badge/jcr:content/silver.png
銅級
/libs/settings/community/badging/images/bronze-badge/jcr:content/bronze.png
評分規則可設定為針對標籤為不適當的貼文指派負分,進而影響評分值。 不過,獲得徽章後,由於評分點減少或評分規則變更,該徽章將不會自動移除。
獎勵徽章的撤銷方式與指派徽章相同。 請參閱 指派和撤銷徽章 區段。 未來的改善專案將包括管理成員徽章的UI。
自訂徽章可使用進行安裝 徽章主控台 並在徽章規則中指派或指定。
從「徽章」控制檯安裝後,自訂徽章會自動複製到發佈環境。
預設不會啟用評分。 設定及啟用徽章評分和獎勵的基本步驟為:
識別學習點數規則(評分規則)。
請參閱 快速測試 區段,使用論壇和評論的預設評分和徽章規則,為社群網站啟用評分。
若要啟用評分和徽章,請新增屬性 scoringRules
和 badgingRules
至網站內容樹狀結構中的任何節點。
如果網站已發佈,請在套用所有規則並啟用元件後,重新發佈網站。
套用至已啟用徽章的元件的規則為目前節點或其上階的規則。
如果節點的型別 cq:Page
(建議),然後使用CRXDE|Lite,將屬性新增至其 jcr:content
節點。
屬性 | 類型 | 說明 |
---|---|---|
badgingrules | 字串 | 的陣列清單 徽章規則 |
scoringRules | 字串 | 的陣列清單 評分規則 |
如果評分規則似乎對獎勵徽章沒有影響,請確保該評分規則並未被徽章規則的scoringRules屬性封鎖。 請參閱標題為的一節 徽章規則.
評分和徽章規則僅適用於已透過編輯元件設定來啟用徽章的元件例項。 製作模式.
布林值屬性, allowBadges
,啟用/停用元件例項的徽章顯示。 它可在以下位置設定: 元件編輯對話方塊 用於論壇、QnA和評論元件,透過標籤為的核取方塊 顯示徽章.
以論壇、QnA和評論中的HBS程式碼為例,任何元件都可以重疊以顯示徽章。
評分規則是獎勵徽章評分的基礎。
每個評分規則都是一或多個子規則的清單。 評分規則會套用至社群網站內容,以識別啟用徽章時要套用的規則。
評分規則是繼承的,但不會累加。 例如:
如果頁面2包含評分規則2,且其上階page1包含評分規則1。
page2元件上的動作會同時叫用rule1和rule2。
如果兩個規則包含相同專案的適用子規則 topic/verb
:
有多個評分規則時,系統會分別維護每個規則的分數。
評分規則是型別的節點 cq:Page
具有屬性 jcr:content
指定定義其之子規則清單的節點。
分數會儲存在SRP中。
最佳實務:為各個評分規則指定唯一名稱。
評分規則名稱應為全域唯一名稱,且不得以相同名稱結尾。
的範例 非 待辦事項:
/libs/settings/community/scoring/rules/site1/forums-scoring
/libs/settings/community/scoring/rules/site2/forums-scoring
評分子規則包含詳細說明參與社群之值的屬性。
每個評分子規則都會識別:
依預設,點數會授予採取動作的成員,除非子規則將內容的所有者指定為接收點數( forOwner
)。
每個子規則可包含在一或多個評分規則中。
子規則的名稱通常會遵循使用的模式 主旨, 物件、和 動詞. 例如:
子規則是型別的節點 cq:Page
具有屬性 jcr:content
指定下列專案的節點: 動詞和主題 .
屬性 | 類型 | 值說明 |
---|---|---|
VERB |
長整數 |
|
topics |
字串 |
|
forOwner |
布林值 |
|
scoringType |
字串 |
|
此版本包含的兩個評分規則: 論壇功能 (論壇功能的「論壇」和「評論」元件各一個) :
/libs/settings/community/scoring/rules/comments-scoring
/libs/settings/community/scoring/rules/forums-scoring
附註:
兩者 rules
和 sub-rules
節點的型別為cq:Page。
subRules
是String型別的屬性[] 在規則的 jcr:content
節點。
sub-rules
可以在各種評分規則之間共用。
rules
應該位在儲存庫位置,且每個人都有讀取許可權。
在製作環境中對評分規則或子規則所做的任何變更或新增都必須安裝在發佈上。
徽章規則透過指定以下內容,將評分規則連結至徽章:
徽章規則是型別的節點 cq:Page
具有屬性 jcr:content
將評分規則與分數和徽章建立關聯的節點。
徽章的規則包含必要 thresholds
對應至徽章的分數有序清單屬性。 分數必須依遞增值排序。 例如:
1|/libs/settings/community/badging/images/bronze-badge/jcr:content/bronze.png
60|/libs/settings/community/badging/images/silver-badge/jcr:content/silver.png
80|/libs/settings/community/badging/images/gold-badge/jcr:content/gold.png
徽章規則會與評分規則配對,這會決定如何累積分數。 請參閱標題為的一節 套用規則至內容.
此 scoringRules
徽章規則的屬性只會限制哪些評分規則可以與該特定徽章規則配對。
最佳做法:建立每個AEM網站專屬的徽章影像。
屬性 | 類型 | 值說明 |
---|---|---|
臨界值 | 字串 | (必要) 「數字|路徑」形式的多值字串
範例專案: 80|/libs/settings/community/badging/images/gold-badge/jcr:content/gold.png |
badgingtype | 字串 | (選擇性) 將評分引擎識別為「基本」或「進階」。 如果需要進階評分引擎,請參閱 進階評分和徽章. 預設值為「basic」。 |
scoringRules | 字串 | (可選)多值字串,可將徽章規則限製為評分規則所識別的評分事件 |
發行版本中包含兩個徽章規則,分別對應至 論壇和評論評分規則.
/libs/settings/community/badging/rules/comments-badging
/libs/settings/community/badging/rules/forums-badging
附註:
rules
節點的型別為cq:Page。
rules
應該位在儲存庫位置,且每個人都有讀取許可權。
在製作環境中對徽章規則或影像所做的任何變更或新增都必須安裝在發佈上。
您可以使用以下任一專案將徽章指派給成員: 成員主控台 或使用cURL命令以程式設計方式執行。
以下cURL命令顯示指派和撤銷徽章的HTTP要求所需的專案。 基本格式為:
cURL -i -XPOST-H 頁首 -u 登入 -F 操作 -F 徽章 member-profile-url
頁首 = "Accept:application/json"自訂標題以傳遞至伺服器(必填)
登入 = administrator-id:password,例如admin:admin
操作 = ":operation=social:assignBadge"或":operation=social:deleteBadge"
徽章 = "badgeContentPath=badge-image-file"
badge-image-file =徽章影像檔案在存放庫中的位置,例如/libs/settings/community/badging/images/moderator/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=/libs/settings/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=/libs/settings/community/badging/images/silver/jcr:content/silver.png" /home/users/community/updcs9DndLEI74DB9zsB/profile.social.json
使用cURL來指派和撤銷徽章適用於任何徽章影像,但是當指派而不是贏取時,會將其標籤為已指派徽章並進行相應處理。
將針對自訂元件建立的事件主題與動詞建立關聯,可為其建立評分和徽章規則。
當成員與社群功能互動時,會傳送可觸發非同步接聽程式的事件,例如通知和評分。
元件的SocialEvent例項會將事件記錄為 actions
發生於 topic
. SocialEvent包含傳回 verb
與動作相關聯。 有一個 n-1 關係介於 actions
和 verbs
.
針對已傳送的communities元件,下表說明 verbs
已針對每個專案定義 topic
可在以下位置使用: 評分子規則.
新的布林值屬性, allowBadges
,啟用/停用元件例項的徽章顯示。 可在更新後設定 元件編輯對話方塊 透過標籤為的核取方塊 顯示徽章.
行事曆元件
社交事件 topic
= com/adobe/cq/social/calendar
動詞 | 說明 |
---|---|
POST | 成員建立行事曆事件 |
新增 | 行事曆事件的成員註解 |
更新 | 成員的行事曆事件或註解已編輯 |
刪除 | 成員的行事曆事件或註解已刪除 |
註解元件
社交事件 topic
= com/adobe/cq/social/comment
動詞 | 說明 |
---|---|
POST | 成員建立註解 |
新增 | 成員回複評論 |
更新 | 成員的註解已編輯 |
刪除 | 已刪除成員的註解 |
檔案庫元件
社交事件 topic
= com/adobe/cq/social/fileLibrary
動詞 | 說明 |
---|---|
POST | 成員建立資料夾 |
附加 | 成員上傳檔案 |
更新 | 成員更新資料夾或檔案 |
刪除 | 成員刪除資料夾或檔案 |
論壇元件
社交事件 topic
= com/adobe/cq/social/forum
動詞 | 說明 |
---|---|
POST | 成員建立論壇主題 |
新增 | 成員對論壇主題的回覆 |
更新 | 成員的論壇主題或回覆已編輯 |
刪除 | 已刪除成員的論壇主題或回覆 |
日誌元件
社交事件 topic
= com/adobe/cq/social/journal
動詞 | 說明 |
---|---|
POST | 成員建立部落格 |
新增 | 部落格上的成員評論 |
更新 | 已編輯成員的部落格或評論 |
刪除 | 已刪除成員的部落格或評論 |
QnA元件
社交事件 topic
= com/adobe/cq/social/qna
動詞 | 說明 |
---|---|
POST | 成員建立QnA問題 |
新增 | 成員建立QnA答案 |
更新 | 編輯成員的QnA問題或答案 |
選取 | 已選取成員的答案 |
取消選取 | 已取消選取成員的答案 |
刪除 | 已刪除成員的QnA問題或答案 |
稽核元件
社交事件 topic
= com/adobe/cq/social/review
動詞 | 說明 |
---|---|
POST | 成員建立稽核 |
更新 | 成員的稽核已編輯 |
刪除 | 已刪除成員的評論 |
評等元件
社交事件 topic
= com/adobe/cq/social/tally/rating
動詞 | 說明 |
---|---|
新增評等 | 已對成員的內容進行升級 |
移除評等 | 成員的內容已降級 |
投票元件
社交事件 topic
= com/adobe/cq/social/tally/voting
動詞 | 說明 |
---|---|
新增投票 | 成員內容已投贊成票 |
移除投票 | 成員內容已被投票否決 |
啟用稽核的元件
社交事件 topic
= com/adobe/cq/social/moderation
動詞 | 說明 |
---|---|
拒絕 | 成員內容遭拒 |
如有不當情形,加註旗標 | 已標幟成員的內容 |
如有不當情形,取消標幟 | 成員的內容未標幟 |
ACCEPT | 仲裁者已核准成員的內容 |
關閉 | 成員關閉評論以進行編輯和回覆 |
開啟 | 成員重新開啟註解 |
對於自訂元件,會例項化SocialEvent以將元件的事件記錄為 actions
發生於 topic
.
若要支援評分,SocialEvent需要覆寫方法 getVerb()
因此適當的 verb
針對每個屬性傳回 action
. 此 verb
針對動作傳回的可能是常用的(例如 POST
)或專用於元件的元件(例如 ADD RATING
)。 有一個 n-1 關係介於 actions
和 verbs
.
如果評分和徽章規則已套用至網站的內容,但未針對任何活動授與徽章,請確定已為該元件的執行個體啟用徽章。
另請參閱 啟用元件的預算.
如果評分和徽章規則已套用至網站的內容,且已針對某些動作(而非其他動作)授與徽章,請檢查徽章規則是否未限制其套用的評分規則。
請參閱 scoringRules
屬性 徽章規則.
大部分的屬性和值(尤其是動詞)都區分大小寫。 在評分子規則中使用動詞時,動詞必須全部大寫。
如果功能無法如預期運作,請確認資料已正確輸入。
您可以使用快速嘗試評分和徽章 快速入門教學課程 (參與)網站:
存取作者的CRXDE Lite。
瀏覽至基本頁面:
新增badgingRules屬性:
badgingRules
String
/libs/settings/community/badging/rules/forums-badging
/libs/settings/community/badging/rules/comments-badging
新增scoringRules屬性:
scoringRules
String
/libs/settings/community/scoring/rules/forums-scoring
/libs/settings/community/scoring/rules/comments-scoring
選取 全部儲存.
接下來,確定論壇和評論元件允許顯示徽章:
再次使用CRXDE Lite。
瀏覽至論壇元件
/content/sites/engage/en/forum/jcr:content/content/primary/forum
如有必要,請新增allowBadges布林值屬性,並確保其為true。
allowBadges
Boolean
true
下一個, 重新發佈 社群網站。
最後,
瀏覽至發佈執行個體上的元件。
以社群成員身分登入(例如,weston.mccall@dodgit.com /密碼)。
發表新論壇主題。
頁面必須重新整理才能顯示徽章。
選取論壇。
由於第一個論壇徽章規則的第一個臨界值是1分,這應該會為社群成員贏取可透過其論壇貼文看到的銅級徽章。
如需詳細資訊,請參閱 評分和徽章要點 開發人員頁面。
如需進階評分引擎的詳細資訊,請參閱 進階評分和徽章.