得分和徽章基本工具

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 Console記錄檔支援,例如

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

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

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

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

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

debug-scoring-log

要查看日誌條目:

  • 從Web Console

    • 在​狀態​菜單下
    • 選擇​日誌檔案
    • 搜索日誌檔案名,如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。

發佈時的JSRP:同樣地,如果在發佈環境上進行測試,則必須以發佈實例的管理權限訪問CRXDE Lite。如果發佈實例在生產模式(nosamplecontent runmode)中運行,則需要啟用CRXDE Lite

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

計分和標籤API

下列API可供使用:

Adobe儲存庫的開發人員可使用已安裝功能套件的最新Javadoc。 請參閱使用Maven for Communities:Javadocs

UGC在儲存庫中的位置和格式可能會變更,但不會發出警告

安裝示例

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

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

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

    • 找到論壇頁面節點

      /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. AEM網站​不含​唯一ID:

    • 使用社群元件指南

    • 找到論壇頁面節點

      /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/scorning/rules/site1/forums-scorning
/libs/settings/community/scornimy/rules/site2/forums-scorning

  • 為不同的AEM網站建立獨特的徽章影像

訪問計分UGC

建議使用API

為了調查目的,在範例中使用JSRP,包含分數的基本資料夾是

  • /content/usergenerated/asi/jcr/scoring

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

對於Geometrixx Engage網站,使用者及其分數位於路徑中,路徑包含計分規則名稱、社群網站的網站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

獎章

榮獲徽章

已指派徽章

已指派徽章

其他資訊

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

本頁內容

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now