コメントウィジェットは例えばテナントIDに "demo" を使って利用できることに気付くかもしれません:

Demo Tenant ID

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo"

7}];

8</script>

9

これはコメントウィジェットを試して遊ぶためのものです。 本番環境では、次のようにあなたのテナントIDを渡します:

Defining Your Tenant ID

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "aKa2Z4Q="

7}];

8</script>

9

あなたのテナントIDは、コメントウィジェットのあなたのアカウント内のコードスニペットに既に適用されているのが確認できます。

テナントIDを見つけたり、APIキーを管理したりするには、API認証情報ページをご覧ください。

以降、FastCommentsにログインしている場合、コード例ではあなたの実際のテナントIDが使用されます（https://fastcomments.com にログインしている場合）。

コメントスレッドを表示したり、コメントを投稿したりする際、FastComments はそのコメントがどのページ、記事、または製品に属しているかを把握する必要があります。

これを行うために、私たちは「URL ID」と呼んでいるものを使用します。これは文字列や数字のような識別子、または URL です。

デフォルトでは、urlId を指定しない場合、ページの URL が URL ID になります。現在のページの URL を取得し、一般的なマーケティングパラメータやトラッキング識別子を削除してクリーンにします。

WordPress のようなサードパーティ統合の場合、プラグインは通常、表示中の情報を表す識別子（たとえば記事/ページ ID）を URL ID として使用します。

Defining a Custom URL ID

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "urlId": "https://example.com/page"

8}];

9</script>

10

本ドキュメントでよく参照するものの一つに、Widget Customization UI があります。

この UI を使うと、コードを使わずにコメントウィジェットを多くの点で変更できます。

カスタマイズルールを作成する際、サイトのすべてのページに適用したいことがよくあります。しかし、特定のページに対してコメントウィジェットをカスタマイズしたい場合もあります。例えば、特定のページだけカスタムスタイリングを適用したり、そのページのコメントを匿名にしたりすることができます。また、あるページではライブコメントをすぐに表示し、別のページでは通知ボタンの下に隠す、といったことも可能です。

これはすべて、このページの URL ID 入力フィールドを使って実現できます。見た目は次のようになっています:

URL ID Input in The Widget Customization Page

このフィールドの値は、コメントウィジェットに渡される urlId パラメータと一致している必要があります。カスタマイズルールを urlId 非依存にしたい場合は、このフィールドを空にするか * を入力してください。

As of 2023 the URL ID field in widget customization now also takes patterns! For example you may have */blog/* to add styling specific to your blog and */store/* to have styling specific to your store, all while using the same domain.

注意点

1. ページにハッシュパラメータ（例: example.com#page-1）がある場合 - デフォルトではこれが URL ID の一部になります。
2. WordPress から Gatsby への移行などのマイグレーション中は、初回の移行後に URL ID コメント値を移行する必要がある場合があります。その際はお問い合わせください。

FastComments はカスタマイズできるように設計されています。コメント用ウィジェット自体はセキュリティ上の理由から iframe 内で動作するため、カスタムスタイリングを適用するには次のいずれかの方法に従う必要があります。

最初で、最も簡単な方法（かつ当社推奨）は、widget customization page を使用することです。

ウィジェットカスタマイゼーションページでは、"Show Advanced Options" セクションを参照し、その下に "Custom CSS" とラベル付けされた領域があります。

Custom CSS Input Area

この方法にはいくつかの利点があります:

1. 入力された CSS はユーザーに送信される前に圧縮され、編集 UI のフォーマットが一貫して保たれます。
2. ウィジェットカスタマイズ UI のすべての利点を享受できます。例えば、サイトごとにコメントウィジェットを簡単に異なるカスタマイズにできます。
3. コメントウィジェットに変更を加える際、あなたのカスタムスタイルは当社のリリースプロセスの一部としてテストされます。

2つ目の方法は、ウィジェット構成で customCSS パラメータを指定することです。以下のように:

Passing Custom CSS

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": "button { background: red; }"

8}];

9</script>

10

ただし、これは制限があります:

1. ヘッダーのサイズのため、サーバーがリクエストを拒否する前に渡せるカスタム CSS の量には制限があります。
2. カスタム CSS をあなたのインフラやビルドシステムで管理する必要があります。これはむしろ利点になる場合もあります。
3. このユースケースでは、カスタム CSS をネットワーク上で2回送信する追加のオーバーヘッドがあります。まず当社のサーバーへ送信され、次に iframe コンテンツ内で返送されるためです。ただし、ほとんどのペイロードサイズではこれは目立ちません。
4. 一般的な最適化として、ネットワーク上のサイズを削減するために CSS を圧縮（ミニファイ）することがありますが、この方法ではそれを自分で処理する必要があります。
5. この方法では、当社が変更を行った際にあなたのカスタム CSS はテストされません。

External CSS Files

ウィジェットに外部ファイルをフェッチさせるには @import を使用できます！

@import をカスタマイズルールに入れておくことを推奨します。こうすることで、当社がコメントウィジェットに変更を加える必要が生じた場合に、当社の自動化ツールを使ってあなたの設定を検証できます。例えば、ウィジェットカスタマイズ UI でカスタマイズルールを作成し、Advanced をクリックして Custom CSS に次のように入力します:

@import url(https://example.com/styles.css);

In Code - Not Recommended

外部 CSS ファイルは customCSS プロパティ経由でも読み込めます:

External CSS File

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": "@import url(https://example.com/styles.css);"

8}];

9</script>

10

ただし、この方法を採ると当社であなたの CSS をテストできないことを忘れないでください。

User Profile Modal Styling

ユーザープロファイルのモーダルもカスタム CSS でスタイリングできます。ただし、ユーザープロファイルにカスタムスタイリングを適用するには、すべての CSS セレクタが .user-profile でプレフィックスされている必要があります。このプレフィックスがない場合、ユーザープロファイルモーダルにはカスタムスタイリングは適用されません。

例えば:

User Profile CSS

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "customCSS": ".user-profile .profile-name { color: blue; }"

8}];

9</script>

10

Backwards Compatibility

FastComments では、お客様がコメントウィジェットをカスタマイズすることを承知しています。それは設計上の意図です — 当社の製品があなたの製品のデザイン不整合を引き起こす最後のものにしたくありません。

これは当社の製品の重要な部分であるため、リリースごとに顧客ごとのコメントウィジェットの変更をレビューできるビルドパイプラインを用意しています。

軽微な問題が見つかった場合は、リリースが円滑に進むようにお客様のアカウントを更新します。重大な破壊的変更が見られる場合は、リリースを停止することができます。

Pro または Enterprise アカウントをお持ちのお客様は、ホワイトラベリングが可能です。単に お問い合わせください。喜んでお手伝いします。

コメントウィジェットから当社のロゴを削除したいだけの場合、Flex および Pro プランではこれが自動的に有効になります。

これらのプランは、当社のプラットフォームから送信されるメールについても同じ機能を提供します。

ページの初回読み込み後にダークモードの切り替えを許可するサイトでは、これにはもう少し手間がかかります。

まず、Commentウィジェットライブラリのすべての現在のバージョン（React、Vue）には、それぞれのリポジトリにダークモード切り替えの例があります。

VanillaJSウィジェットについては、もう少し作業が必要です。まず、FastCommentsUIは "destroy" と "update" の関数を持つオブジェクトを返します。

コメントウィジェットの設定を更新したいたびに、単純にupdate関数を呼び出すことができます。以下は、VanillaJSウィジェットでダークモードを切り替える完全に動作する例です。

ダークモード切り替えの完全な例

Copy Run

1

2<script src="https://fastcomments.com/js/embed-v2.min.js"></script>

3<button id="toggle-dark-mode">Toggle Dark Mode</button>

4<div id="fastcomments-widget"></div>

5<script>

6 (function() {

7 const button = document.getElementById('toggle-dark-mode');

8 const config = {

9 tenantId: 'demo',

10 hasDarkBackground: false

11 };

12 const instance = window.FastCommentsUI(document.getElementById('fastcomments-widget'), config);

13 button.addEventListener('click', function() {

14 config.hasDarkBackground = !config.hasDarkBackground;

15 if (config.hasDarkBackground) {

16 document.body.classList.add('dark');

17 } else {

18 document.body.classList.remove('dark');

19 }

20 instance.update(config);

21 });

22 })();

23</script>

24<style>

25 body.dark {

26 background: #000;

27 color: #fff;

28 }

29</style>

30

FastComments では、コメントウィジェット内のすべてのテキストをカスタマイズできます。

送信ボタンなど単一のテキストだけを上書きすることも、コメントウィジェット全体のすべてのテキストを上書きすることもできます。

デフォルトでは、コメントウィジェットのテキストはユーザーのロケールに基づいて翻訳されます。ただし、ユーザーベースが同じロケール/言語を使用していると確信している場合は、テキストを上書きすることができます。例えば:

Custom Text

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "translations": {

8 "SUBMIT_REPLY": "Reply"

9 }

10}];

11</script>

12

すべてのカスタマイズ可能な翻訳は、こちらの「詳細オプション」タブで確認できます。

しかし、ウィジェットカスタマイズUIを使ったより簡単な方法があります。そこで、コメントウィジェットに表示される EN_US ロケールのテキストを見つけて、置き換えを指定できます。

Custom Text

現在、翻訳の上書きはすべてのロケールに対して適用されます。

ユーザーが FastComments で初めてコメントする際、http://gravatar.com/ からアバターを取得しようとします。

しかし、アバターが見つからない場合や、ユーザーがアカウントにアバターを設定していない場合は、静的なデフォルトのアバター画像を表示します。

独自の静的アバター画像を指定するには、defaultAvatarSrc 設定を使用できます。

Override The Default Avatar

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultAvatarSrc": "https://example.com/some-image.png"

8}];

9</script>

10

これはコードなしでも行えます。ウィジェットのカスタマイズページで「Default Avatar」セクションを参照してください。

Customizing The Default Avatar

特定のユーザーのアバターを定義する（SSO を使用する場合など）については、別のセクションで説明しています。

ユーザーが独自のアバターを設定していても、コメントウィジェットからアバターを完全に削除できます。

Hiding Avatars

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "hideAvatars": true

8}];

9</script>

10

これはウィジェットのカスタマイズページでコード不要で設定できます:

Hiding Avatars

より大規模なカスタムスタイリングのプロジェクトでは、最初からクリーンな状態で始め、デフォルトのスタイリングをまったく使用しないほうが望ましい場合があります。

すべてのデフォルトスタイリングは、noStyles パラメータを true に設定することで削除できます。以下のように設定します:

Disabling All Default Styles

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "noStyles": true

8}];

9</script>

10

これはコードを使わずに、ウィジェットのカスタマイズページの「詳細オプション」でカスタマイズできます:

Disabling All Default Styles

デフォルトでは、トップレベルのコメントに対する返信が表示されます。

これを設定すると、ユーザーはトップレベルのコメントで「返信を表示」をクリックしないと子コメントが表示されないようにできます。

Collapse Replies to Top Level Comments

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "collapseReplies": true

8}];

9</script>

10

これはコードなしでウィジェットのカスタマイズページから変更できます：

Collapse Replies

この設定は、最初に読み込まれるトップレベルのコメント数には影響しません。もしトップレベルのコメントが1件で、その下に29件の子コメントがある場合、この設定を有効にすると次のようになります：

• トップレベルのコメントが表示されます。
• このコメントの下に「返信を表示 (29)」が表示されます。

このオプションと組み合わせて、すべてのトップレベルのコメントを表示したい場合は、starting page を -1 に設定する。

デフォルトでは、FastComments の書式機能は、テキストの周りに <b></b> のような目に見えるアンカータグを追加することで行われます。ツールバーをクリックするかショートカットを使うと、自動的にこれが適用されます。しかし、一部のコミュニティではアンカータグを使わずに書式を適用したい場合があります。これを WYSIWYG（表示されるものがそのまま反映される）エディタを有効にする、という言い方をします。このエディタはデフォルトのものと見た目はまったく同じですが、目に見えるアンカータグを使わずにユーザーがテキストを太字や下線などにできるようにする追加のコードを読み込みます。

Enabling WYSIWYG Editing

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableWYSIWYG": true

8}];

9</script>

10

これはコードなしでも行えます。ウィジェットのカスタマイズページで、"Enable Advanced Formatting" オプションをご覧ください。

Enable WYSIWYG

デフォルトでは、FastComments はコメントを作成する際に、テキストの装飾やアップロード 画像のショートカットを提供するツールバーを表示します。

このツールバーは、コードまたはカスタマイズ UI で無効にできます。

Disabling The Toolbar

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableToolbar": true

8}];

9</script>

10

これはコードを使わずに行うこともできます。ウィジェットのカスタマイズページで「返信ツールバーを無効にする」オプションを参照してください。

Disabling The Toolbar

デフォルトでは、FastCommentsはユーザーが他のユーザーをブロックできるようになっています。ブロックされたユーザーのコメントはマスクされ、 ユーザー間の通知が無効になり、その他の影響があります。

この機能を無効化したい場合があります。次のように行えます：

Disable Blocking

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableBlocking": true

8}];

9</script>

10

これはコードを使わずに、ウィジェットカスタマイズUIを通じて行うこともでき、その場合はサーバー側での適切な検証も有効になります：

Disable Blocking

デフォルトでは、ローカライズされた相対日時が使用されます。たとえば、最近投稿されたコメントの横に "11分前" と表示されることがあります。

絶対日時を使用する必要がある、または望ましい場合は、このパラメータを true に設定します。

Use Absolute Dates

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "absoluteDates": true

8}];

9</script>

10

これはコードを使わず、ウィジェットのカスタマイズページの「詳細オプション」から設定できます:

Use Absolute Dates

デフォルトでは、ローカライズされた相対日付が使用されます。例えば、最近投稿されたコメントの横には「11分前」のように表示されることがあります。

この相対日付形式を維持しつつ、同時に完全な日付も併せて表示したい場合は、このパラメータを true に設定します。

Use Both Absolute and Relative Dates

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "absoluteAndRelativeDates": true

8}];

9</script>

10

これはコードなしで、ウィジェットのカスタマイズページの「詳細オプション」でカスタマイズできます。UIでこのオプションを表示するには、まず Absolute Dates を有効にする必要があります。

Use Both Absolute and Relative Dates

ヘッダーやメッセージのようなテキストは、コメント数の下、ログイン状態のテキストの上に表示できます。

これをヘッダーと呼び、デフォルトでは非表示です。

Specifying Header HTML

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "headerHTML": "<h1>Leave a Comment!</h1>"

8}];

9</script>

10

これはコードなしで、ウィジェットのカスタマイズページの「詳細オプション」から変更できます：

Specifying Header HTML

By default, FastComments will render links like this: https://exmaple.com - リンクの URL がクリック可能な HTML アンカータグになります。

Some sites may want to disable this, for example to discourage scammers. We provide this by setting the Comment HTML Rendering Option to Links as Text.

This can be customized without code, on the widget customization page, for an entire domain, or page:

Render Links as Text

デフォルトでは、FastComments はコメント入力ボックスとコメントスレッドを同時にレンダリングします。垂直方向のスペースを節約するため、ウィジェットが操作されるまで他の必須フィールドは非表示にします。

ただし、コメントウィジェットをボタンの背後に隠すこともできます。例えば:

Click to Show Comments

ボタンはコメントが現在表示されているかどうかに応じて、異なる翻訳済みテキストを使用します。コメントが非表示の場合は translations.SHOW_COMMENTS_BUTTON_TEXT を使用します。コメントが表示されている場合は translations.HIDE_COMMENTS_BUTTON_TEXT を使用します。翻訳テキストには [count] というテキストを含めることができ、ローカライズされたカウントに置き換えられます。

Click to Show or Hide Comments

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "useShowCommentsToggle": true

8}];

9</script>

10

これは hideCommentsUnderCountTextFormat 設定を置き換えるために設計されています。

カウントはコメントスレッドとリアルタイムで更新されます。コメントがない場合、ボタンは表示されません。

これは、カスタマイズルールを作成して「クリックしてコメントを表示」を有効にすることで、コード不要で有効化できます。

Enable Click to Show Comments

コメントウィジェットの上部に表示されるコメント数はカスタマイズできます。

これには任意の文字列を設定でき、値 [count] はユーザーのロケールに合わせてローカライズされた件数に置き換えられます。

Customizing The Comment Count Text

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "commentCountFormat": "There are [count] comments."

8}];

9</script>

10

これはコードを書く必要はなく、ウィジェットのカスタマイズページで設定できます：

Customizing The Comment Count Text

ユーザーが #someexampletag の形式でハッシュタグを入力すると、FastComments は自動的にその HashTag を作成し、 コメント内でハイライトします。

場合によっては、この機能を無効にしたり、API 経由で使用できるハッシュタグを制御したりすることが望ましい場合があります。

そのためには、ウィジェットのカスタマイズ UI で Disable Automatic #hashtag Creation を有効にしてください。

Disabling Automatic HashTag Creation

デフォルトでは、FastComments はコメントエリアの右上に通知ベルを表示します。

このベルは赤くなり、ユーザーが持っている通知の数を表示します。通知の例は次のとおりです：

• ユーザーがあなたに返信しました。
• ユーザーがあなたがコメントしたスレッドに返信しました。
• ユーザーがあなたのコメントに賛成票を投じました。
• ユーザーがあなたが購読しているページに返信しました。

通知ベルは、ページ全体を購読するための仕組みも提供します。

ただし、通知ベルを完全に無効にすることもできます：

Disable Notification Bell

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableNotificationBell": true

8}];

9</script>

10

コードを書かなくてもこれを行うことができます。ウィジェットのカスタマイズページで「通知ベルを無効にする」セクションを参照してください。

Disable Notification Bell

デフォルトでは、FastComments はユーザーのアバターをクリックするとそのユーザーのプロフィールを表示します。

ただし、この機能を無効にすることができます:

Disable Profiles

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableProfiles": true

8}];

9</script>

10

これはコードを使わなくても行えます。ウィジェットのカスタマイズページの「Disable Profiles」セクションを参照してください。

Disable Profiles

デフォルトでは、FastComments はコメント投稿後に成功メッセージを表示します。これを無効にするには、次のようにします:

Disable Success Message

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableSuccessMessage": true

8}];

9</script>

10

これはコードなしでも行えます。ウィジェットのカスタマイズページで:

Disable Success Message

デフォルトでは、FastComments コメントウィジェットは gif rating を pg に設定します。

利用可能なオプションは g、pg、pg-13、および r です。

これはコードまたは UI で設定できます。コード内では次のようにします：

Set Gif Rating

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "gifRating": "pg-13"

8}];

9</script>

10

UI では、Disable Image Uploads? がチェックされていない限り、Gif Picker Rating の下にあります。

Setting The Gif Rating

デフォルトでは、FastComments のコメントウィジェットでは画像コンテンツのモデレーションが off になっています。

利用可能なオプションは off、low、medium、および high です。

ウィジェットのカスタマイズ UI では、Disable Image Uploads? がチェックされていない限り、Image Content Moderation Level の項目でこれを見つけることができます。

Setting The Image Content Moderation Level

デフォルトでは、FastComments は投票オプションを上矢印と下矢印として表示し、ユーザーはコメントに対して賛成（アップ）または反対（ダウン）投票を行えます。

ただし、投票ツールバーのスタイルを変更することができます。現在のオプションは、デフォルトの上下ボタン、またはハートスタイルの投票メカニズムです。

以下のように voteStyle フラグを使用します：

Enable Heart Button

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "voteStyle": 1

8}];

9</script>

10

サーバー側の検証も有効になるため、コードを使わずに行うことを強く推奨します。ウィジェットのカスタマイズページで "Vote Style" セクションを参照してください。

Change Voting Style

投票は無効にすることもできます。スタイルオプションの上にある Disable Voting を参照してください。

デフォルトでは、FastComments はユーザーが自分のコメントを削除できるようにします。

ただし、この動作を無効にすることが可能です。

ウィジェットのカスタマイズページで「削除を無効にする」オプションを参照してください。

Disable Comment Deleting

• これは通常のコメント投稿者にのみ影響し、モデレーターや管理者は引き続き削除できます。
• contextUserId が渡される API 統合にも影響します。

デフォルトでは、FastComments はユーザーが自分のコメントを編集できるようになっています。

ただし、これを無効にすることが可能です。

ウィジェットのカスタマイズページで「編集を無効化」オプションを参照してください。

Disable Comment Editing

• これは通常のコメント投稿者にのみ影響し、モデレーターや管理者には影響しません。彼らは引き続き編集できます。
• これは contextUserId が渡された場合の API 統合にも影響します。

デフォルトでは、FastComments のページサイズは 30 です。スレッド内の返信も含まれます。

ページサイズは ウィジェット設定 UI でカスタマイズでき、10 から 200 の範囲で選択できます。

ページサイズを変更すると、アカウント内のすべてのコメントスレッドを再計算する必要があります。これには数分かかる場合があります。

ページはサーバー側で計算されるため、クライアント側のウィジェットでは設定できません。

以下に設定例を示します:

Custom Page Sizes

ページサイズはグローバル、ドメインごと、ページごとに異なるカスタマイズルールを作成することで変更できます。

これにより、当社プラットフォームを通じてコメントを表示するために使用しているすべてのクライアント、統合、およびフレームワークに影響します。

デフォルトでは、FastComments はユーザーが入力した名前、または SSO を介して渡された名前をそのまま表示します。

しかし、ユーザー名をマスクしたり別の形式で表示したい場合もあります。例えば、ユーザー名が Allen Rex の場合、もしかしたら "Allen R." のみを表示したいかもしれません。

This can be done without code in the Widget Customization UI, under the setting called Commenter Name Format:

Change Name Format

The available formats are:

• Capitalize (display example user as Example User)
• Last Initial (display Example User as Example U.)
• All Initials (display Example User as E. U.)
• Show "Anonymous"

The effect of changing this is immediate. User's will still see their full username at the top of the comment area, for themselves, but their comments will show the modified username.

Usernames are masked server-side to protect users.

デフォルトでは FastComments は画像のアップロードを許可します。これは noImageUploads フラグを true に設定することで無効にできます。

Disabling Image Uploads

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "noImageUploads": true

8}];

9</script>

10

これはウィジェットのカスタマイズページで、コードを使わずに変更できます：

Disabling Image Uploads

デフォルトでは、コメントウィジェットには検索ボックスは表示されません。

ただし、enableSearch フラグを true に設定することでこれを有効にできます:

Enabling Search

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableSearch": true

8}];

9</script>

10

コードを使わずにこれを行うこともできます。ウィジェットのカスタマイズページで「Enable Search Box」オプションを参照してください。

Enable Search Box

スポイラー機能はenableSpoilersフラグをtrueに設定することで有効にできます:

Enabling Spoilers

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableSpoilers": true

8}];

9</script>

10

これはコードを使わずに行うこともできます。ウィジェットのカスタマイズページで、"Enable Spoilers" オプションを参照してください。

Enable Spoilers

テキストがハイライトされ、表示された SPOILER ボタンがクリックされると、ユーザーがマウスオーバーするまでテキストはマスクされます。ダークモードでも同じ処理を行いますが、異なる 色を使用してダークモードにより適合させます。

これはWYSIWYGエディタとも互換性があります。

デフォルトでは、FastComments は各コメントを誰が閲覧したかを追跡したり、その統計を提供したりしません。

しかし、この機能を有効にすると、ユーザーがコメントまでスクロールするたびにシステムがその閲覧を追跡し始めます。

これが起きると、各コメントに表示される目のアイコンの横にあるカウントが増加します。カウントはリアルタイムで更新され、ユーザーのロケールに応じて省略表示されます。

この機能は enableViewCounts フラグを true に設定することで有効にできます:

Enabling Comment View Counts

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableViewCounts": true

8}];

9</script>

10

これはウィジェットカスタマイズページで、コードを使わずに設定できます:

Enabling Comment View Counts

コメントを閲覧した user id* を追跡するため、同じユーザーがコメントを再度閲覧してもカウントは増えません。2年後に再度そのコメントを閲覧した場合、カウントは再び増加します。

• *注: または anon session id、あるいはユーザーの IP をハッシュ化した値。

デフォルトでは、ライブコメント機能は有効になっています。つまり、コメントが追加、削除、編集、またはピン留めされると、変更は表示される すべてのユーザーに同時に反映されます。

ただし、デフォルトではそれらの新しいコメントは「Show 2 New Comments」のような文言が表示された動的なボタンの下に表示されます。

新しいコメントがページに直接対する返信である場合、そのボタンはコメントスレッドの上部に表示されます。特定のコメントへの返信である場合は、 そのコメントの下にボタンが表示されます。

これは、ページのサイズがユーザーに対して絶えず変化し、スクロールバーを掴もうとしたときにフラストレーションを引き起こす可能性があるのを防ぐためです。

ライブ入札やオンラインイベントのようなユースケースでは、これは望ましくない動作であることがあります — コメントウィジェットが新しいコメントを「すぐに表示する」チャットボックスのようになってほしい場合があります。

したがって、その機能を有効にするフラグの名前は次のとおりです: showLiveRightAway。

次のようにオンにできます:

Show Live Comments Right Away

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "showLiveRightAway": true

8}];

9</script>

10

コードを使わず、ウィジェットのカスタマイズページでこれをカスタマイズすることもできます:

Show Live Comments Right Away

デフォルトでは、FastCommentsはライブコメント機能が有効になっています。

これは、コメントスレッドのすべての閲覧者が同じ内容を見ることを意味します。

たとえば、コメントが追加された場合、そのコメントが表示されます。コメントが編集または削除された場合、 その編集や削除はスレッドの全ての閲覧者に対して反映されます。投票やすべてのモデレーション操作も同様です。

ただし、これを無効にすることもできます:

Disable Live Commenting

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableLiveCommenting": true

8}];

9</script>

10

これはコードを使わずに行うこともできます。ウィジェットのカスタマイズページで "Disable Live Commenting" セクションを参照してください。

Disable Live Commenting

デフォルトでは、FastComments はコメントを「Most Relevant」（最も関連性が高い）ソート方向で並べます。

「Most Relevant」ソートは、コメントが投稿された時間と投票数を考慮して並べ替えます。

ユーザーはコメントウィジェットの UI でソート方向を Oldest（古い順）または Newest First（新しい順）に変更できます。

ただし、デフォルトはこれら3つのいずれにも変更できます。例えば、最も古いコメントを先に表示したい場合:

Changing The Default Sort To Oldest First

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultSortDirection": "OF"

8}];

9</script>

10

defaultSortDirection の値を "OF" に設定して、方向を "OF" にします。

新しい順（Newest First）のソート方向にするには、次のようにします:

Changing The Default Sort To Newest First

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "defaultSortDirection": "NF"

8}];

9</script>

10

defaultSortDirection に使用できる値は次のとおりです:

• MR: "最新順"
• NF: "新しい順"
• OF: "古い順"

これはコードなしでも行えます。ウィジェットのカスタマイズページの「デフォルトのソート方向」セクションを参照してください。

Changing The Default Sort Direction

注意: 各ページのコメントは各ソート方向ごとに事前計算されているため、すべてのソート方向でパフォーマンスは同じです。

デフォルトではコメント入力欄はコメントスレッドの前にあります。しかし、この設定パラメータを true に設定すると、コメント入力欄をコメントスレッドの後に移動できます。

Moving The Reply Box to The Bottom

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "inputAfterComments": true

8}];

9</script>

10

コードを書かずに、ウィジェットのカスタマイズページで設定できます:

Moving The Reply Box to The Bottom

コメント入力フィールドに入力できる最大文字数は、maxCommentCharacterLength パラメータで制限できます。

デフォルトは2000です。

画像のURLなどは文字数の判定に含まれません。

Limit Comment Length

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "maxCommentCharacterLength": 500

8}];

9</script>

10

これはウィジェットのカスタマイズページで、コード不要でカスタマイズできます：

Limit Comment Length

デフォルトでは、FastComments はユーザーがデフォルトの文字数制限内で、好きなだけ行数のあるコメントを入力できるようになっています。

しかし、ユーザーの入力を1行のテキストのみに制限したい場合もあります。例えば、オンライン入札やライブチャットなど、FastComments で使用できるケースがあります。

We enable the useSingleLineCommentInput flag as follows:

Enable Single-Line Comment Input

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "useSingleLineCommentInput": true

8}];

9</script>

10

これはコードを使わずに行うこともできます。ウィジェットのカスタマイズページで、「シングルラインのコメント入力を有効にする」セクションを参照してください。

Enable Single-Line Comment Input

注意：各ページのコメントは、各ソート方向ごとに事前に計算されるため、すべてのソート方向でパフォーマンスは同じです。

デフォルトでは、各ユーザーは同じ1分間に最大5 commentsを投稿できます。

これは user id、anon user id、および ip address (hashed) によって追跡されます。

これはウィジェットのカスタマイズページでコード不要でカスタマイズできます:

Limiting Comment Volume Per User

注意: comment creation API を使用している場合、リクエストでユーザーの元の ip アドレスを当社のバックエンドに渡すことを検討してください。レート制限がユーザーごとに適用され、アカウント全体には適用されないようにするためです。

FastComments Secure SSO は、SSO を実装するメカニズムとして HMAC-SHA256 暗号化を使用します。まず全体的なアーキテクチャを説明し、例と詳細な手順を示します。

また、類似の SSO メカニズムを持つ他のプロバイダーからの移行に関するドキュメントや、相違点についての説明もあります。

フローは次のとおりです:

Secure SSO Flow

Secure SSO はフルスタック開発を伴うため、Java/Spring、NodeJS/Express、バニラ PHP による完全な動作コード例が現在 GitHub にあります。

NodeJS の例では ExpressJS、Java の例では Spring を使用していますが、これらのランタイムで FastComments SSO を実装するためにフレームワーク／ライブラリは必須ではありません — ネイティブの crypto パッケージで動作します。

FastComments SSO を使用する際に新しい API エンドポイントを作成する必要はありません。ユーザーの情報をシークレットキーで暗号化して、ペイロードをコメントウィジェットに渡すだけです。

Get Your API Secret Key

API Secret は このページ から取得できます。このページは My Account に移動し、API/SSO タイルをクリックしてから「Get API Secret Key」をクリックしても見つかります。

Comment Widget Parameters

コメントウィジェットのハイレベルな API ドキュメントは こちら にあります。

これらのパラメータが何を意味するか、もう少し詳しく説明します。

コメントウィジェットは設定オブジェクトを受け取ります — FastComments を使用してテナント ID（tenantId と呼ばれる）を渡している場合はすでにこれを渡しています。

SSO を有効にするには、新しい "sso" オブジェクトを渡します。これは次のパラメータを持つ必要があります。これらの値はサーバー側で生成してください。

• userDataJSONBase64: ユーザーのデータを JSON 形式にしたものを Base64 エンコードしたもの。
• verificationHash: UNIX_TIME_MILLIS + userDataJSONBase64 から生成された HMAC-SHA256 ハッシュ。
• timestamp: エポックタイムスタンプ（ミリ秒）。未来の時刻であってはならず、かつ過去 2 日以上前であってはなりません。
• loginURL: コメントウィジェットがログイン用に表示できる URL。
• logoutURL: コメントウィジェットがログアウト用に表示できる URL。
• loginCallback: login URL の代わりに提供された場合、コメントウィジェットがログインボタンをクリックしたときに呼び出す関数。
• logoutCallback: logout URL の代わりに提供された場合、コメントウィジェットがログアウトボタンをクリックしたときに呼び出す関数。

Secure SSO Client Code

Copy

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "sso": {

8 "userDataJSONBase64": "...",

9 "verificationHash": "...",

10 "timestamp": 1768890093327,

11 "loginURL": "https://example.com/login",

12 "logoutURL": "https://example.com/logout"

13 }

14}];

15</script>

16

The User Object

The User Object

ユーザーオブジェクト

Copy

1

2interface SSOUser {

3 /** Required. 1k Characters Max. **/

4 id: string;

5 /** Required. 1k Characters Max. Note: Must be unique. **/

6 email: string;

7 /** Required. 1k Characters Max. Note: The username cannot be an email. Does not have to be unique. **/

8 username: string;

9 /** Optional. 3k Characters Max for URLs. Default is from gravatar based on email. Supports 64 encoded images, in which case the limit is 50k characters. **/

10 avatar?: string;

11 /** Optional. Default false. **/

12 optedInNotifications?: boolean;

13 /** Optional. Default false. **/

14 optedInSubscriptionNotifications?: boolean;

15 /** Optional. 100 Characters Max. This label will be shown next to their name. Default is Administrator/Moderator when applicable. **/

16 displayLabel?: string;

17 /** Optional. 500 Characters Max. This will be shown instead of the username. **/

18 displayName?: string;

19 /** Optional. 2k Characters Max. The user's name will link to this. **/

20 websiteUrl?: string;

21 /** Optional. Up to 100 groups per user. A group id may not be longer than 50 characters. **/

22 groupIds?: string[];

23 /** Optional. Denotes the user as an administrator. **/

24 isAdmin?: boolean;

25 /** Optional. Denotes the user as a moderator. **/

26 isModerator?: boolean;

27 /** Optional, default true. Set to false to enable the "activity" tab in the user's profile. **/

28 isProfileActivityPrivate?: boolean;

29 /** Optional, default false. Set to true to disable profile comments. **/

30 isProfileCommentsPrivate?: boolean;

31 /** Optional, default false. Set to true to disable direct messaging this user. **/

32 isProfileDMDisabled?: boolean;

33}

34

Moderators and Administrators

管理者およびモデレーターには、SSOUser オブジェクト内でそれぞれ isAdmin または isModerator フラグを渡してください。

Notifications

通知を有効または無効にするには、optedInNotifications の値をそれぞれ true または false に設定してください。ユーザーがこの値を含む SSO ペイロードでページを最初に読み込んだときに、通知設定が更新されます。

さらに、ユーザーがサブスクライブしたページでのアクティビティに関する通知メール（アプリ内通知だけでなく）を受け取りたい場合は、optedInSubscriptionNotifications を true に設定してください。

VIP Users & Special Labels

オプションの "displayLabel" フィールドを使用すると、ユーザー名の横に特別なラベルを表示できます。

Unauthenticated users

認証されていないユーザーを表すには、単に userDataJSONBase64、verificationHash、timestamp を設定しないでください。loginURL を提供してください。

これらのユーザーはコメントすることができず、代わりにログインメッセージ（設定に応じてメッセージ、リンク、またはボタン）が表示されます。

Direct Examples for Serializing and Hashing User Data

シリアライズとハッシュ化の具体例については、詳細を こちら（js）、こちら（java）、および こちら（php）で確認できます。

統合は複雑で手間のかかるプロセスになり得ることを理解しています。担当者に連絡するか、サポートページ をご利用ください。

FastComments SSO (詳細はこちら) により、ユーザーは別のプラットフォームにログインすることなくコメントを投稿できるようになります。

しかし、これだけではコメントスレッドは保護されません。デフォルトではコメントデータは公開されており、ページを閲覧できる誰でもコメントを閲覧できます。

設定を変更することで、管理者または有効なSSOユーザー以外はコメントを取得できないように制限できます。

No-Code セットアップ

SSO を設定している場合、カスタマイズルールを作成することで、コメントスレッドの閲覧や操作を防ぐことができます。

SSOで検索すると次のオプションが見つかります：

Require SSO To View Comments

それを有効にして、カスタマイズルールを保存してください。

特定のドメインまたはページのみ保護する

特定のドメインまたはページのみを保護する場合は、カスタマイズルールをそのように設定するだけです。

カスタマイズUIの上部には、Domain と URL ID の2つの入力欄があります。

特定のドメインのみを保護するには、対象のドメインを "domain" フィールドに入力してください。

特定のページを保護するには、ページのURLを "URL ID" フィールドに入力してください。FastComments とカスタム統合している場合は、URLの代わりにここにIDの種類を入力することもできます。

セキュリティレベル

SSO を必須にする場合、Simple SSO と Secure SSO のどちらを要求するかを決める必要があります。Simple SSO を要求すると両方が許可されますが、Secure SSO を要求する場合は、APIキーでハッシュされた Secure SSO ペイロードでコンテンツを取得しない限り閲覧できなくなります。

「Require SSO To View Comments」を選択すると、セキュリティレベルのオプションが表示されます。

閲覧以外の保護

このオプションを有効にすると、ユーザーがSSOでログインしていない限り、そのページやドメインへのコメント投稿ができないように保護されます。

注意点

SSO 統合の前にコメントを作成したユーザーは、SSO 統合でログインしない限りそれらのコメントを閲覧できなくなります。

デフォルトでは、FastComments はコメントする際にメールアドレスを要求します。必ずしも有効なメールアドレスである必要はありませんが、ユーザーが送信されたリンクをクリックするまでは、 コメントに「未確認コメント」ラベルが表示されます。

ただし、メールの入力を必須にしないようにすることもできます。メール入力欄は表示されたままですが、もはや必須ではなくなります。

これはウィジェットのカスタマイズUIで設定できます：

Enabling Anonymous Comments

FastComments は、所定の日数が経過した未確認コメントを削除するように設定できます。これによりスパム対策に役立ちます。

デフォルトでは、行われません。

これは モデレーション設定 ページで設定または無効化できます。

Moderation Settings

ユーザーがコメントを投稿する際、ログインしていない場合はメールアドレスの入力を求められます。

これはそのユーザーの「未検証セッション」を作成し、メールでそのセッションの検証を求めます。

一部のサイトやアプリケーションでは、コメントや投票時にユーザーにメールアドレスを求めたくない場合があります。

匿名コメントを有効にするとメール入力欄は任意になります。ただし、完全に無効化することもできます。まず、匿名コメントを有効にしてください。 その後、メール入力欄を無効にするオプションが表示されます。

Disable Email Inputs

これを有効にすると、当社のすべてのコメント製品でメール入力欄はまったく表示されなくなります。

この設定では、ユーザーがアカウントを作成してログインしない限り、すべてのコメントは未検証になります。 https://fastcomments.com

未検証ラベルを無効にすることを検討してください。

デフォルトでは、FastComments は、ユーザーに残されたコメントで、その ブラウザセッションが未検証である場合に「未検証のコメント」ラベルを表示します。未検証のコメントについての詳細はこちらをご覧ください。

Disable The Unverified Label

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "disableUnverifiedLabel": true

8}];

9</script>

10

さらに、この機能はコードを記述せずにカスタマイズ UI で使用できます：

Disable The Unverified Label

ユーザーがコメントに投票しようとしたとき、ログインしていない場合は、ユーザー名とメールアドレスの入力を求められます。

この要件を削除して、誰でも情報を残さずにコメントに投票できるようにできます。

Allow Anonymous Votes

ユーザーがコメントや投票を行う際、ログインしていない場合は、メールアドレスとユーザー名の入力を求められます。

匿名でのコメントの場合、コメント時の摩擦を減らすためにデフォルトのユーザー名を定義することが望ましい場合があります コメントする際の手間を軽減できます。これはカスタマイズUIから行えます。匿名コメントは事前に有効化しておく必要があります。

Setting The Default Username

既定では、FastCommentsはユーザーのシステムとブラウザによって決定されたロケールでコメントウィジェットを表示します。

ユーザーがコメントしたりログインしたりすると、そのユーザーが最後に使用したロケールを更新し、メール送信にもそのロケールを使用します。

これはコメントウィジェットがユーザー向けにどのように翻訳されるかに影響します。ロケールはユーザーの言語と地域で構成されるため、ロケールを設定すると通常、ユーザーに表示されるテキストの言語が変更されます。

Via The UI

これはウィジェットのカスタマイズUIで定義できます。「Locale / Language」オプションを参照してください：

Changing The Locale / Language

Via Code

これを任意のロケールで上書きできます。

Manually Defining the User's Locale

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "locale": "ru_ru"

8}];

9</script>

10

Supported Languages and Locale Codes

サポートされている言語と対応するロケールコードの完全な一覧はここで確認できます。

SSO に関する注意

SSOを使用している場合、ユーザーオブジェクトにユーザーのロケールを渡しておくと、メールなどが正しくローカライズされます。

デフォルトでは、FastCommentsはコメントに使用される言語を制限しません。

コミュニティで使用する言語を制限したい場合があります。

これはコード不要で、ウィジェットのカスタマイズページで設定できます:

Allowed Languages

システムはコメントを解析してその言語を判定し、許可リストと照合します。

コメントが許可されていない言語で書かれている場合は、ローカライズされたエラーメッセージが表示されます。

readonly フラグを true に設定すると、新しいコメントや投票を受け付けないようにコメント投稿をロックできます。

コメントは編集や削除もできなくなります。

Making The Comment Thread Readonly

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "readonly": true

8}];

9</script>

10

これはコード無しで、ウィジェットのカスタマイズページからドメイン全体またはページ単位で設定できます：

Making The Comment Thread Readonly

更新！

2022年11月現在、スレッドは管理者およびモデレーターが返信欄上部の三点メニューからリアルタイムでロックまたはアンロックできます。

これにより新しいコメントは防止されますが、投票は引き続き可能で、ユーザーが自分のコメントを削除することもできます。一方、readonly ではこれらは許可されません。

これは Page API の isClosed フィールドに対応します。

デフォルトでは、FastCommentsは任意の外部サイトへのリンクを許可します。

これは、代わりに指定したサイトやドメインのリストに制限できます。サイト、またはドメインにリンクを投稿しようとすると、 定義されたリストに含まれていない場合は、ユーザーにエラーが表示されます。

この検証はコメントウィジェットとAPIにのみ適用されます。インポートは影響を受けません。

これはコードを書くことなく、ウィジェットのカスタマイズページで行います：

Restrict External Link Domains

デフォルトでは、FastComments はユーザーに対してコメント、ユーザー名、メールアドレスのみを求めます。

しかし、場合によってはユーザーに自分のブログやウェブサイトへのリンクを残してもらいたいことがあります。

ユーザーのウェブサイトURLを入力するための追加入力フィールドを表示するには、enableCommenterLinks フラグを true に設定します:

Enabling Commenter Links

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableCommenterLinks": true

8}];

9</script>

10

そのURLが提供されると、ユーザーのアカウントが更新され、過去および将来のすべてのコメントに表示されるユーザー名がこのURLにリンクされます。

これはコードなしで、ウィジェットのカスタマイズページで設定できます:

Enabling Commenter Links

このリストはModeration Groupsページで生成されたIDの一覧です。

指定すると、その構成を使用して投稿されたコメントには同じセットの moderationGroupIds が含まれます。

もし Moderator が1つ以上の Moderation Groups を定義している場合、
自分のグループに関連する Moderate Comments ページのコメントのみを見ることができます。

Specify Moderation Groups

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "moderationGroupIds": [

8 "mxZAhjzdb",

9 "FT19nXbqA"

10 ]

11}];

12</script>

13

認証のために、FastCommentsはブラウザでサードパーティのクッキーが有効になっていることに依存します。これが無効だと、ユーザーは常にコメントする際に メールアドレスを入力する必要があり（メール入力欄が非表示の場合を除く）、コメントは常に未検証として表示されます（デフォルト設定）。

これを回避するには、サードパーティ・クッキーバイパスを有効にできます。

この設定を有効にすると、ユーザーがログインされていることを示すメッセージを表示する小さなポップアップが表示されます。 このポップアップ はユーザーがコメントウィジェットとやり取りするたびに表示されます。例えば、コメントを投稿したときなどです。

コードでは、enableThirdPartyCookieBypass フラグを true に設定することでこれを行えます:

Enabling Third-Party Cookie Bypass

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "enableThirdPartyCookieBypass": true

8}];

9</script>

10

また、ウィジェットカスタマイズのUIで Enable Third-Party Cookie Popup の項目から設定することもできます:

Enabling Third-Party Cookie Bypass

デフォルトでは、ユーザーは自分のコメントを削除できます。 また、コメントを削除すると自動的に スレッド内のすべての子コメントおよび一時的なコメントも削除されます。この動作はライブ環境でも同様に適用されます。

これを以下の方法で制限できます：

• 代わりに、削除されたコメントを匿名化する（名前とテキストを [deleted] またはカスタム値に設定する）。
• 返信がある場合にコメントの削除を許可しない。カスタマイズ可能なエラーメッセージが表示されます。
• コメントに返信がある場合の削除を管理者とモデレーターのみに制限する。

これはウィジェットカスタマイズUIの Comment Thread Deletion セクションで設定できます。

Customize Delete Behavior for Replies

デフォルトでは、FastComments はユーザーのバッジをコメントスレッド内のコメントにのみ表示します。

ただし、ウィジェットのカスタマイズページでこの機能を有効にすると、コメントフォームの上にある名前の隣にユーザーのバッジを表示できます:

Show Badges in Top Bar Option

これにより、ユーザーがコメントを作成しているときに、トップバー領域で名前の横にバッジが表示され、実績やステータスがより目立つようになります。

この機能が動作するには、ウィジェットのカスタマイズUIで有効にする必要がある点に注意してください。サーバー側で有効になっている場合でも、コード構成で showBadgesInTopBar フラグを false に設定して、個別に無効化することもできます:

Disable Show Badges in Top Bar

Copy Run

1

2<script async src="https://cdn.fastcomments.com/js/embed-v2-async.min.js"></script>

3<div id="fastcomments-widget"></div>

4<script>

5window.fcConfigs = [{

6 "tenantId": "demo",

7 "showBadgesInTopBar": false

8}];

9</script>

10