
言語 🇯🇵 日本語
サードパーティ製プラグイン
カスタムインストール
ドキュメントへの埋め込み
Add Comments To a Website
インストール
FastCommentsは、静的ページでも動的ページでも、ライトテーマでもダークテーマでも、公開ページでも内部ページでも、あらゆる種類のページにインストールできるように設計されています。どのようなサイトやウェブベースのアプリケーションにも簡単にインストールして適応できるようになっています。
WordPress 
WordPressプラグインはこちらで見つけることができます。
完全なインストールガイドとプラグインに関するドキュメントはこちらにあります。
このプラグインは、ライブコメント、SSO、コードなしのインストールをサポートしています。プラグインをインストールした後、 管理ページのインストールガイドに従ってください。WordPressのインストールをアカウントに接続する手順が案内されます。
FastCommentsのWordPressプラグインを通じて残されたコメントは、自動的にWordPressの インストールに同期され、データの管理を維持できます。これはWordPressデータベースのサイズを制限するために無効にすることができます。
Vanilla JS / 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" Message
これは、ホームページからウィジェットコードをコピーした場合に表示されます。ホームページではデモ用の テナントが使用されています。ご自身のテナントを使用するには、こちらからウィジェットコードをコピーしてください。
"FastComments cannot load on this domain" Error
FastComments は、アカウントに関連するリクエストを認証するために、どのドメインがあなたの所有であるかを知る必要があります。 このエラーを解決する方法についてはドキュメントを確認してください(アカウントに正確なサブドメイン+ドメインを追加するだけです)。
このエラーは試用期間が終了した後にのみ発生する点に注意してください。試用期間中は、新しいドメインからのリクエストは 自動的にあなたのアカウントに追加されます。
Migrated Comments Not Showing for Custom Installations
通常、インポートされたコメントが Page ID に紐付けられており、ウィジェットに URL を渡している(または値を渡していない場合はページの URL がデフォルトで使用されます)ときにこの問題が発生します。
これをデバッグするには、コメントをエクスポートする と URL ID 列(現在は列 B)を確認してください。
URL ID 列で表示される値が、ウィジェット設定で urlId パラメータとして渡している値と同じであることを確認してください。
詳細については、コメントがページや記事にどのように紐付けられるかのドキュメント をお読みください。
それでも解決しない場合は、お問い合わせください。
Comment Widget Not Showing
コメントウィジェットが表示されない場合は、Chrome の開発者コンソールでエラーを確認してください。
ほとんどの設定ミスでは、ウィジェットが読み込める場合はページ上に少なくともエラーを表示します。何も表示されない場合は通常スクリプトエラーの兆候です。
Desired Configuration Not Working as Expected
ウィジェットに渡されている設定を確認するには、Chrome 拡張機能 をお試しください。すべて失敗した場合は、拡張機能の表示をスクリーンショットに撮って お問い合わせください。
Comments Missing on Same URL With Different Hash Bang
デフォルトでは、FastComments はコメントが保存される「バケット」としてページの URL を使用します。URL に #hashbangs が含まれており、これらの #hashbangs
がコメントスレッドを識別する識別子の一部であってはならない場合、ハッシュバングの値を単純に無視することができます。例えば:

この変更を行った後、既存のコメントに対してはマイグレーションを実行する必要がある点に注意してください。その件についてはお問い合わせください。
URL Query Parameters Affecting Widget
デフォルトでは、FastComments はコメントが保存される「バケット」としてページの URL を使用します。URL にスレッドを識別する識別子の一部に含めたくないクエリパラメータが含まれている場合、それらを単純に無視することができます。例えば:

この変更を行った後、既存のコメントに対してはマイグレーションを実行する必要がある点に注意してください。その件についてはお問い合わせください。
Not Receiving Emails
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として使用します。
- 完了!