コミュニティのスコアとバッジ communities-scoring-and-badges

概要 overview

AEM Communitiesのスコアとバッジ機能を使用すると、コミュニティメンバーを特定し、報奨を与えることができます。

スコアとバッジの主な側面は次のとおりです。

注意 バッジの授与は デフォルトでは有効になっていません.

バッジ badges

バッジは、コミュニティ内での役割または地位を示すために、メンバーの名前の下に配置されます。 バッジは、画像として、または名前として表示できます。 画像として表示される場合、この名前はアクセシビリティのための代替テキストとして含まれます。

デフォルトでは、バッジは次の場所のリポジトリにあります。

別の場所に保存されている場合は、すべてのユーザーが読み取りアクセス可能である必要があります。

UGC では、バッジがルールに従って割り当てられたか、獲得されたかを区別します。 現在は、割り当てられたバッジがテキストとして表示され、獲得したバッジが画像として表示されます。

バッジ管理 UI badge-management-ui

コミュニティ バッジコンソール カスタムバッジを追加できます。カスタムバッジは、獲得時（与えられた時）またはコミュニティ内の特定の役割を引き受ける（割り当てられた時）に、メンバーに対して表示できます。

割り当てられたバッジ assigned-badges

ロールベースのバッジは、コミュニティ内での役割に基づいて、管理者がコミュニティメンバーに割り当てます。

割り当てられた（与えられた）バッジは、選択した SRP とは、直接アクセスできません。 GUI が使用できるようになるまで、ロールベースのバッジを割り当てる唯一の方法は、コードまたは cURL を使用して割り当てることです。 cURL の手順については、「 バッジの割り当てと取り消し.

このリリースには、次の 3 つの役割ベースのバッジが含まれています。

授与されたバッジ awarded-badges

報酬ベースのバッジは、コミュニティ内のアクティビティに適用されるルールに基づいて、スコア付けサービスによってコミュニティメンバーに付与されます。

アクティビティに対する報酬としてバッジを表示するには、次の 2 つの処理が必要です。

このリリースには、次の 3 つの報酬ベースのバッジが含まれています。

カスタムバッジ custom-badges

カスタムバッジは、 バッジコンソール バッジルールで割り当てるか、指定します。

バッジコンソールからインストールすると、カスタムバッジはパブリッシュ環境に自動的にレプリケートされます。

スコアリングを有効にする enable-scoring

スコアリングは、デフォルトでは有効になっていません。 スコア付けとバッジの授与を設定して有効にする基本的な手順は次のとおりです。

詳しくは、 クイックテスト セクションを開き、フォーラムとコメントのデフォルトのスコアルールとバッジルールを使用して、コミュニティサイトのスコアを有効にします。

コンテンツへのルールの適用 apply-rules-to-content

スコアとバッジを有効にするには、プロパティを追加します scoringRules および badgingRules を、サイトのコンテンツツリー内の任意のノードに追加します。

サイトが既に公開されている場合は、すべてのルールを適用してコンポーネントを有効にした後、サイトを再公開します。

バッジが有効なコンポーネントに適用されるルールは、現在のノードまたはその上位ノード用のルールです。

ノードのタイプがの場合 cq:Page （推奨）次に CRXDE|Lite を使用して、そのにプロパティを追加します。 jcr:content ノード。

コンポーネントのバッジを有効にする enable-badges-for-component

スコアルールとバッディングルールは、でコンポーネント設定を編集することでバッジを有効にしたコンポーネントのインスタンスに対してのみ有効です。 オーサリングモード.

ブール型のプロパティ allowBadgesコンポーネントインスタンスのバッジの表示を有効または無効にします。 これは、 コンポーネント編集ダイアログ フォーラム、Q&A、コメントの各コンポーネントの場合は、「 」チェックボックスを使用します。 バッジを表示.

例：フォーラムコンポーネントインスタンスの allowBadges example-allowbadges-for-forum-component-instance

スコアルール scoring-rules

スコアルールは、バッジを授与する際のスコアの基礎です。

各スコアルールは、1 つ以上のサブルールのリストです。 バッジが有効な場合に適用するルールを識別するために、スコアルールがコミュニティサイトのコンテンツに適用されます。

スコア付けルールは継承されますが、加算的ではありません。 次に例を示します。

複数のスコアルールがある場合、スコアは各ルールごとに個別に維持されます。

スコア付けルールは、 cq:Page プロパティを含む jcr:content 定義するサブルールのリストを指定するノード。

スコアは SRP に保存されます。

スコアサブルール scoring-sub-rules

スコア付けサブルールには、コミュニティに参加する値の詳細を示すプロパティが含まれます。

各スコアサブルールは、次を識別します。

デフォルトでは、サブルールでコンテンツの所有者がポイント ( forOwner) をクリックします。

各サブルールは、1 つ以上のスコアルールに含めることができます。

通常、サブルールの名前は、 件名, object、および 動詞. 次に例を示します。

サブルールはタイプのノードです cq:Page プロパティを含む jcr:content以下を指定するノード 動詞とトピック .

含まれるスコアルールとサブルール included-scoring-rules-and-sub-rules

このリリースには、 フォーラム機能 （フォーラム機能の「フォーラム」および「コメント」コンポーネント用にそれぞれ 1 つずつ）:

メモ：

カスタムスコアルールのアクティブ化 activating-custom-scoring-rules

オーサー環境でスコアルールやサブルールに対して行った変更や追加は、パブリッシュ環境にインストールする必要があります。

バッジルール badging-rules

バッジルールは、次の項目を指定することで、スコアルールをバッジにリンクします。

バッジルールはタイプのノードです cq:Page プロパティを含む jcr:content スコアルールをスコアおよびバッジに関連付けるノード。

バッジのルールは必須の thresholds バッジにマッピングされたスコアの順序付きリストであるプロパティ。 スコアは、値を増やすために並べ替える必要があります。 次に例を示します。

バッジルールは、ポイントの累積方法を決定するスコアルールと対になります。 「 」というタイトルの節を参照してください。 コンテンツへのルールの適用.

The scoringRules プロパティは、特定のバッジルールと対にできるスコアルールを制限するだけです。

含まれるバッジルール included-badging-rules

このリリースには、 フォーラムおよびコメントのスコア付けルール.

メモ：

カスタムバッジルールの有効化 activating-custom-badging-rules

オーサー環境でバッジルールや画像に加えた変更や追加は、すべてパブリッシュ環境にインストールする必要があります。

バッジの割り当てと取り消し assign-and-revoke-badges

バッジは、 メンバーコンソール または cURL コマンドをプログラムで使用する。

次の cURL コマンドは、バッジの割り当てと取り消しに HTTP リクエストで必要な処理を示します。 基本的な形式は次のとおりです。

cURL -i -XPOST-H ヘッダー -u サインイン -F 操作 -F バッジ member-profile-url

ヘッダー =サーバーに渡すカスタムヘッダー（必須）

サインイン = administrator-id:password 例： admin:admin

操作 = ":operation=social:assignBadge" OR ":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

例： examples

モデレーターバッジを割り当て assign-a-moderator-badge

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

割り当てられたシルバーバッジを取り消す revoke-an-assigned-silver-badge

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

カスタムコンポーネントのスコアとバッジ scoring-and-badges-for-custom-components

カスタムコンポーネントに対してスコアルールとバッジルールを作成するには、コンポーネント用に作成されたイベントトピックを動詞に関連付けます。

トピックと動詞 topics-and-verbs

メンバーがコミュニティ機能とやり取りすると、通知やスコアリングなどの非同期リスナーをトリガーにできるイベントが送信されます。

コンポーネントの SocialEvent インスタンスは、イベントを actions それは topic. SocialEvent には、 verb アクションに関連付けられています。 ここに n-1 ～間の関係 actions および verbs.

配信されるコミュニティコンポーネントについて、次の表で次の内容を説明します。 verbs それぞれに定義済み topic ～で使用できる スコア付けサブルール.

カレンダーコンポーネント
SocialEvent topic= com/adobe/cq/social/calendar

コメントコンポーネント
SocialEvent topic= com/adobe/cq/social/comment

ファイルライブラリコンポーネント
SocialEvent topic= com/adobe/cq/social/fileLibrary

フォーラムコンポーネント
SocialEvent topic= com/adobe/cq/social/forum

ジャーナルコンポーネント
SocialEvent topic= com/adobe/cq/social/journal

Q&A コンポーネント
SocialEvent topic = com/adobe/cq/social/qna

レビューコンポーネント
SocialEvent topic= com/adobe/cq/social/review

評価コンポーネント
SocialEvent topic= com/adobe/cq/social/tally/rating

投票コンポーネント
SocialEvent topic= com/adobe/cq/social/tally/voting

モデレートが有効なコンポーネント
SocialEvent topic= com/adobe/cq/social/moderation

カスタムコンポーネントイベント custom-component-events

カスタムコンポーネントの場合、 SocialEvent がインスタンス化され、コンポーネントのイベントが actions それは topic.

スコアリングをサポートするには、 SocialEvent でメソッドを上書きする必要があります getVerb() 適切な verb が返される action. The verb アクションに対して返されるのは、一般的に使用される ( POST) またはコンポーネント専用の ( 例えば、 ADD RATING) をクリックします。 ここに n-1 ～間の関係 actions および verbs.

トラブルシューティング troubleshooting

バッジが表示されません badges-are-not-appearing

スコアルールとバッジルールが Web サイトのコンテンツに適用されていて、どのアクティビティにもバッジが与えられていない場合は、そのコンポーネントのインスタンスに対してバッジが有効になっていることを確認します。

詳しくは、 コンポーネントのバッジを有効にする.

スコア付けルールは無効です scoring-rule-has-no-effect

スコアルールとバッジルールが Web サイトのコンテンツに適用され、一部のアクションにバッジが与えられ、他のアクションにはバッジが与えられない場合は、適用されるスコアルールがバッジルールによって制限されていないことを確認します。

詳しくは、 scoringRules のプロパティ バッジルール.

大文字と小文字の区別 case-sensitive-typo

プロパティや値のほとんど、特に動詞は、大文字と小文字が区別されます。 スコア付けサブルールで使用する場合、動詞はすべて大文字にする必要があります。

機能が期待どおりに動作しない場合は、データが正しく入力されていることを確認します。

クイックテスト quick-test

スコアとバッジをすばやく試すには、 入門チュートリアル （エンゲージメント）サイト：

次に、フォーラムとコメントのコンポーネントでバッジを表示できることを確認します。

次に、 再公開 コミュニティサイトです。

最後に

これにより、コミュニティメンバーは、最初のフォーラムバッジルールの最初のしきい値がスコア 1 なので、フォーラム投稿でブロンズバッジを表示できます。

追加情報 additional-information

詳しくは、 スコアとバッジの基本事項 開発者向けのページ

高度なスコアエンジンについて詳しくは、 高度なスコアとバッジ.

設定可能なリーダーボード コンポーネント および 関数 は、コミュニティサイトでのメンバーとそのスコアの表示を簡素化します。