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

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

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

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

構成が複雑になることがあるため、オブジェクト参照を渡すこともできます:


ウィジェットは変更検出を使用するため、構成オブジェクトの任意のプロパティを変更するとウィジェットが再読み込みされます。
Angularコンポーネントがサポートする構成は こちら で確認できます。
React 
Reactで構築されたサイトにコメントを追加するには、NPMで当社のReactライブラリを こちら で見つけることができます。
FastComments の React コメントウィジェットは、VanillaJS のものと同じすべての機能(ライブコメント、SSO など)をサポートします。



EUにいる場合は、region パラメータを次のように設定してください:

Reactコンポーネントがサポートする設定は こちら で確認できます。
React Native 
React Native アプリにコメントを追加するには、NPM 上の当社の React Native ライブラリをこちらで確認できます。
FastComments の React Native コメントウィジェットは、VanillaJS のウィジェットと同様の機能(ライブコメント、sso など)をすべてサポートします。


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

EU にいる場合は、region パラメータを設定してください:

React Native コンポーネントがサポートする設定は こちらで確認できます。
Vue 
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 が標準でサポートしています。この件に関するドキュメントをご覧ください。
現在のページを変更する
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 ページ、Google Sites、または Nimbus Note にコメントを追加したいですか?対応しています。
Notion
Notion ドキュメントにコメント機能を追加するには、こちらの解説ビデオをご覧ください。
Google Sites
Google Sites もサポートされており、手順は似ています。
- 埋め込み用の会話を作成してください。
- Google サイトを編集しているときに、
Insert->Embedに移動します。By URLを選択します。 - ステップ1 の URL を貼り付けます。
Insertをクリックします。完了です!
Nimbus Note
Nimbus Note へのライブコメント追加もサポートしており、手順は Notion と似ています。
- 埋め込み用の会話を作成してください。
- ノートを編集しているときに、埋め込みブロックを追加します。
- ステップ1 の URL を埋め込む URL として使います。
- 完了です!