AEM Communities のスコアおよびバッジ機能を使用すると、コミュニティメンバーを分類して報奨を与えることができます。
スコアとバッジの主な要素を以下に示します。
バッジを割り当て コミュニティ内のメンバーの役割を特定するには
バッジの基本的な授与 メンバーの参加を奨励するために(作成されたコンテンツの数量)
バッジの高度な授与 メンバーをエキスパートとして識別する(作成されたコンテンツの質)
注意 バッジの授与は デフォルトでは有効になっていません.
CRXDE Lite で表示される実装の構造は、UI が使用可能になると変化する場合があります。
バッジはコミュニティ内でのメンバーの役割または地位を表すためのもので、メンバーの名前の下に配置されます。バッジは、画像として、または名前として表示できます。 画像として表示される場合、この名前はアクセシビリティのための代替テキストとして含まれます。
デフォルトでは、バッジは次の場所のリポジトリに配置されます。
別の場所に格納する場合は、バッジに誰でもアクセスできるようにする必要があります。
UGC 内では、割り当てられたバッジと、ルールに従って獲得されたバッジが区別されます。現在は、割り当てられたバッジがテキストとして表示され、獲得したバッジが画像として表示されます。
コミュニティ バッジコンソール は、獲得(与えられる)時やコミュニティで特定の役割を担う(割り当てられる)時に、メンバーに対して表示できるカスタムバッジを追加する機能を提供します。
役割ベースのバッジは、管理者がコミュニティメンバーに対し、各メンバーのコミュニティ内での役割に基づいて割り当てるものです。
割り当てられた(および待ち受けの)バッジは、選択した SRP およびは直接アクセスできません。 GUI が使用できるようになるまで、ロールベースのバッジを割り当てる唯一の方法は、コードまたは cURL を使用して割り当てることです。 cURL の手順については、「 バッジの割り当てと取り消し.
このリリースには、以下の 3 つの役割ベースのバッジが含まれています。
モデレーター
/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
報奨ベースのバッジは、スコアサービスがコミュニティ内でのメンバーのアクティビティを一定のルールで評価し、その結果としてメンバーに付与されるものです。
アクティビティに対する報奨としてバッジを表示するには、以下の 2 つの設定をする必要があります。
このリリースには、以下の 3 つの報奨ベースのバッジが含まれています。
ゴールド
/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
不適切な投稿としてフラグが付けられた場合に、その投稿にマイナスのポイントを割り当て、スコアの値に反映させるようなスコアルールを設定できます。ただし、バッジを獲得すると、スコアリングポイントの削減やスコアリングルールの変更により、バッジは自動的に削除されません。
授与されたバッジは、割り当てられたバッジと同じ方法で取り消すことができます。詳しくは、 バッジの割り当てと取り消し 」セクションに入力します。 今後の改善には、メンバーのバッジを管理する UI が含まれます。
カスタムバッジは、 バッジコンソール バッジルールで割り当てるか指定します。
バッジコンソールからインストールすると、カスタムバッジは自動的にパブリッシュ環境にレプリケートされます。
スコアはデフォルトで有効になっていません。スコア付けとバッジの授与を設定して有効にする基本的な手順は次のとおりです。
ポイント獲得のルールを指定する (スコア付けルール)
詳しくは、 クイックテスト セクションを開き、フォーラムとコメントのデフォルトのスコアルールとバッジルールを使用して、コミュニティサイトのスコアを有効にします。
スコアとバッジを有効にするには、プロパティを追加します scoringRules
および badgingRules
を、サイトのコンテンツツリー内の任意のノードに追加します。
サイトが公開済みの場合は、すべてのルールを適用してコンポーネントを有効にした後に、サイトを再公開します。
バッジを有効にしたコンポーネントには、現在のノードまたはその上位ノードのルールが適用されます。
ノードのタイプがの場合 cq:Page
(推奨)次に、CRXDE|Lite を使用して、プロパティをそのに追加します。 jcr:content
ノード。
プロパティ | タイプ | 説明 |
---|---|---|
badgingRules | 文字列[] | バッジルールの配列リスト |
scoringRules | 文字列[] | スコアルールの配列リスト |
スコアルールがバッジ授与に影響を与えていないように見える場合は、スコアルールがバッジルールの scoringRules でブロックされていないかを確認してください。「 バッジルール.
スコアルールとバッジルールは、オーサリングモードでコンポーネント設定を編集してバッジを有効にしたコンポーネントのインスタンスに対してのみ有効です。
コンポーネントインスタンスでバッジを表示するかどうかは、ブール型プロパティの allowBadges
で指定できます。これは、 コンポーネント編集ダイアログ フォーラム、Q&A、コメントコンポーネントの場合は、「 」というラベルの付いたチェックボックスを使用します。 バッジを表示.
フォーラム、Q&A およびコメントで見つかった HBS コードを例として使用すると、どのコンポーネントもバッジを表示するようにオーバーレイすることができます。
スコアルールは、バッジを授与するためのスコア計算の基礎となるものです。
ごく簡単に言うと、スコアルールは、1 つ以上のサブルールから成るリストです。バッジが有効な場合に適用するルールを識別するために、スコアルールがコミュニティサイトのコンテンツに適用されます。
スコアルールは継承されますが、付加的ではありません。次に例を示します。
page2 にスコアルール 2 が含まれ、その上位ページ 1 にスコアルール 1 が含まれる場合
page2 コンポーネントのアクションは、rule1 と rule2 の両方を呼び出します。
両方のルールに同じに適用可能なサブルールが含まれる場合 topic/verb
:
1 つ以上のスコアルールが存在するときは、ルールごとに分けてスコアが管理されます。
スコア付けルールは、 cq:Page
プロパティを含む jcr:content
定義するサブルールのリストを指定するノード。
スコアは SRP に格納されます。
ベストプラクティスは、各スコアルールに一意の名前を付けることです。
スコアルールの名前はグローバルレベルで一意にする必要があり、末尾を同じ名前にしてはなりません。
例 not 手順:
/etc/community/scoring/rules/site1/forums-scoring
/etc/community/scoring/rules/site2/forums-scoring
スコアサブルールには、コミュニティへの参加状況を表す値を詳細に設定するプロパティが含まれています。
それぞれのスコアサブルールでは、以下を指定します。
デフォルトではアクションを実行したメンバーにポイントが付与されますが、サブルールでコンテンツの所有者にポイントを付与するよう設定することも可能です(forOwner
)。
各サブルールには、1 つ以上のスコアルールを含めることができます。
通常、サブルールの名前は、 件名、オブジェクト および 動詞. 次に例を示します。
サブルールは、タイプのノードです cq:Page
プロパティを含む jcr:content
ノード 動詞とトピック .
プロパティ | タイプ | 値 説明 |
---|---|---|
VERB |
Long |
|
topics |
String[] |
|
forOwner |
ブール値 |
|
scoringType |
String |
|
このリリースには、 フォーラム機能 (フォーラム機能の「フォーラム」および「コメント」コンポーネントごとに 1 つずつ):
/etc/community/scoring/rules/comments-scoring
subRules[] =
/etc/community/scoring/rules/subrules/member-comment-create
/etc/community/scoring/rules/subrules/member-receive-vote
/etc/community/scoring/rules/subrules/member-give-vote
/etc/community/scoring/rules/subrules/member-is-moderated
/etc/community/scoring/rules/forums-scoring
subRules[] =
/etc/community/scoring/rules/subrules/member-forum-create
/etc/community/scoring/rules/subrules/member-receive-vote
/etc/community/scoring/rules/subrules/member-give-vote
/etc/community/scoring/rules/subrules/member-is-moderated
メモ:
両方 rules
および sub-rules
ノードのタイプは cq:Page です。
subRules
は String 型の属性です[] 規則の jcr:content
ノード
sub-rules
は、複数のスコアルール間で共有できます。
rules
は、リポジトリ内の誰でも読み取れる場所に配置する必要があります。
オーサー環境でスコアルールやサブルールに対して行った変更や追加は、パブリッシュ環境にインストールする必要があります。
バッジルールでは、以下を指定することで、スコアルールをバッジにリンクします。
バッジルールは cq:Page
タイプのノードであり、その jcr:content
ノードのプロパティで、スコアルールをスコアおよびバッジと関連付けます。
バッジルールは必須の thresholds
プロパティから成り、このプロパティには、バッジに対応付けるスコアの順序付きリストを指定します。スコアは小さい値から順に並べる必要があります。次に例を示します。
1|/etc/community/badging/images/bronze-badge/jcr:content/bronze.png
60|/etc/community/badging/images/silver-badge/jcr:content/silver.png
80|/etc/community/badging/images/gold-badge/jcr:content/gold.png
バッジルールは、ポイントの累積方法を決定するスコアルールと組み合わせて使用されます。「 コンテンツへのルールの適用.
バッジルールの scoringRules
プロパティは、そのバッジルールに組み合わせ可能なスコアルールを制限します。
ベストプラクティスは、各 AEM サイトに固有のバッジ画像を作成することです。
プロパティ | タイプ | 値 説明 |
---|---|---|
thresholds | String[] | (必須)「number|path」という形式の複数値文字列
エントリの例: 80|/etc/community/badging/images/gold-badge/jcr:content/gold.png |
badgingType | 文字列 | (オプション) スコアリングエンジンを「基本」または「詳細」として識別します。 高度なスコアエンジンが必要な場合は、 高度なスコアとバッジ. デフォルトは「basic」です。 |
scoringRules |
String[] | (オプション) バッジルールを、スコアルールで識別されるスコアイベントに制限する複数値の文字列 |
このリリースには、フォーラムとコメントのスコアルールに対応する 2 つのバッジルールが含まれています。
メモ:
rules
のノードは、cq:Page タイプです。
rules
は、リポジトリ内の誰でも読み取れる場所に配置する必要があります。
オーサー環境でバッジルールまたはバッジ画像の変更や追加をおこなった場合は、それをパブリッシュ環境でインストールする必要があります。
メンバーへのバッジの割り当ては、メンバーコンソールを使用するか、プログラムで cURL コマンドを使用して、おこなうことができます。
以下の cURL コマンドは、バッジの割り当てと取り消しの HTTP リクエストで必要とされる要素を示しています。基本的な形式は以下のとおりです。
cURL -i -XPOST-H ヘッダー -u *signin * -F *operation * -F *badge * member-profile-url
ヘッダー = "Accept:application/json"
サーバーに渡すカスタムヘッダー(必須)
サインイン = administrator-id:password
例:admin:admin
操作 = ":operation=social:assignBadge" OR ":operation=social:deleteBadge"
バッジ = "badgeContentPath=badge-image-file"
badge-image-file =リポジトリ内のバッジ画像ファイルの場所
例:/etc/community/badging/images/moderator/jcr:content/moderator.png
member-profile-url =公開時のメンバーのプロファイルのエンドポイント
例:https://<server>:<port>/home/users/community/riley/profile.social.json
member-profile-url は、
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
cURL を使用したバッジの割り当てと取り消しは、どのバッジ画像でも機能します。ただし、獲得されたバッジではなく割り当てられたバッジの場合は、割り当てられたバッジとしてマークされ、相応に処理されます。
カスタムコンポーネント用に作成されたイベントトピックを動詞と関連付けることで、カスタムコンポーネント用のスコアルールとバッジルールを作成できます。
メンバーがコミュニティ機能を操作すると、通知やスコアなどの非同期リスナーを呼び出すイベントが送信されます。
コンポーネントの SocialEvent インスタンスは、イベントを actions
それは topic
. SocialEvent には、 verb
アクションに関連付けられている。 ここに n-1 ~間の関係 actions
および verbs
.
配信されるコミュニティコンポーネントについて、次の表で次の内容を説明します verbs
それぞれに定義 topic
~で使用できる スコアサブルール.
コンポーネントインスタンスでバッジを表示するかどうかは、新しいブール型プロパティの allowBadges
で指定できます。更新時に設定可能になります コンポーネント編集ダイアログ ラベル付きのチェックボックスを通じて バッジを表示.
カレンダーコンポーネント SocialEvent topic
= = com/adobe/cq/social/calendar
動詞 | 説明 |
---|---|
POST | メンバーがカレンダーイベントを作成する |
追加 | メンバーがカレンダーイベントについてコメントする |
UPDATE | メンバーのカレンダーイベントまたはコメントが編集される |
削除 | メンバーのカレンダーイベントまたはコメントが削除される |
コメントコンポーネント SocialEvent topic
= = com/adobe/cq/social/comment
動詞 | 説明 |
---|---|
POST | メンバーがコメントを作成する |
追加 | メンバーがコメントに返信する |
更新 | メンバーのコメントが編集される |
削除 | メンバーのコメントが削除される |
ファイルライブラリコンポーネント SocialEvent topic
= = com/adobe/cq/social/fileLibrary
動詞 | 説明 |
---|---|
POST | メンバーがフォルダーを作成する |
ATTACH | メンバーがファイルをアップロードする |
更新 | メンバーがフォルダーまたはファイルを更新する |
削除 | メンバーがフォルダーまたはファイルを削除する |
フォーラムコンポーネント SocialEvent topic
= = com/adobe/cq/social/forum
動詞 | 説明 |
---|---|
POST | メンバーがフォーラムトピックを作成する |
追加 | メンバーがフォーラムトピックに返信する |
更新 | メンバーのフォーラムトピックまたは返信が編集される |
削除 | メンバーのフォーラムトピックまたは返信が削除される |
ジャーナルコンポーネント SocialEvent topic
= = com/adobe/cq/social/journal
動詞 | 説明 |
---|---|
POST | メンバーがブログ記事を作成する |
追加 | メンバーがブログ記事にコメントする |
更新 | メンバーのブログ記事またはコメントが編集される |
削除 | メンバーのブログ記事またはコメントが削除される |
Q&A コンポーネント SocialEvent topic
= com/adobe/cq/social/qna
動詞 | 説明 |
---|---|
POST | メンバーが Q&A の質問を作成する |
追加 | メンバーが Q&A の回答を作成する |
更新 | メンバーの Q&A の質問または回答が編集される |
SELECT | メンバーの回答が選択される |
UNSELECT | メンバーの回答の選択が解除される |
削除 | メンバーの Q&A の質問または回答が削除される |
レビューコンポーネント SocialEvent topic
= = com/adobe/cq/social/review
動詞 | 説明 |
---|---|
POST | メンバーがレビューを作成する |
更新 | メンバーのレビューが編集される |
削除 | メンバーのレビューが削除される |
評価コンポーネント
SocialEvent topic
= com/adobe/cq/social/tally/rating
動詞 | 説明 |
---|---|
ADD RATING | メンバーのコンテンツの評価が上がった |
REMOVE RATING | メンバーのコンテンツの評価が下がった |
投票コンポーネント
SocialEvent topic
= com/adobe/cq/social/tally/voting
動詞 | 説明 |
---|---|
ADD VOTING | メンバーのコンテンツに賛成票が投じられた |
REMOVE VOTING | メンバーのコンテンツに反対票が投じられた |
モデレート対応コンポーネント SocialEvent topic
= = com/adobe/cq/social/moderation
動詞 | 説明 |
---|---|
DENY | メンバーのコンテンツが拒否される |
FLAG-AS-INAPPROPRIATE | メンバーのコンテンツにフラグが付けられる |
UNFLAG-AS-INAPPROPRIATE | メンバーのコンテンツのフラグが解除される |
ACCEPT | メンバーのコンテンツがモデレーターにより承認される |
CLOSE | メンバーがコメントの編集と返信を閉じる |
OPEN | メンバーがコメントを再度開く |
カスタムコンポーネントの場合、 SocialEvent がインスタンス化され、コンポーネントのイベントが actions
それは topic
.
スコアリングをサポートするには、 SocialEvent でメソッドを上書きする必要があります getVerb()
適切な verb
が返される action
. この verb
アクションに対して返されるのは、一般的に使用される ( POST
) またはコンポーネント専用の ( 例えば ADD RATING
) をクリックします。 ここに n-1 ~間の関係 actions
および verbs
.
スコアルールとバッジルールが Web サイトのコンテンツに適用されていて、どのアクティビティに対してもバッジが表示されない場合は、そのコンポーネントのインスタンスに対してバッジが有効になっていることを確認します。
詳しくは、 コンポーネントのバッジを有効にする.
スコアルールとバッジルールを Web サイトのコンテンツに適用したのに、バッジが一部のアクションにしか授与されない場合は、バッジルールの適用先のスコアルールが制限されていないかを確認してください。
詳しくは、 scoringRules
プロパティ バッジルール.
ほとんどのプロパティや値(特に動詞)では、大文字と小文字が区別されます。スコアサブルールで使用する場合、動詞はすべて大文字にする必要があります。
この機能が予想どおり動作しない場合は、データが正しく入力されているかを確認してください。
Getting Started Tutorial(engage)サイトを使用すると、スコアとバッジを簡単に試すことができます。
作成者のCRXDE Liteにアクセス
ベースページを参照します。
badgingRules プロパティを追加します。
badgingRules
String
/etc/community/badging/rules/forums-badging
と入力します。+
/etc/community/badging/rules/comments-badging
と入力します。scoringRules プロパティを追加します。
scoringRules
String
/etc/community/scoring/rules/forums-scoring
と入力します。+
/etc/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 / password)
新しいフォーラムトピックを投稿します
バッジを表示するには、ページを更新する必要があります
フォーラムを選択
フォーラムトピックを投稿したコミュニティメンバーを見ると、ブロンズバッジが表示されているはずです。これは、最初のフォーラムバッジルールの最初のしきい値のスコアが 1 であるからです。
詳しくは、 スコアとバッジの基本事項 開発者向けのページ
高度なスコアエンジンについて詳しくは、 高度なスコアとバッジ.
設定可能なリーダーボード コンポーネント および 関数 は、コミュニティサイトでのメンバーとそのスコアの表示を簡素化します。