
言語 🇯🇵 日本語
サードパーティ製プラグイン
カスタムインストール
ドキュメントへの埋め込み
インストール
FastCommentsは、静的ページでも動的ページでも、ライトテーマでもダークテーマでも、公開ページでも内部ページでも、あらゆる種類のページにインストールできるように設計されています。どのようなサイトやウェブベースのアプリケーションにも簡単にインストールして適応できるようになっています。
WordPress 
WordPressプラグインはこちらで見つけることができます。
完全なインストールガイドとプラグインに関するドキュメントはこちらにあります。
このプラグインは、ライブコメント、SSO、コードなしのインストールをサポートしています。プラグインをインストールした後、 管理ページのインストールガイドに従ってください。WordPressのインストールをアカウントに接続する手順が案内されます。
FastCommentsのWordPressプラグインを通じて残されたコメントは、自動的にWordPressの インストールに同期され、データの管理を維持できます。これはWordPressデータベースのサイズを制限するために無効にすることができます。
VanillaJS / HTML スニペット 
VanillaJS版のウィジェットは非常に簡単にインストールでき、ビルドシステムやサーバーサイドコードは必要ありません。
任意のページに以下のコードスニペットを追加するだけです:
Run 
同じコードスニペットを多くのページで使用できます。ページごとに自動的に別のスレッドが作成されます。
多くのアプリケーションには「HTMLエンベッドコード」オプションがあります。それを選択して、上記のコードスニペットを貼り付けてください。
試すのにアカウントは必要ありません! ログインしていない場合、上記のスニペットに「tenantId: demo」と表示されることがあります。この場合、 デモアカウントが使用されます。
ウィジェットの設定に関するドキュメントはこちらで見つけることができます。
FastCommentsウィジェットのすべてのバージョンは、コアVanillaJSライブラリのラッパーです。これにより、一箇所で機能を追加し 問題を修正でき、変更は自動的にコメントウィジェットの他のバリアントに反映されます。
Angular 
AngularライブラリはNPMのこちらで見つけることができます。
FastComments Angularコメントウィジェットは、VanillaJS版と同じすべての機能(ライブコメント、SSO など)をサポートしています。
ピア依存関係であるfastcomments-typescriptが必要です。TypeScriptコンパイルに含まれていることを確認してください。 将来的には、このピア依存関係は@types/fastcommentsに移動され、インストールが簡素化されます。

ピア依存関係はtsconfig.jsonファイルに追加する必要があります。例:

次に、アプリケーションにFastCommentsModuleを追加します:

使用方法
開始するには、デモテナント用の設定オブジェクトを渡します:

設定はかなり複雑になる可能性があるため、オブジェクト参照を渡すことができます:


ウィジェットは変更検出を使用するため、設定オブジェクトのプロパティを変更するとリロードされます。
Angularコンポーネントがサポートする設定はこちらで見つけることができます。
React 
ReactライブラリはNPMのこちらで見つけることができます。
FastComments Reactコメントウィジェットは、VanillaJS版と同じすべての機能(ライブコメント、SSO など)をサポートしています。



EUにいる場合は、次のようにregionパラメータを設定する必要があります:

Reactコンポーネントがサポートする設定はこちらで見つけることができます。
React Native 
React NativeライブラリはNPMのこちらで見つけることができます。
FastComments React Nativeコメントウィジェットは、VanillaJS版と同じすべての機能(ライブコメント、SSO など)をサポートしています。


設定はfastcomments-reactライブラリとは少し異なる方法で指定されます:

EUにいる場合は、regionパラメータを設定する必要があります:

React Nativeコンポーネントがサポートする設定はこちらで見つけることができます。
Vue 
VueライブラリはNPMのこちらで見つけることができます。
また、vue-nextライブラリはNPMのこちらにあります
ソースコードはGitHubで見つけることができます。
FastComments Vueコメントウィジェットは、VanillaJS版と同じすべての機能(ライブコメント、SSO など)をサポートしています。
以下の手順はVue 3向けです(リリースから時間が経っているため)。ただし、FastCommentsはfastcomments-vueライブラリを通じてVue 2もサポートしています。



EUにいる場合は、regionをEUに設定する必要があります:

fastcomments-vueとfastcomments-vue-nextライブラリは、VanillaJSコメントウィジェットと同じ設定をサポートしています。
Vueコンポーネントがサポートする設定はこちらで見つけることができます。
同一ページ上での複数インスタンス 
コメントウィジェットの各インスタンスは分離されています。このため、FastCommentsは本質的に1ページに複数のインスタンス、または同じチャットスレッドを指す複数のインスタンスをサポートしています。
例えばVanillaJSライブラリの場合、コメントウィジェットを異なるDOMノードに関連付けるだけです。ページ上の現在のスレッドを単に更新したい場合は、ページをリロードせずにコメントスレッドを切り替えるをご覧ください。
複数のインスタンス間で認証状態を同期する
それぞれのコメントスレッドを持つよくある質問のリストであるカスタムシングルページアプリケーションの例を見てみましょう。
この場合、DOM内に同時に複数のFastCommentsインスタンスがあります。
これは問題ありませんが、ユーザーエクスペリエンスにいくつかの課題をもたらします。
このフローを考えてみましょう:
- ユーザーが質問のリストがあるページを訪問し、それぞれに独自のコメントウィジェットがあります。
- ユーザーがユーザー名とメールを入力し、スレッドの1つに質問を残します。
- 質問のある別のFAQ項目を見つけます。
- 再度コメントしようとします。メールとユーザー名を再度入力する必要がありますか?
この場合、FastCommentsがウィジェットインスタンス間の認証状態の同期を処理します。ステップ4では、同じページでユーザー名とメールを入力したため、ユーザーはすでに一時的に認証されています。
一般的なユースケース 
ライブコメントをすぐに表示する
コメントウィジェットはデフォルトでライブですが、ライブコメントは「N件の新しいコメントを表示」ボタンの下に表示され、ページコンテンツが移動するのを防ぎます。
場合によっては、ボタンをクリックせずに新しいコメントをすぐに表示することが望ましいことがあります。
この場合、showLiveRightAwayフラグを有効にする必要があります。ドキュメントはこちらで見つけることができます。
匿名コメントを許可する(メールを必須としない)
デフォルトでは、FastCommentsはコメント時にユーザーがメールを残すことを要求します。
これは無効にできます。手順はこちら。
カスタムスタイリング
多くのお客様がコメントウィジェットに独自のスタイリングを適用しています。ドキュメントはこちらで見つけることができます。
複数のドメインで同じコメントを表示する
複数のサイトで同じコメントを表示することは、FastCommentsがすぐにサポートしている機能です。この件についてのドキュメントをご覧ください。
現在のページを変更する
FastCommentsはSPAや複雑なアプリケーションをサポートしています。現在のページの変更は簡単で、こちらで説明されています。
よくある問題のデバッグ 
よく見られる症状と一般的な解決策を以下に示します。
「This is a demo」メッセージ
これは、デモテナントを使用している私たちのホームページからウィジェットコードをコピーした場合に表示されます。あなたのテナントを使用するには、こちらからウィジェットコードをコピーしてください。
「FastComments cannot load on this domain」エラー
FastCommentsは、アカウントに関連するリクエストを認証するために、どのドメインがあなたのものかを知る必要があります。このエラーを解決する方法については、ドキュメントをご覧ください(単にアカウントに正確なサブドメイン+ドメインを追加するだけです)。
これはトライアル期間が終了した後にのみ発生するはずです。トライアル期間中、新しいドメインからのリクエストは自動的にアカウントに追加されます。
カスタムインストールで移行したコメントが表示されない
通常、これはインポートされたコメントがPage IDに関連付けられており、URLを渡している場合(または値を渡さない場合、デフォルトでページURLが使用される)に発生します。
これをデバッグするには、コメントをエクスポートしてURL ID列(現在は列B)を確認します。
URL ID列に表示される値が、ウィジェット設定にurlIdパラメータとして渡している値と同じであることを確認してください。
詳細については、コメントがページや記事にどのように関連付けられるかのドキュメントをお読みください。
すべてがうまくいかない場合は、お問い合わせください。
コメントウィジェットが表示されない
コメントウィジェットが表示されない場合は、Chromeデベロッパーコンソールでエラーを確認してください。
ほとんどの設定ミスでは、コメントウィジェットは読み込みができる場合、少なくともページにエラーを表示します。何も表示されない場合は、通常スクリプトエラーの兆候です。
希望する設定が期待通りに動作しない
コメントウィジェットにどの設定が渡されているかを確認するには、Chrome拡張機能をお試しください。すべてがうまくいかない場合は、Chrome拡張機能が表示する内容のスクリーンショットを撮ってお問い合わせください。
異なるハッシュバングを持つ同じURLでコメントが見つからない
デフォルトでは、FastCommentsはコメントが保存される「バケット」としてページURLを使用します。URLに#hashbangsが含まれており、これらの#hashbangsがコメントスレッドを識別する識別子の一部であるべきでない場合、ハッシュバング値を単に無視できます。例:

この変更を行った後、既存のコメントの移行が必要になります。それについてはお問い合わせください。
URLクエリパラメータがウィジェットに影響を与える
デフォルトでは、FastCommentsはコメントが保存される「バケット」としてページURLを使用します。URLにコメントスレッドを識別する識別子の一部であるべきでないクエリパラメータが含まれている場合、それらを単に無視できます。例:

この変更を行った後、既存のコメントの移行が必要になります。それについてはお問い合わせください。
メールを受信できない
FastCommentsでは、メールの配信をできるだけ信頼性の高いものにするために多くの努力を払っています。しかし、一部のメールプロバイダーは信頼性の高い配信が非常に困難なことで知られています。fastcomments.comからのメッセージがないか、スパムフォルダーを確認してください。
お問い合わせいただければ、なぜ私たちからのメールが届かないのかについて、より多くの情報を提供できることがあります。
NotionとGoogle Sites 
Notionページにコメントを追加したいですか?お任せください。
Notion
Notionドキュメントへのコメント追加については、こちらの説明動画をご覧ください。
Google Sites
Google Sitesもサポートされており、フローは似ています。
- 埋め込み用の会話を作成します。
- Google Siteを編集中に、
挿入->埋め込みに移動します。URLでを選択します。 - ステップ1のURLを貼り付けます。
挿入を押します。完了!
Nimbus Note
Nimbus Noteへのライブコメントの追加もサポートされており、フローはNotionと似ています。
- 埋め込み用の会話を作成します。
- ノートを編集中に、埋め込みブロックを追加します。
- ステップ1のURLを埋め込みURLとして使用します。
- 完了!