計分和徽章要點

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

如需設定功能的詳細資訊,請參閱

本頁包含其他技術詳細資訊:

注意

CRXDE Lite中可見的實作結構可能會有所變更。

顯示徽章

徽章是否顯示為文字或影像,在HBS範本的用戶端進行控制。

例如,在/libs/social/forum/components/hbs/topic/list-item.hbs中搜尋this.isAssigned:

{{#each author.badges}}

  {{#if this.isAssigned}}

    <div class="scf-badge-text">

      {{this.title}}

    </div>

  {{/if}}

{{/each}}

{{#each author.badges}}

  {{#unless this.isAssigned}}

    <img class="scf-badge-image" alt="{{this.title}}" title="{{this.title}}" src="{{this.imageUrl}}" />

  {{/unless}}

{{/each}}

如果為true, isAssigned表示已為角色分配徽章,且徽章應顯示為文本。

如果為false,則為「已分配」表示已為已獲得分數授予徽章,且徽章應顯示為影像。

對此行為所做的任何變更都應在自訂指令碼中進行(覆寫或覆蓋)。 請參閱用戶端自訂

計分和簽名的調試日誌

若要協助除錯計分和標籤,可設定自訂記錄檔。 如果此功能出現問題,則此日誌檔案的內容將提供給客戶支援。

有關詳細說明,請訪問建立自定義日誌檔案

若要快速設定slinglog檔案:

  1. 存取​Adobe Experience Manager Web控制台日誌支援,例如

    • https://localhost:4502/system/console/slinglog
  2. 選擇​添加新記錄器

    1. 為​日誌級別​選擇DEBUG

    2. 輸入​日誌檔案​的名稱,例如

      • logs/scoring-debug.log
    3. 輸入兩個​記錄器(類)條目(使用+表徵圖)

      • com.adobe.cq.social.scoring
      • com.adobe.cq.social.badging
    4. 選擇​保存

debug-scoring-log

要查看日誌條目,請執行以下操作:

  • 從Web控制台

    • 在​狀態​菜單下
    • 選擇​日誌檔案
    • 搜索日誌檔案名,例如scoring-debug
  • 在伺服器的本地磁碟上

    • 日誌檔案位於<server-install-dir>/crx-quickstart/logs/<log-file-name>.log

    • 例如, .../crx-quickstart/logs/scoring-debug.log

計分日誌

UGC用於計分和標籤

當選擇的SRP是JSRP或MSRP,但不是ASRP時,可以查看與計分和徽章相關的UGC。 (如果不熟悉這些術語,請參閱社區內容儲存儲存資源提供程式概述。)

存取計分和加號資料的說明使用JSRP,因為UGC可透過CRXDE Lite輕鬆存取。

JSRP關於作者:在製作環境中實驗會導致UGC,而此UGC僅可從製作環境中看到。

發佈JSRP:同樣地,如果在發佈環境上進行測試,則需要以發佈例項的管理權限存取CRXDE Lite。如果發佈執行個體在生產模式(nosamplecontent執行模式)中執行,則必須啟用CRXDE Lite

UGC在JSRP上的基本位置為/content/usergenerated/asi/jcr/

計分與加號API

下列API可供使用:

已安裝Feature Pack的最新Javadoc可供Adobe存放庫的開發人員使用。 請參閱使用Maven for Communities :Javadocs

UGC在存放庫中的位置和格式可能會變更,恕不另行警告

示例設定

存放庫資料的螢幕擷取畫面來自為兩個不同AEM網站上的論壇設定計分和標籤:

  1. 具有唯一id的AEM網站​(使用精靈建立的社群網站):

    • 使用在快速入門教學課程期間建立的快速入門教學課程(參與)網站

    • 找到論壇頁面節點

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

    • 添加計分和標籤屬性

    scoringRules = [/libs/settings/community/scoring/rules/comments-scoring,
    /libs/settings/community/scoring/rules/forums-scoring]
    
    badgingRules =[/libs/settings/community/badging/rules/comments-scoring,
    /libs/settings/community/badging/rules/forums-scoring]
    
    • 找到論壇元件節點

      /content/sites/engage/en/forum/jcr:content/content/primary/forum
      ( sling:resourceType = social/forum/components/hbs/forum)

    • 新增屬性以顯示徽章

      allowBadges = true

    • 使用者登入、建立論壇主題,並獲得銅牌

  2. 沒有​唯一ID的AEM網站 :

    • 使用社群元件指南

    • 找到論壇頁面節點

      /content/community-components/en/forum/jcr:content

    • 添加計分和標籤屬性

    scoringRules = [/libs/settings/community/scoring/rules/comments-scoring,
    /libs/settings/community/scoring/rules/forums-scoring]
    
    badgingRules =[/libs/settings/community/badging/rules/comments-badging,
    /libs/settings/community/badging/rules/forums-badging]
    
    • 找到論壇元件節點

      /content/community-components/en/forum/jcr:content/content/forum
      ( sling:resourceType = social/forum/components/hbs/forum)

    • 新增屬性以顯示徽章

      allowBadges = true

    • 使用者登入、建立論壇主題,並獲得銅牌

  3. 使用cURL為使用者指派協調者徽章:

    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" https://localhost:4503/home/users/community/w271OOup2Z4DjnOQrviv/profile.social.json
    

    由於使用者已獲得兩個銅牌,並且已獲得版主徽章,因此這是使用者在論壇項目中的顯示方式。

    版主

注意

此範例不遵循下列最佳實務:

  • 計分規則名稱應為全域唯一;它們的結尾不應該是同一個名稱。

not​要執行的動作範例:

/libs/settings/community/scoring/rules/site1/forums計分
/libs/settings/community/scoring/rules/site2/forums計分

  • 為不同的AEM網站建立不重複徽章影像

訪問計分UGC

建議使用API

為了調查目的,以JSRP為例,包含分數的基本資料夾為

  • /content/usergenerated/asi/jcr/scoring

scoring的子節點是計分規則名稱。 因此,最佳實務是,伺服器上的計分規則名稱是全域唯一的。

對於Geometrixx參與網站,使用者及其分數位於包含計分規則名稱、社群網站網站id(engage-ba81p)、唯一id及使用者id的路徑中:

  • .../scoring/forums-scoring/engage-ba81p/6d179715c0e93cb2b20886aa0434ca9b5a540401/riley

對於社群元件指南網站,使用者及其分數位於以計分規則名稱、預設ID(default-site)、唯一ID及使用者ID所建構的路徑中:

  • .../scoring/forums-scoring/default-site/b27a17cb4910a9b69fe81fb1b492ba672d2c086e/riley

分數儲存在屬性scoreValue_tl中,該屬性可能直接包含值或間接引用atomicCounter。

access-scoring-ugc

訪問標籤UGC

建議使用API

為了調查目的,以JSRP為例,包含已指派或已授予徽章之資訊的基本資料夾為

  • /content/usergenerated/asi/jcr

後接使用者設定檔的路徑,結尾為徽章資料夾,例如:

  • /home/users/community/w271OOup2Z4DjnOQrviv/profile/badges

獎勵徽章

獎 — 徽 — ugc

已分配徽章

指派徽章

其他資訊

要根據點顯示按排序的成員清單,請執行以下操作:

  • 排行榜 功能,可包含在社群網站或群組範本中。
  • 編寫頁面時,須使用排行榜元件(排行榜功能的精選元件)。

本頁內容