カスタマイズと設定
コンテキスト
ここでは、コメントウィジェットがサポートする各機能と設定についての詳細なドキュメントを確認できます。
本ドキュメントではコアコンセプトをカバーし、各機能領域について使い方やよくある落とし穴を含めて詳しく説明します。
コード例を示し、該当する行をハイライトします。該当する場合は設定ページのスクリーンショットも提供します。
コード例では当社のバニラJavaScriptライブラリを使用しますが、設定オプションはコメントウィジェットの全バージョン（React、Vue など）でまったく同じ名前を使用しています。
このガイドで説明するほとんどの設定と機能は、コードを書く必要はありません。
アカウントの識別 
コメントウィジェットは例えばテナントIDに "demo" を使って利用できることに気付くかもしれません:
Run 
これはコメントウィジェットを試して遊ぶためのものです。 本番環境では、次のようにあなたのテナントIDを渡します:
Run あなたのテナントIDは、コメントウィジェットのあなたのアカウント内のコードスニペットに既に適用されているのが確認できます。
テナントIDを見つけたり、APIキーを管理したりするには、API認証情報ページをご覧ください。
以降、FastCommentsにログインしている場合、コード例ではあなたの実際のテナントIDが使用されます（https://fastcomments.com にログインしている場合）。
コメントがページや記事に紐付けられる仕組み
コメントスレッドを表示したり、コメントを投稿したりする際、FastComments はそのコメントがどのページ、記事、または製品に属しているかを把握する必要があります。
これを行うために、私たちは「URL ID」と呼んでいるものを使用します。これは文字列や数字のような識別子、または URL です。
デフォルトでは、urlId を指定しない場合、ページの URL が URL ID になります。現在のページの URL を取得し、一般的なマーケティングパラメータやトラッキング識別子を削除してクリーンにします。
WordPress のようなサードパーティ統合の場合、プラグインは通常、表示中の情報を表す識別子（たとえば記事/ページ ID）を URL ID として使用します。
Run 本ドキュメントでよく参照するものの一つに、Widget Customization UI があります。
この UI を使うと、コードを使わずにコメントウィジェットを多くの点で変更できます。
カスタマイズルールを作成する際、サイトのすべてのページに適用したいことがよくあります。しかし、特定のページに対してコメントウィジェットをカスタマイズしたい場合もあります。例えば、特定のページだけカスタムスタイリングを適用したり、そのページのコメントを匿名にしたりすることができます。また、あるページではライブコメントをすぐに表示し、別のページでは通知ボタンの下に隠す、といったことも可能です。
これはすべて、このページの URL ID 入力フィールドを使って実現できます。見た目は次のようになっています:
このフィールドの値は、コメントウィジェットに渡される 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.
注意点
- ページにハッシュパラメータ（例: example.com#page-1）がある場合 - デフォルトではこれが URL ID の一部になります。
- WordPress から Gatsby への移行などのマイグレーション中は、初回の移行後に URL ID コメント値を移行する必要がある場合があります。その際はお問い合わせください。
異なるページで同じコメントを表示する
urlId パラメータはコメントがどのページ、またはどのIDに紐づくかを定義できるため、これらのページでは単に urlId を同じ値に設定すればよいです。
Run カスタムスタイル
FastComments はカスタマイズできるように設計されています。コメント用ウィジェット自体はセキュリティ上の理由から iframe 内で動作するため、カスタムスタイリングを適用するには次のいずれかの方法に従う必要があります。
最初で、最も簡単な方法（かつ当社推奨）は、widget customization page を使用することです。
ウィジェットカスタマイゼーションページでは、"Show Advanced Options" セクションを参照し、その下に "Custom CSS" とラベル付けされた領域があります。
この方法にはいくつかの利点があります:
- 入力された CSS はユーザーに送信される前に圧縮され、編集 UI のフォーマットが一貫して保たれます。
- ウィジェットカスタマイズ UI のすべての利点を享受できます。例えば、サイトごとにコメントウィジェットを簡単に異なるカスタマイズにできます。
- コメントウィジェットに変更を加える際、あなたのカスタムスタイルは当社のリリースプロセスの一部としてテストされます。
2つ目の方法は、ウィジェット構成で customCSS パラメータを指定することです。以下のように:
Run ただし、これは制限があります:
- ヘッダーのサイズのため、サーバーがリクエストを拒否する前に渡せるカスタム CSS の量には制限があります。
- カスタム CSS をあなたのインフラやビルドシステムで管理する必要があります。これはむしろ利点になる場合もあります。
- このユースケースでは、カスタム CSS をネットワーク上で2回送信する追加のオーバーヘッドがあります。まず当社のサーバーへ送信され、次に iframe コンテンツ内で返送されるためです。ただし、ほとんどのペイロードサイズではこれは目立ちません。
- 一般的な最適化として、ネットワーク上のサイズを削減するために CSS を圧縮（ミニファイ）することがありますが、この方法ではそれを自分で処理する必要があります。
- この方法では、当社が変更を行った際にあなたのカスタム CSS はテストされません。
External CSS Files
ウィジェットに外部ファイルをフェッチさせるには @import を使用できます！
@import をカスタマイズルールに入れておくことを推奨します。こうすることで、当社がコメントウィジェットに変更を加える必要が生じた場合に、当社の自動化ツールを使ってあなたの設定を検証できます。例えば、ウィジェットカスタマイズ UI でカスタマイズルールを作成し、Advanced をクリックして Custom CSS に次のように入力します:
@import url(https://example.com/styles.css);In Code - Not Recommended
外部 CSS ファイルは customCSS プロパティ経由でも読み込めます:
Run ただし、この方法を採ると当社であなたの CSS をテストできないことを忘れないでください。
User Profile Modal Styling
ユーザープロファイルのモーダルもカスタム CSS でスタイリングできます。ただし、ユーザープロファイルにカスタムスタイリングを適用するには、すべての CSS セレクタが .user-profile でプレフィックスされている必要があります。このプレフィックスがない場合、ユーザープロファイルモーダルにはカスタムスタイリングは適用されません。
例えば:
Run Backwards Compatibility
FastComments では、お客様がコメントウィジェットをカスタマイズすることを承知しています。それは設計上の意図です — 当社の製品があなたの製品のデザイン不整合を引き起こす最後のものにしたくありません。
これは当社の製品の重要な部分であるため、リリースごとに顧客ごとのコメントウィジェットの変更をレビューできるビルドパイプラインを用意しています。
軽微な問題が見つかった場合は、リリースが円滑に進むようにお客様のアカウントを更新します。重大な破壊的変更が見られる場合は、リリースを停止することができます。
カスタムフォント
FastComments はカスタマイズ可能になるよう設計されており、ウィジェットで使用するフォントも例外ではありません。
デフォルトでは、FastComments は幅広いデバイスでできるだけ見栄えが良くなるように system font stack を使用します。
独自のフォントを定義するには、Custom CSS ドキュメント を参照してください。
そこにはカスタム CSS を定義する方法が記載されており、希望するフォントを設定できるようになります。
フォントの定義方法
フォントを上書きするには、.fast-comments, textarea セレクタを使用して CSS を定義することをお勧めします。例：
Run ブランディングの削除
Pro または Enterprise アカウントをお持ちのお客様は、ホワイトラベリングが可能です。単に お問い合わせください。喜んでお手伝いします。
コメントウィジェットから当社のロゴを削除したいだけの場合、Flex および Pro プランではこれが自動的に有効になります。
これらのプランは、当社のプラットフォームから送信されるメールについても同じ機能を提供します。
ダーク背景（ダークモード）への対応
デフォルトでは、FastComments のコメントウィジェットはほとんどのサイトでダークモードを自動的に検出します。
ダークモードが検出されると、FastComments は白背景に黒い文字から黒背景に白い文字へ切り替わります。画像も変更されます。
ページ読み込み時に、ウィジェットはコメントウィジェットの背後にあるページの背景がどれくらい暗いかを判定しようとします。これはつまり ページ自体は白い背景でも、コメントウィジェットを黒い背景のコンテナ内に置けば、ダークモードが コメントを読みやすくするために自動的に有効になるはず、ということです。
しかし、「luminance」を判定する検出メカニズムは、望むときにダークモードを有効にしない場合があります。強制的に有効にするには、次のように hasDarkBackground フラグを true に設定してください:
Run ダークモードの切り替え
ページの初回読み込み後にダークモードの切り替えを許可するサイトでは、これにはもう少し手間がかかります。
まず、Commentウィジェットライブラリのすべての現在のバージョン（React、Vue）には、それぞれのリポジトリにダークモード切り替えの例があります。
VanillaJSウィジェットについては、もう少し作業が必要です。まず、FastCommentsUIは "destroy" と "update" の関数を持つオブジェクトを返します。
コメントウィジェットの設定を更新したいたびに、単純にupdate関数を呼び出すことができます。以下は、VanillaJSウィジェットでダークモードを切り替える完全に動作する例です。
Run テキストの上書き
FastComments では、コメントウィジェット内のすべてのテキストをカスタマイズできます。
送信ボタンなど単一のテキストだけを上書きすることも、コメントウィジェット全体のすべてのテキストを上書きすることもできます。
デフォルトでは、コメントウィジェットのテキストはユーザーのロケールに基づいて翻訳されます。ただし、ユーザーベースが同じロケール/言語を使用していると確信している場合は、テキストを上書きすることができます。例えば:
Run すべてのカスタマイズ可能な翻訳は、こちらの「詳細オプション」タブで確認できます。
しかし、ウィジェットカスタマイズUIを使ったより簡単な方法があります。そこで、コメントウィジェットに表示される EN_US ロケールのテキストを見つけて、置き換えを指定できます。
現在、翻訳の上書きはすべてのロケールに対して適用されます。
デフォルトアバターの変更
ユーザーが FastComments で初めてコメントする際、http://gravatar.com/ からアバターを取得しようとします。
しかし、アバターが見つからない場合や、ユーザーがアカウントにアバターを設定していない場合は、静的なデフォルトのアバター画像を表示します。
独自の静的アバター画像を指定するには、defaultAvatarSrc 設定を使用できます。
Run これはコードなしでも行えます。ウィジェットのカスタマイズページで「Default Avatar」セクションを参照してください。
特定のユーザーのアバターを定義する（SSO を使用する場合など）については、別のセクションで説明しています。
アバターの無効化
ユーザーが独自のアバターを設定していても、コメントウィジェットからアバターを完全に削除できます。
Run これはウィジェットのカスタマイズページでコード不要で設定できます:
デフォルトスタイルをすべて無効化
より大規模なカスタムスタイリングのプロジェクトでは、最初からクリーンな状態で始め、デフォルトのスタイリングをまったく使用しないほうが望ましい場合があります。
すべてのデフォルトスタイリングは、noStyles パラメータを true に設定することで削除できます。以下のように設定します:
Run これはコードを使わずに、ウィジェットのカスタマイズページの「詳細オプション」でカスタマイズできます:
コメントからページへのリンク
通知メールを送信したり、モデレーションページのようなユーザーインターフェースでコメントを表示したりする際に、コメントから それが掲載されているページへリンクできると便利です。
If URL ID isn't always an ID, then we have to store the URL some place else. That's what the "url" property is for, defined as follows.
Run 一般的なユースケースは、コメントスレッドを記事のような識別子に紐付け、その後特定のページにリンクすることです。例えば：
Run The URL does not get cleaned of common marketing parameters. By default, whatever the current page URL is, is the URL stored with the comment.
返信をデフォルトで折りたたむ
デフォルトでは、トップレベルのコメントに対する返信が表示されます。
これを設定すると、ユーザーはトップレベルのコメントで「返信を表示」をクリックしないと子コメントが表示されないようにできます。
Run これはコードなしでウィジェットのカスタマイズページから変更できます：
この設定は、最初に読み込まれるトップレベルのコメント数には影響しません。もしトップレベルのコメントが1件で、その下に29件の子コメントがある場合、この設定を有効にすると次のようになります：
- トップレベルのコメントが表示されます。
- このコメントの下に「返信を表示 (29)」が表示されます。
このオプションと組み合わせて、すべてのトップレベルのコメントを表示したい場合は、starting page を -1 に設定する。
WYSIWYGを有効化
デフォルトでは、FastComments の書式機能は、テキストの周りに <b></b> のような目に見えるアンカータグを追加することで行われます。ツールバーをクリックするかショートカットを使うと、自動的にこれが適用されます。しかし、一部のコミュニティではアンカータグを使わずに書式を適用したい場合があります。これを
WYSIWYG（表示されるものがそのまま反映される）エディタを有効にする、という言い方をします。このエディタはデフォルトのものと見た目はまったく同じですが、目に見えるアンカータグを使わずにユーザーがテキストを太字や下線などにできるようにする追加のコードを読み込みます。
Run これはコードなしでも行えます。ウィジェットのカスタマイズページで、"Enable Advanced Formatting" オプションをご覧ください。
ツールバーの無効化
デフォルトでは、FastComments はコメントを作成する際に、テキストの装飾やアップロード 画像のショートカットを提供するツールバーを表示します。
このツールバーは、コードまたはカスタマイズ UI で無効にできます。
Run これはコードを使わずに行うこともできます。ウィジェットのカスタマイズページで「返信ツールバーを無効にする」オプションを参照してください。
ブロック機能の無効化
デフォルトでは、FastCommentsはユーザーが他のユーザーをブロックできるようになっています。ブロックされたユーザーのコメントはマスクされ、 ユーザー間の通知が無効になり、その他の影響があります。
この機能を無効化したい場合があります。次のように行えます：
Run これはコードを使わずに、ウィジェットカスタマイズUIを通じて行うこともでき、その場合はサーバー側での適切な検証も有効になります：
表示するページの決定
コメントを取得してレンダリングする際、コメントウィジェットはどのページから開始するかを知る必要があります。デフォルトでは最初のページから始まり、そのページのみがレンダリングされます。
必要に応じて、描画する正確なページを設定 startingPage としてコメントウィジェットに渡すことができます。
Run ページ番号は0から始まることに注意してください。そのため、上の例は2ページ目をレンダリングします。
ページをリロードせずにコメントスレッドを切り替える
We've covered how urlId is the page or article id the comments are tied to.
Also, to recap, if not defined the urlId will default to the current page URL.
What about SPAs, or Single-Page-Applications, where the page or content the comments are tied to changes dynamically without a fresh page reload?
Angular、React、Vue など
With our libraries such as Angular and React, simply updating the urlId property passed to the widget
will cause the comment widget to refresh. You can see this in action for the React app, for example, こちら.
VanillaJS
If you're using the VanillaJS library it is slightly more complicated as there isn't a framework like Angular or React to handle the data binding or state propagation.
When you instantiate the VanillaJS widget, it returns some functions which can be called to update it.
Here's a functional example where we change the page hash and update the comment widget:
Run 絶対日時（人間向けタイムスタンプを無効化）
デフォルトでは、ローカライズされた相対日時が使用されます。たとえば、最近投稿されたコメントの横に "11分前" と表示されることがあります。
絶対日時を使用する必要がある、または望ましい場合は、このパラメータを true に設定します。
Run これはコードを使わず、ウィジェットのカスタマイズページの「詳細オプション」から設定できます:
絶対日時と相対日時の両方を表示する
デフォルトでは、ローカライズされた相対日付が使用されます。例えば、最近投稿されたコメントの横には「11分前」のように表示されることがあります。
この相対日付形式を維持しつつ、同時に完全な日付も併せて表示したい場合は、このパラメータを true に設定します。
Run これはコードなしで、ウィジェットのカスタマイズページの「詳細オプション」でカスタマイズできます。UIでこのオプションを表示するには、まず Absolute Dates を有効にする必要があります。
ヘッダーテキストの追加
ヘッダーやメッセージのようなテキストは、コメント数の下、ログイン状態のテキストの上に表示できます。
これをヘッダーと呼び、デフォルトでは非表示です。
Run これはコードなしで、ウィジェットのカスタマイズページの「詳細オプション」から変更できます：
リンクをテキストとして表示する
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:
ボタンでコメントを切り替える
デフォルトでは、FastComments はコメント入力ボックスとコメントスレッドを同時にレンダリングします。垂直方向のスペースを節約するため、ウィジェットが操作されるまで他の必須フィールドは非表示にします。
ただし、コメントウィジェットをボタンの背後に隠すこともできます。例えば:
ボタンはコメントが現在表示されているかどうかに応じて、異なる翻訳済みテキストを使用します。コメントが非表示の場合は translations.SHOW_COMMENTS_BUTTON_TEXT を使用します。コメントが表示されている場合は translations.HIDE_COMMENTS_BUTTON_TEXT を使用します。翻訳テキストには [count] というテキストを含めることができ、ローカライズされたカウントに置き換えられます。
Run これは hideCommentsUnderCountTextFormat 設定を置き換えるために設計されています。
カウントはコメントスレッドとリアルタイムで更新されます。コメントがない場合、ボタンは表示されません。
これは、カスタマイズルールを作成して「クリックしてコメントを表示」を有効にすることで、コード不要で有効化できます。
コメント数テキストのカスタマイズ
コメントウィジェットの上部に表示されるコメント数はカスタマイズできます。
これには任意の文字列を設定でき、値 [count] はユーザーのロケールに合わせてローカライズされた件数に置き換えられます。
Run これはコードを書く必要はなく、ウィジェットのカスタマイズページで設定できます：
画像リダイレクトを無効化
デフォルトでは、FastComments はユーザーが画像をアップロードできるようにしています。ユーザーがその画像をクリックすると、FastComments はデフォルトで 別タブを開き、その画像をフルサイズで表示します。このフラグを true に設定するとこの動作が無効になります：
Run 画像のクリックを自分で捕捉する予定がない場合（onImageClicked を参照）、画像がクリック可能に見える見た目を取り除くために、これを何らかのスタイリングと組み合わせることを推奨します。
自動ハッシュタグ作成を無効化
ユーザーが #someexampletag の形式でハッシュタグを入力すると、FastComments は自動的にその HashTag を作成し、
コメント内でハイライトします。
場合によっては、この機能を無効にしたり、API 経由で使用できるハッシュタグを制御したりすることが望ましい場合があります。
そのためには、ウィジェットのカスタマイズ UI で Disable Automatic #hashtag Creation を有効にしてください。
通知ベルを無効化
デフォルトでは、FastComments はコメントエリアの右上に通知ベルを表示します。
このベルは赤くなり、ユーザーが持っている通知の数を表示します。通知の例は次のとおりです：
- ユーザーがあなたに返信しました。
- ユーザーがあなたがコメントしたスレッドに返信しました。
- ユーザーがあなたのコメントに賛成票を投じました。
- ユーザーがあなたが購読しているページに返信しました。
通知ベルは、ページ全体を購読するための仕組みも提供します。
ただし、通知ベルを完全に無効にすることもできます：
Run コードを書かなくてもこれを行うことができます。ウィジェットのカスタマイズページで「通知ベルを無効にする」セクションを参照してください。
プロフィールを無効化
デフォルトでは、FastComments はユーザーのアバターをクリックするとそのユーザーのプロフィールを表示します。
ただし、この機能を無効にすることができます:
Run これはコードを使わなくても行えます。ウィジェットのカスタマイズページの「Disable Profiles」セクションを参照してください。
プロフィールへのコメントを無効化
デフォルトでは、FastComments はユーザープロフィールに「プロフィールコメント」タブを表示し、訪問者が誰かのプロフィールにコメントを残せるようにします。
ただし、このタブを無効にすることができます:
Run これはコードなしでも行えます。ウィジェットのカスタマイズページで「プロフィールコメントを無効にする」セクションを参照してください。
プロフィールのダイレクトメッセージを無効化
デフォルトでは、FastComments はユーザープロフィールに「ダイレクトメッセージ」タブを表示し、訪問者がユーザーにダイレクトメッセージを送信できるようにします。
ただし、このタブを無効にすることができます:
Run この設定はコードを使わずに行うこともできます。ウィジェットのカスタマイズページで「ダイレクトメッセージを無効にする」セクションを参照してください。
成功メッセージを無効化
デフォルトでは、FastComments はコメント投稿後に成功メッセージを表示します。これを無効にするには、次のようにします:
Run これはコードなしでも行えます。ウィジェットのカスタマイズページで:
GIFのコンテンツ評価を変更する
デフォルトでは、FastComments コメントウィジェットは gif rating を pg に設定します。
利用可能なオプションは g、pg、pg-13、および r です。
これはコードまたは UI で設定できます。コード内では次のようにします：
Run UI では、Disable Image Uploads? がチェックされていない限り、Gif Picker Rating の下にあります。
画像コンテンツのモデレーション
デフォルトでは、FastComments のコメントウィジェットでは画像コンテンツのモデレーションが off になっています。
利用可能なオプションは off、low、medium、および high です。
ウィジェットのカスタマイズ UI では、Disable Image Uploads? がチェックされていない限り、Image Content Moderation Level の項目でこれを見つけることができます。
投票スタイルの変更
デフォルトでは、FastComments は投票オプションを上矢印と下矢印として表示し、ユーザーはコメントに対して賛成（アップ）または反対（ダウン）投票を行えます。
ただし、投票ツールバーのスタイルを変更することができます。現在のオプションは、デフォルトの上下ボタン、またはハートスタイルの投票メカニズムです。
以下のように voteStyle フラグを使用します：
Run サーバー側の検証も有効になるため、コードを使わずに行うことを強く推奨します。ウィジェットのカスタマイズページで "Vote Style" セクションを参照してください。
投票は無効にすることもできます。スタイルオプションの上にある Disable Voting を参照してください。
削除を無効化
デフォルトでは、FastComments はユーザーが自分のコメントを削除できるようにします。
ただし、この動作を無効にすることが可能です。
ウィジェットのカスタマイズページで「削除を無効にする」オプションを参照してください。
- これは通常のコメント投稿者にのみ影響し、モデレーターや管理者は引き続き削除できます。
contextUserIdが渡される API 統合にも影響します。
編集を無効化
デフォルトでは、FastComments はユーザーが自分のコメントを編集できるようになっています。
ただし、これを無効にすることが可能です。
ウィジェットのカスタマイズページで「編集を無効化」オプションを参照してください。
- これは通常のコメント投稿者にのみ影響し、モデレーターや管理者には影響しません。彼らは引き続き編集できます。
- これは
contextUserIdが渡された場合の API 統合にも影響します。
新しいコメントのハイライト
FastComments は新しいコメントを強調表示するためのいくつかの方法を提供します。
First and foremost, by default comments that triggered an in-app notification (replies, replies in same thread, or comments on a page
あなたが購読しているページのコメント）が自動的にユーザーのアバターがわずかに光る形で強調表示されます。色は CSS
を使用して is-unread クラスでカスタマイズできます。
過去24時間に投稿されたコメントには 24hr クラスが適用されており、スタイリングに使用できます。
Finally, any new live comments that show up in the user's session will be highlighted for several seconds via an animation. This is done via the
is-live CSS class and can be customized as well.
ページサイズ
デフォルトでは、FastComments のページサイズは 30 です。スレッド内の返信も含まれます。
ページサイズは ウィジェット設定 UI でカスタマイズでき、10 から 200 の範囲で選択できます。
ページサイズを変更すると、アカウント内のすべてのコメントスレッドを再計算する必要があります。これには数分かかる場合があります。
ページはサーバー側で計算されるため、クライアント側のウィジェットでは設定できません。
以下に設定例を示します:
ページサイズはグローバル、ドメインごと、ページごとに異なるカスタマイズルールを作成することで変更できます。
これにより、当社プラットフォームを通じてコメントを表示するために使用しているすべてのクライアント、統合、およびフレームワークに影響します。
メールテンプレート
FastComments からお客様へ送信されるメールはカスタマイズできます。テンプレート、ロジック、 翻訳もすべて変更できます。テキストはロケールごとにカスタマイズでき、スタイリング ドメインごとに変更することも可能です。 カスタムメールテンプレートの詳細はこちら
ユーザー名の形式
デフォルトでは、FastComments はユーザーが入力した名前、または SSO を介して渡された名前をそのまま表示します。
しかし、ユーザー名をマスクしたり別の形式で表示したい場合もあります。例えば、ユーザー名が Allen Rex の場合、もしかしたら "Allen R." のみを表示したいかもしれません。
This can be done without code in the Widget Customization UI, under the setting called Commenter 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 に設定することで無効にできます。
Run これはウィジェットのカスタマイズページで、コードを使わずに変更できます：
検索ボックスを有効化
デフォルトでは、コメントウィジェットには検索ボックスは表示されません。
ただし、enableSearch フラグを true に設定することでこれを有効にできます:
Run コードを使わずにこれを行うこともできます。ウィジェットのカスタマイズページで「Enable Search Box」オプションを参照してください。
スポイラーを有効化
スポイラー機能はenableSpoilersフラグをtrueに設定することで有効にできます:
Run これはコードを使わずに行うこともできます。ウィジェットのカスタマイズページで、"Enable Spoilers" オプションを参照してください。
テキストがハイライトされ、表示された SPOILER ボタンがクリックされると、ユーザーがマウスオーバーするまでテキストはマスクされます。ダークモードでも同じ処理を行いますが、異なる
色を使用してダークモードにより適合させます。
これはWYSIWYGエディタとも互換性があります。
コメントの閲覧数表示を有効化
デフォルトでは、FastComments は各コメントを誰が閲覧したかを追跡したり、その統計を提供したりしません。
しかし、この機能を有効にすると、ユーザーがコメントまでスクロールするたびにシステムがその閲覧を追跡し始めます。
これが起きると、各コメントに表示される目のアイコンの横にあるカウントが増加します。カウントはリアルタイムで更新され、ユーザーのロケールに応じて省略表示されます。
この機能は enableViewCounts フラグを true に設定することで有効にできます:
Run これはウィジェットカスタマイズページで、コードを使わずに設定できます:
コメントを閲覧した user id* を追跡するため、同じユーザーがコメントを再度閲覧してもカウントは増えません。2年後に再度そのコメントを閲覧した場合、カウントは再び増加します。
- *注: または anon session id、あるいはユーザーの IP をハッシュ化した値。
ライブコメントを即時表示する
デフォルトでは、ライブコメント機能は有効になっています。つまり、コメントが追加、削除、編集、またはピン留めされると、変更は表示される すべてのユーザーに同時に反映されます。
ただし、デフォルトではそれらの新しいコメントは「Show 2 New Comments」のような文言が表示された動的なボタンの下に表示されます。
新しいコメントがページに直接対する返信である場合、そのボタンはコメントスレッドの上部に表示されます。特定のコメントへの返信である場合は、 そのコメントの下にボタンが表示されます。
これは、ページのサイズがユーザーに対して絶えず変化し、スクロールバーを掴もうとしたときにフラストレーションを引き起こす可能性があるのを防ぐためです。
ライブ入札やオンラインイベントのようなユースケースでは、これは望ましくない動作であることがあります — コメントウィジェットが新しいコメントを「すぐに表示する」チャットボックスのようになってほしい場合があります。
したがって、その機能を有効にするフラグの名前は次のとおりです: showLiveRightAway。
次のようにオンにできます:
Run コードを使わず、ウィジェットのカスタマイズページでこれをカスタマイズすることもできます:
ライブコメントの無効化
デフォルトでは、FastCommentsはライブコメント機能が有効になっています。
これは、コメントスレッドのすべての閲覧者が同じ内容を見ることを意味します。
たとえば、コメントが追加された場合、そのコメントが表示されます。コメントが編集または削除された場合、 その編集や削除はスレッドの全ての閲覧者に対して反映されます。投票やすべてのモデレーション操作も同様です。
ただし、これを無効にすることもできます:
Run これはコードを使わずに行うこともできます。ウィジェットのカスタマイズページで "Disable Live Commenting" セクションを参照してください。
新しいライブコメントを下に表示する
デフォルトでは、新しいライブコメントはリアルタイムで投稿されるとコメント一覧の上部に表示されます。
このオプションを有効にすると、新しいライブコメントは代わりに一覧の下部に追加されます。これは、ユーザーがコメントスレッドを閲覧している間にコメントがライブで投稿されたときの表示方法に影響します。
Run With this setting enabled:
- 他のユーザーが投稿した新しいライブコメントはコメント一覧の下部に表示されます
- ユーザーは既存のコメントの下に新しいコメントがリアルタイムで表示されるのを確認できます
- これはライブコメントの更新にのみ影響し - 初回のページ読み込みには影響しません
- ユーザーが議論を追っているときに読み進める流れを維持するのに役立ちます
Note that this setting only affects where new live comments are placed as they arrive in real-time. It does not affect the initial sort order when the page loads.
無限スクロールを有効化
デフォルトでは、FastComments ウィジェットは表示されているすべてのコメントに合わせて縦方向に自動的にサイズを調整します。ページネーションは現在のページ末尾にある「次を表示」ボタンで行われます。これは多くのユーザーにとって最も自然に感じられる操作方法であると判断しているためです。
しかし、無限スクロールの方が好まれるケースもあります。例えば、Stream Chat 製品ではこの機能を使用しています。
enableInfiniteScrolling フラグを true に設定することで、「次を表示」ボタンを非表示にして無限スクロールに切り替えることができます:
Run これにはカスタム CSS の追加も必要です。スクロールを有効にするには、.comments セレクタに対して次のようなカスタム CSS を追加します。例えば：
Run 完全な動作例は次のとおりです：
Run 上の例では customCSS プロパティを使用していますが、パフォーマンスの観点からは代わりにウィジェット設定 UI を使用することを推奨します。 カスタム CSS のドキュメントを参照してください。
デフォルトの並び順を変更する
デフォルトでは、FastComments はコメントを「Most Relevant」（最も関連性が高い）ソート方向で並べます。
「Most Relevant」ソートは、コメントが投稿された時間と投票数を考慮して並べ替えます。
ユーザーはコメントウィジェットの UI でソート方向を Oldest（古い順）または Newest First（新しい順）に変更できます。
ただし、デフォルトはこれら3つのいずれにも変更できます。例えば、最も古いコメントを先に表示したい場合:
Run defaultSortDirection の値を "OF" に設定して、方向を "OF" にします。
新しい順（Newest First）のソート方向にするには、次のようにします:
Run defaultSortDirection に使用できる値は次のとおりです:
- MR: "最新順"
- NF: "新しい順"
- OF: "古い順"
これはコードなしでも行えます。ウィジェットのカスタマイズページの「デフォルトのソート方向」セクションを参照してください。
注意: 各ページのコメントは各ソート方向ごとに事前計算されているため、すべてのソート方向でパフォーマンスは同じです。
すべてのコメントを一度に表示する（ページネーションを無効化）
ページネーションを無効にして、すべてのコメントを一度にレンダリングするには、startingPageを-1に設定します。
Run 返信ボックスをコメントの後に移動する
デフォルトではコメント入力欄はコメントスレッドの前にあります。しかし、この設定パラメータを true に設定すると、コメント入力欄をコメントスレッドの後に移動できます。
Run コードを書かずに、ウィジェットのカスタマイズページで設定できます:
コメントの長さを制限する
コメント入力フィールドに入力できる最大文字数は、maxCommentCharacterLength パラメータで制限できます。
デフォルトは2000です。
画像のURLなどは文字数の判定に含まれません。
Run これはウィジェットのカスタマイズページで、コード不要でカスタマイズできます：
複数行コメントを無効化
デフォルトでは、FastComments はユーザーがデフォルトの文字数制限内で、好きなだけ行数のあるコメントを入力できるようになっています。
しかし、ユーザーの入力を1行のテキストのみに制限したい場合もあります。例えば、オンライン入札やライブチャットなど、FastComments で使用できるケースがあります。
We enable the useSingleLineCommentInput flag as follows:
Run これはコードを使わずに行うこともできます。ウィジェットのカスタマイズページで、「シングルラインのコメント入力を有効にする」セクションを参照してください。
注意：各ページのコメントは、各ソート方向ごとに事前に計算されるため、すべてのソート方向でパフォーマンスは同じです。
ユーザーごとのコメント数を制限する
デフォルトでは、各ユーザーは同じ1分間に最大5 commentsを投稿できます。
これは user id、anon user id、および ip address (hashed) によって追跡されます。
これはウィジェットのカスタマイズページでコード不要でカスタマイズできます:
注意: comment creation API を使用している場合、リクエストでユーザーの元の ip アドレスを当社のバックエンドに渡すことを検討してください。レート制限がユーザーごとに適用され、アカウント全体には適用されないようにするためです。
新しいトップレベルコメントを禁止する
noNewRootComments を true に設定すると、ウィジェットはルート返信エリアを非表示にしますが、ユーザーは返信
を子コメントに対して行うことができます。例えば、ページ読み込み時に条件付きでこれを設定し、一部のユーザーのみがトップレベルのコメントを残せるようにすることができます。
Run 返信の最大階層
デフォルトでは、FastComments は返信のネストを無制限に許可し、ユーザーが返信に対して際限なく返信できるスレッド構造を作成します。
maxReplyDepth オプションを使うと、返信スレッドの深さを制限できます。最大深度に達すると、そのレベルのコメントには返信ボタンが表示されなくなります。
Run With maxReplyDepth set to 2:
- ユーザーはトップレベルでコメントできます（depth 0）
- ユーザーはトップレベルのコメントに返信できます（depth 1）
- その返信にさらに返信できます（depth 2）
- depth 2 を超える返信は許可されません
maxReplyDepth を 1 に設定すると、トップレベルのコメントへの返信のみが許可され、より平坦な議論の構造になります。
maxReplyDepth を 0 に設定すると、すべての返信が無効になり、トップレベルのコメントのみが許可されます。指定しない場合、返信は無制限にネストされます。
利用規約の同意を必須にする
FastCommentsでは、初めてコメントするユーザーに対して、コメントを送信する前に利用規約への同意を必須にすることができます。
When enabled:
- Anonymous users will see a TOS checkbox every time they comment
- Authenticated users will see the checkbox only on their first comment, or when you update your TOS
設定
ウィジェットのカスタマイズページに移動し、「Require Terms of Service acceptance」チェックボックスを有効にします。 有効にすると、以下のオプションが表示されます:
- TOS Text Mode: デフォルトでは、チェックボックスには両方のドキュメントへのリンク付きで "I agree to the Terms of Service and Privacy Policy" と表示されます。 "Customize text per locale" を選択すると、各言語ごとに独自のテキストを指定できます。
- TOS Last Updated Date: 利用規約を更新したときは、この日付を設定してください。この日付より前に同意したユーザーは再度同意が必要になります。
仕組み
- 利用規約同意のタイムスタンプはユーザーごと・コメントごとに保存されます
- ユーザーが利用規約に同意すると、その日付はユーザープロフィール（テナントごと）に記録されます
- 設定した「最終更新日」がユーザーの同意日より後であれば、再度同意が必要になります
- 追跡できない匿名ユーザーについては、チェックボックスが各コメント送信時に表示されます
シングルサインオン (SSO) の概要
SSO（シングルサインオン）は、ユーザーが別のアカウントを作成することなく FastComments を利用できるようにするための一連の規約です。
匿名コメントを許可していないと仮定すると、FastComments でコメントするにはアカウントが必要です。サインアップは非常に簡単で、ユーザーはコメント時にメールアドレスを入力するだけです。 しかし、それすらも避けたいサイトがあることは理解しています。
どうやって利用できますか？
現在、すべてのアカウントタイプで SSO にアクセスできます。ただし、SSO ユーザーの最大数はプランによって異なります。他の機能と同様に、Pro プラン以上では直接的な開発サポートが提供されます。
オプションを比較した後、各オプションの詳細を説明します。
ユーザーとコメントの移行
Disqus のような SSO を提供するプラットフォームから移行する場合、すでにユーザーとそのコメントが存在します。
コメントは移行の一環として、API、Import UI、またはカスタマーサポートによってインポートされます。使用しているプラットフォームを Import UI がサポートしている場合、エラー処理、アバターやメディアの抽出とアップロード、バッチジョブの監視システムが組み込まれているため、Import UI を使用することを推奨します。
ユーザー自体は、コメントスレッドを初めて表示したときに自動的に追加されます。あるいは、API を通じて事前に追加することもできますが、その作業は多くの利点をもたらしません。
コメントがインポートされ、SSO ユーザーが API で手動追加されていない場合、ユーザーが任意のコメントスレッドを初めて表示してアカウントが作成される際に、該当するコメントは自動的にそのユーザーのアカウントに移行されます。その後、ユーザーは元のコメントを管理、編集、削除できるようになります。
自動移行はメールアドレスまたはユーザー名で行われます。Disqus のようにエクスポート時にメールアドレスを提供しないプラットフォームもあるため、その場合はユーザー名にフォールバックします。
- SSO ペイロードに一致するユーザー名とメールアドレスを渡している限り、通知やメンションが機能するように、個々のコメントオブジェクトにそのメールアドレスを追加します。
コメントとユーザーを同時にインポートしたい場合は、API を介してユーザーがインポートされた後に、サポートと連携してコメントをそれぞれのユーザーアカウントに移行してください。
まとめると、移行で最も簡単な手順は次のとおりです：
- Import comments.
- Import UI を
Manage Data -> Importsで使用している場合、アバターやその他のメディアは自動的に移行されます。
- Import UI を
- Setup Secure or Simple SSO.
- Let the migration happen per-user automatically when they log in for the first time.
- 一般的に、ユーザーが 50,000 件未満のコメントしか持っていない場合、ページ読み込み時間に追加される時間は通常 1 秒未満です。
WordPress Users
If you're using our WordPress プラグイン then there is no code to write! Simply go to the plugin's Admin page, click SSO Settings, and then Enable.
This will take you to a single-button click wizard which will create your API key, send it over to your WordPress install and turn SSO on. We've consolidated this into a single button click for you.
Note that if you are installing the plugin for the first time you will have to follow up the setup process before you see the admin page with the SSO Settings button.
WordPress SSO - Moderators
FastComments WordPress plugin でコメントした際にモデレーターの横に "Moderator" バッジを表示するには、該当ユーザーが FastComments ダッシュボードでも Moderator として追加され、メールアドレスが確認済みである必要がある点に注意してください。
カスタム統合
カスタム統合の場合、2 つのオプションがあります。
オプション1 - Secure SSO
With Secure SSO, FastComments knows that the user commenting, voting, and reading comments is a real user on your site.
As long as you create a valid payload, the user will always have a seamless commenting experience.
With Secure SSO, the SSO payload is created server-side using HMAC authentication and then passed to the widget on the client.
With Secure SSO, the user's account is completely separate from the rest of the FastComments user-base. This means if we have two partners Company A and Company B, each can have an SSO user with the username "Bob".
要件
- サーバーサイド開発に関する基本的な知識。
- 秘密の API キーを扱う際の基本的な知識。
- API 開発またはサーバーサイドレンダリングに関する基本的な知識。
利点
- セキュア。
- シームレスなコメント体験。
欠点
- サーバーサイドの開発を要する。
ユーザーデータの更新
Secure SSO では、SSO ユーザーペイロードを渡すたびに、そのユーザーの情報を最新の内容で更新します。例えば、ユーザー名が X の場合に SSO ペイロードで Y を渡すと、ユーザー名は Y になります。
この方法で値を削除したい場合は、それらを null に設定してください（undefined ではありません）。
Secure SSO API
SSO ユーザーと対話するための API も提供しています。詳細は ドキュメント を参照してください。
Note that when using Secure SSO, users are automatically created behind the scenes on page load. You do not have to bulk import your users.
オプション2 - Simple SSO
The alternative to Secure SSO is to simply pass the user information to the commenting widget.
Providing an email with Simple SSO is not required, however without this their comments will show as "Unverified".
注： As of early 2022 usernames with Simple SSO do not need to be unique across all of FastComments.com.
Ideally, Simple SSO should only be picked when developing on a platform that doesn't provide backend access.
要件
- クライアントサイド開発に関する基本的な知識。
- 少なくともユーザーのメールアドレスを把握していること。
利点
- 単純。
- すべてのアクティビティは引き続き検証されます。
- ユーザーが自分のユーザー名やメールアドレスを入力することはありません。
欠点
- クライアント側のペイロードが偽造されて任意のユーザーになり得るため、Secure SSO より安全性は低くなります。
Simple SSO API
Simple SSO フローで自動的に作成されたユーザーは SSOUser オブジェクトとして保存されます。これらは SSOUser API を介してアクセスおよび管理できます。詳細は ドキュメント を参照してください。
カスタム統合 - セキュアなシングルサインオン (SSO)
FastComments Secure SSO は SSO を実装するメカニズムとして HMAC-SHA256 暗号化を使用します。まず全体アーキテクチャを説明し、例と詳細な手順を示します。
類似の SSO メカニズムを持つ他のプロバイダからの移行や相違点に関するドキュメントもあります。
フローは以下のようになります：
Secure SSO はフルスタックの開発を伴うため、Java/Spring、NodeJS/Express、およびバニラ PHP の完全な動作コード例が現在 GitHub にあります。
NodeJS の例では ExpressJS、Java の例では Spring を使用していますが、FastComments SSO を実装するためにこれらの実行環境でフレームワーク/ライブラリは必須ではありません - ネイティブの crypto パッケージで動作します。
FastComments SSO では新しい API エンドポイントを作成する必要はありません。シークレットキーでユーザー情報を暗号化し、そのペイロードをコメントウィジェットに渡すだけです。
Get Your API Secret Key
API シークレットは このページ から取得できます。マイアカウントに移動し、API/SSO タイルをクリックしてから "Get API Secret Key" をクリックしてもこのページにアクセスできます。
Comment Widget Parameters
コメントウィジェットのハイレベルな API ドキュメントは こちら にあります。
これらのパラメータが何を意味するか、詳細を見ていきます。
コメントウィジェットは設定オブジェクトを受け取ります - FastComments を使用している場合、customer 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 の代わりに指定した場合、コメントウィジェットがログアウトボタンをクリックしたときに呼び出す関数。
The User Object
ユーザーオブジェクトは次のスキーマを持ちます：
Moderators and Administrators
For admins and moderators, pass the respective isAdmin or isModerator flags in the SSOUser object.
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）にあります。
統合は複雑で困難な場合があることを理解しています。担当者に連絡するか、サポートページを利用してください。
カスタム統合 - シンプルなシングルサインオン (SSO)
Simple SSO を使うと、コメントウィジェットにユーザー情報を提供できるため、ユーザーはコメント時にユーザー名やメールアドレスを入力する必要がなくなります。
Simple SSO は次のように設定できます：
Run ユーザーはログインした状態になり、裏で SSO ユーザーが作成されます。API から取得された場合、ユーザーの createdFromSimpleSSO は true に設定されます。
Notes:
- メールアドレスは Simple SSO における一意の識別子です。
- Simple SSO でメールアドレスを提供する必要はありませんが、デフォルトではコメントは "Unverified" と表示されます。 メールアドレスが提供されない場合、ユーザーは完全に認証されません。
- NEW 2022年1月以降: fastcomments.com 全体でユーザー名が一意である必要はありません
- メールアドレスが提供され、かつユーザーが元々 Secure SSO から作成されていなかった場合、Simple SSO は SSO ユーザーを自動的に作成および更新できます。
- ユーザーに付与するバッジは
badgeConfigプロパティで指定できます。badgeIds配列にはユーザーに関連付けるグローバルバッジの ID が含まれます。pageBadgeIds配列には現在のページ（urlId）にスコープされたバッジ ID が含まれます — これらのバッジは割り当てられたページでのみ表示されます。overrideがtrueに設定されている場合、既存の表示中のバッジを置き換えます（グローバルとページスコープは独立して上書きされます）；falseの場合は既存のバッジに追加されます。
カスタム統合 - Disqus SSOからの移行
Disqus と FastComments Secure SSO の最大の違いは、Disqus が暗号化に SHA1 を使用しているのに対し、当社は SHA256 を使用している点です。
つまり、Disqus からの移行は簡単です - 使用するハッシュアルゴリズムを SHA1 から SHA256 に変更し、UI に渡されるプロパティ名を更新するだけです。
カスタム統合 - Commento SSOからの移行
Commento は大幅に異なる SSO アプローチを採用しています - ユーザーを認証するために呼び出すエンドポイントを用意する必要があります。
FastComments はその逆で - 単にユーザーの情報をあなたの秘密鍵でエンコードしてハッシュし、それを渡すだけです。
シングルサインオンでコメントスレッドを保護する
FastComments SSO (詳細はこちら) により、ユーザーは別のプラットフォームにログインすることなくコメントを投稿できるようになります。
しかし、これだけではコメントスレッドは保護されません。デフォルトではコメントデータは公開されており、ページを閲覧できる誰でもコメントを閲覧できます。
設定を変更することで、管理者または有効なSSOユーザー以外はコメントを取得できないように制限できます。
No-Code セットアップ
SSO を設定している場合、カスタマイズルールを作成することで、コメントスレッドの閲覧や操作を防ぐことができます。
SSOで検索すると次のオプションが見つかります：
それを有効にして、カスタマイズルールを保存してください。
特定のドメインまたはページのみ保護する
特定のドメインまたはページのみを保護する場合は、カスタマイズルールをそのように設定するだけです。
カスタマイズ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で設定できます：
匿名コメントの期限切れを防ぐ
FastComments は、所定の日数が経過した未確認コメントを削除するように設定できます。これによりスパム対策に役立ちます。
デフォルトでは、行われません。
これは モデレーション設定 ページで設定または無効化できます。
メール入力欄を無効化
ユーザーがコメントを投稿する際、ログインしていない場合はメールアドレスの入力を求められます。
これはそのユーザーの「未検証セッション」を作成し、メールでそのセッションの検証を求めます。
一部のサイトやアプリケーションでは、コメントや投票時にユーザーにメールアドレスを求めたくない場合があります。
匿名コメントを有効にするとメール入力欄は任意になります。ただし、完全に無効化することもできます。まず、匿名コメントを有効にしてください。 その後、メール入力欄を無効にするオプションが表示されます。
これを有効にすると、当社のすべてのコメント製品でメール入力欄はまったく表示されなくなります。
この設定では、ユーザーがアカウントを作成してログインしない限り、すべてのコメントは未検証になります。 https://fastcomments.com
未検証ラベルを無効にすることを検討してください。
未検証ラベルを無効化
デフォルトでは、FastComments は、ユーザーに残されたコメントで、その ブラウザセッションが未検証である場合に「未検証のコメント」ラベルを表示します。未検証のコメントについての詳細はこちらをご覧ください。
Run さらに、この機能はコードを記述せずにカスタマイズ UI で使用できます：
匿名投票を許可する
ユーザーがコメントに投票しようとしたとき、ログインしていない場合は、ユーザー名とメールアドレスの入力を求められます。
この要件を削除して、誰でも情報を残さずにコメントに投票できるようにできます。
デフォルトのユーザー名を設定する
ユーザーがコメントや投票を行う際、ログインしていない場合は、メールアドレスとユーザー名の入力を求められます。
匿名でのコメントの場合、コメント時の摩擦を減らすためにデフォルトのユーザー名を定義することが望ましい場合があります コメントする際の手間を軽減できます。これはカスタマイズUIから行えます。匿名コメントは事前に有効化しておく必要があります。
コールバック
コメントウィジェット用のすべてのライブラリ（現在は Angular、React、Vue）はコールバックをサポートしています。
コールバックは設定オブジェクトで指定し、各ライブラリで同じシグネチャを持ちます。
サポートされているコールバックは以下です：
- onInit
- onAuthenticationChange
- onRender
- commentCountUpdated
- onReplySuccess
- onVoteSuccess
- onImageClicked
- onOpenProfile
- onCommentSubmitStart
- onCommentsRendered
正確なシグネチャはTypeScript 定義で確認できます。
以下はすべてのコールバックを使用した例です：
Run ユーザーのロケールを手動で定義する
既定では、FastCommentsはユーザーのシステムとブラウザによって決定されたロケールでコメントウィジェットを表示します。
ユーザーがコメントしたりログインしたりすると、そのユーザーが最後に使用したロケールを更新し、メール送信にもそのロケールを使用します。
これはコメントウィジェットがユーザー向けにどのように翻訳されるかに影響します。ロケールはユーザーの言語と地域で構成されるため、ロケールを設定すると通常、ユーザーに表示されるテキストの言語が変更されます。
Via The UI
これはウィジェットのカスタマイズUIで定義できます。「Locale / Language」オプションを参照してください：
Via Code
これを任意のロケールで上書きできます。
Run Supported Languages and Locale Codes
サポートされている言語と対応するロケールコードの完全な一覧はここで確認できます。
SSO に関する注意
SSOを使用している場合、ユーザーオブジェクトにユーザーのロケールを渡しておくと、メールなどが正しくローカライズされます。
許可する言語の制限
デフォルトでは、FastCommentsはコメントに使用される言語を制限しません。
コミュニティで使用する言語を制限したい場合があります。
これはコード不要で、ウィジェットのカスタマイズページで設定できます:
システムはコメントを解析してその言語を判定し、許可リストと照合します。
コメントが許可されていない言語で書かれている場合は、ローカライズされたエラーメッセージが表示されます。
ページタイトル
現在のページタイトルは指定された urlId に関連付けられ、モデレーションツールで使用するために保存されます。
デフォルトでは、これは document.title から取得されます。
必要に応じて、独自のページタイトルを次のように指定できます：
Run 新しい返信を禁止し投票を無効化する
readonly フラグを true に設定すると、新しいコメントや投票を受け付けないようにコメント投稿をロックできます。
コメントは編集や削除もできなくなります。
Run これはコード無しで、ウィジェットのカスタマイズページからドメイン全体またはページ単位で設定できます：
更新！
2022年11月現在、スレッドは管理者およびモデレーターが返信欄上部の三点メニューからリアルタイムでロックまたはアンロックできます。
これにより新しいコメントは防止されますが、投票は引き続き可能で、ユーザーが自分のコメントを削除することもできます。一方、readonly ではこれらは許可されません。
これは Page API の isClosed フィールドに対応します。
リンクのドメイン制限
デフォルトでは、FastCommentsは任意の外部サイトへのリンクを許可します。
これは、代わりに指定したサイトやドメインのリストに制限できます。サイト、またはドメインにリンクを投稿しようとすると、 定義されたリストに含まれていない場合は、ユーザーにエラーが表示されます。
この検証はコメントウィジェットとAPIにのみ適用されます。インポートは影響を受けません。
これはコードを書くことなく、ウィジェットのカスタマイズページで行います：
コメント数とネストされた返信の全件カウント
コメントウィジェットの上部に表示されるコメント数は、すべての「トップレベル」コメントを表示することもできます。すなわちページや記事自体に直接返信された返信を表示することも、 またはすべてのネストされたコメントの総数を表示することもできます。
By default, this is true - it is a count of the latter - all comments. コメントウィジェットの古いバージョンでは、
デフォルト値は false です。
We can change the behavior, so that it is a count of all nested comments by setting the countAll flag to true.
Run If we wanted the count to reflect only the top level comments, we set the flag to false.
Run This currently cannot be customized without code changes.
コメント投稿者のリンクを有効化
デフォルトでは、FastComments はユーザーに対してコメント、ユーザー名、メールアドレスのみを求めます。
しかし、場合によってはユーザーに自分のブログやウェブサイトへのリンクを残してもらいたいことがあります。
ユーザーのウェブサイトURLを入力するための追加入力フィールドを表示するには、enableCommenterLinks フラグを true に設定します:
Run そのURLが提供されると、ユーザーのアカウントが更新され、過去および将来のすべてのコメントに表示されるユーザー名がこのURLにリンクされます。
これはコードなしで、ウィジェットのカスタマイズページで設定できます:
モデレーショングループ
このリストはModeration Groupsページで生成されたIDの一覧です。
指定すると、その構成を使用して投稿されたコメントには同じセットの moderationGroupIds が含まれます。
もし Moderator が1つ以上の Moderation Groups を定義している場合、
自分のグループに関連する Moderate Comments ページのコメントのみを見ることができます。
Run グループIDのメンション
オートコンプリートの**@mentions**で使用するIDの一覧。ユーザー同士のグループが交差していない場合にタグ付けされないようにしたいときに便利です。
指定すると、@文字を入力したときに、他のグループに属するユーザーのみがオートコンプリートに表示されます。
Run サードパーティCookieの回避
認証のために、FastCommentsはブラウザでサードパーティのクッキーが有効になっていることに依存します。これが無効だと、ユーザーは常にコメントする際に メールアドレスを入力する必要があり（メール入力欄が非表示の場合を除く）、コメントは常に未検証として表示されます（デフォルト設定）。
これを回避するには、サードパーティ・クッキーバイパスを有効にできます。
この設定を有効にすると、ユーザーがログインされていることを示すメッセージを表示する小さなポップアップが表示されます。 このポップアップ はユーザーがコメントウィジェットとやり取りするたびに表示されます。例えば、コメントを投稿したときなどです。
コードでは、enableThirdPartyCookieBypass フラグを true に設定することでこれを行えます:
Run また、ウィジェットカスタマイズのUIで Enable Third-Party Cookie Popup の項目から設定することもできます:
返信のあるコメントの削除
デフォルトでは、ユーザーは自分のコメントを削除できます。 また、コメントを削除すると自動的に スレッド内のすべての子コメントおよび一時的なコメントも削除されます。この動作はライブ環境でも同様に適用されます。
これを以下の方法で制限できます：
- 代わりに、削除されたコメントを匿名化する（名前とテキストを
[deleted]またはカスタム値に設定する）。 - 返信がある場合にコメントの削除を許可しない。カスタマイズ可能なエラーメッセージが表示されます。
- コメントに返信がある場合の削除を管理者とモデレーターのみに制限する。
これはウィジェットカスタマイズUIの Comment Thread Deletion セクションで設定できます。
トップバーにバッジを表示する
デフォルトでは、FastComments はユーザーのバッジをコメントスレッド内のコメントにのみ表示します。
ただし、ウィジェットのカスタマイズページでこの機能を有効にすると、コメントフォームの上にある名前の隣にユーザーのバッジを表示できます:
これにより、ユーザーがコメントを作成しているときに、トップバー領域で名前の横にバッジが表示され、実績やステータスがより目立つようになります。
この機能が動作するには、ウィジェットのカスタマイズUIで有効にする必要がある点に注意してください。サーバー側で有効になっている場合でも、コード構成で showBadgesInTopBar フラグを false に設定して、個別に無効化することもできます:
Run オンラインユーザーリストを表示する
デフォルトでは、FastComments はページ上にユーザーの一覧を表示しません。
コメントウィジェットの横に、現在ページを閲覧しているユーザーの一覧を表示できます。リストはユーザーの入退出に合わせてライブで更新され、名前、アバター、オンラインインジケーターを表示します。
レイアウトは3種類あります:
1- 上部: コメントの上に表示される、重なり合うアバターの横並び。2- 左: ウィジェットの左側に表示される、名前とオンラインドット付きのサイドバー。3- 右: 同じサイドバーがウィジェットの右側に表示されます。
この機能を有効にするには、usersListLocation フラグを設定します:
Run デフォルトではリストは現在オンラインのユーザーのみを表示します。過去にページにコメントした（現在閲覧していない）人も含めるには、usersListIncludeOffline を true に設定してください:
Run 過去のコメント投稿者は緑のオンラインドットなしで表示され、誰が現在いるかがわかるようになっています。
プロフィール非公開のユーザーは、匿名アバターと「非公開プロフィール」ラベルで表示され、個人を明らかにせずにカウントが正確に保たれます。
この設定はコードなしでも行えます。ウィジェットのカスタマイズページで「ユーザーリストの表示位置」オプションを確認してください。表示位置が Off（オフ）以外に設定されていると、その下に「過去のコメント投稿者を含める」チェックボックスが表示されます。
ライブユーザーが500人を超える場合、リストは最大30秒遅れることがあります。