FastComments.com
Menu Icon

言語 🇯🇵 日本語
🇺🇸 English 🇧🇬 Български 🇨🇳 简体中文 🇹🇼 繁體中文 🇭🇷 Hrvatski 🇩🇰 Dansk 🇳🇱 Nederlands 🇺🇸 English (US) 🇨🇦 Français (Canada) 🇫🇷 Français (France) 🇩🇪 Deutsch 🇨🇾 Ελληνικά (Κύπρος) 🇬🇷 Ελληνικά 🇮🇱 עברית 🇮🇹 Italiano 🇯🇵 日本語 🇰🇷 한국어 🇵🇱 Polski 🇧🇷 Português (Brasil) 🇷🇺 Русский 🇺🇦 Русский (Украина) 🇧🇦 Српски (БиХ) 🇷🇸 Srpski (Latinica) 🇲🇪 Српски (Црна Гора) 🇷🇸 Српски 🇸🇮 Slovenščina 🇪🇸 Español 🇺🇦 Українська 🇹🇷 Türkçe

要点

クイックスタート

Drupal のインストール

インストール
設定
ウィジェットブロック
コンテンツタイプのフィールド
シングルサインオン (SSO)
権限
多言語対応
EU内データ保管
カスタマイズ
要件

Add Live Commenting to Drupal Sites

クイックスタート Internal Link

これは Drupal の説明の「要点のみ（TL;DR）」版です。

  1. モジュールを composer require drupal/fcom でインストールするか、modules/custom/fastcomments/ に配置します。
  2. drush en fastcomments で有効化するか、管理 UI の /admin/modules から有効化します。
  3. Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments) に移動します。
  4. Settings > API/SSO（EU）から Tenant ID と API Secret を入力します。
  5. Structure > Content types > [type] > Manage fields 経由で任意のコンテンツタイプに FastComments フィールドを追加します。

モジュールは drupal.org/project/fcom に公開されています。

インストール Internal Link

The FastComments Drupal モジュールは、Drupal の組み込みコメントを高速でリアルタイムなコメントシステムに置き換えます。モジュールは drupal.org に公開されています と Drupal 10 および 11 に対応しています。

There are two ways to install it.

Install with Composer

composer require drupal/fcom
drush en fastcomments

Install manually

Download the module from drupal.org/project/fcom and place it in your site's modules/custom/fastcomments/ directory. Then enable it with drush en fastcomments, or from the admin UI at Extend (/admin/modules).

注： このモジュールは Drupal コア（user および field）のみを依存関係としています。他の Drupal モジュールやライブラリは必要ありません。

Once the module is enabled, head to the Configuration section to set up your Tenant ID and API Secret.

設定 Internal Link

すべての設定は Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments) にあります。

必須

  • Tenant ID - あなたの FastComments Tenant ID。次の場所で確認できます: Settings > API/SSO (EU).
  • API Secret - Secure SSO、webhook の検証、およびページ同期に必要です。次の場所で見つかります: Settings > API/SSO (EU).

コメントスタイル

サイト上でユーザーにどのように交流してほしいかに合わせてウィジェットを選択してください。

  • Live Comments - リアルタイムのスレッド形式コメント。
  • Streaming Chat - ライブチャットインターフェース。イベントやライブ配信に適しています。
  • Collab Chat - メインコンテンツ領域でのテキスト選択注釈。訪問者がテキストをハイライトして、その文脈で議論を開始できます。
  • Collab Chat + Comments - 同じページで collab chat と標準のコメントの両方を表示します。

SSO モード

  • None - SSO を使用しません。ユーザーはゲストとしてコメントするか、FastComments アカウントを作成します。
  • Simple - Drupal のユーザー情報 (name, email, avatar) をサーバー側で検証せずに FastComments に渡します。
  • Secure - HMAC-SHA256 を使用して Drupal ユーザーを FastComments と照合します。API Secret を設定している場合に推奨されます。

詳細は Single Sign-On (SSO) セクションを参照してください。

その他の設定

  • CDN URL - デフォルトは https://cdn.fastcomments.com です。
  • Site URL - デフォルトは https://fastcomments.com です。
  • Email notifications - コンテンツに新しいコメントが投稿されたとき、コンテンツの作成者にメールを送信します。

EU のデータ居住については、EU Data Residency セクションを参照してください。

ウィジェットブロック Internal Link

モジュールには、Structure > Block layout (/admin/structure/block) から配置できるいくつかのブロックが同梱されています。

  • FastComments Widget - メインのコメントウィジェット。現在のエンティティを自動検出します。すでに FastComments フィールドが追加されているエンティティはスキップするため、同じページに重複したウィジェットが表示されることはありません。
  • FastComments Live Chat - リアルタイムストリーミングチャット。コメントフィールドと同じページに並べて配置できます。
  • FastComments Collab Chat - テキスト選択による注釈とディスカッション。
  • FastComments Image Chat - 画像上の座標ベースの注釈。訪問者は画像をクリックして特定の位置に紐づいたコメントを残します。
  • FastComments Recent Comments - サイト全体の最近のコメントを表示します。表示件数はブロックで設定可能です。
  • FastComments Top Pages - コメント数が多いページを表示します。

コンテンツ中心のブロック（Live Chat、Collab Chat、Image Chat）は現在のエンティティを自動検出し、エンティティでないページではパスベースの識別子にフォールバックします。つまり、追加の設定なしにタクソノミーページ、ビュー、カスタムルートで動作します。

コンテンツタイプのフィールド Internal Link

多くのサイトでは、コメントを追加する最も簡単な方法はコンテンツタイプにFastCommentsフィールドを追加することです。Structure > Content types > [type] > Manage fieldsに移動してフィールドを追加してください。

各エンティティがそのフィールドを持つと、次のものが利用できます:

  • ステータス切替：編集者がエンティティごとにコメントをオン/オフにできるようにします。
  • カスタム識別子（任意）：Drupalのエンティティパスに紐づかない安定したIDを使用できるようにします。

メインのFastComments Widgetブロックはこのフィールドを認識しており、すでにフィールドが付与されているエンティティはスキップします。これにより、エンティティごとのコメントとブロックを組み合わせても、同じページにウィジェットが二重に表示されることはありません。

シングルサインオン (SSO) Internal Link

FastComments は SSO（シングルサインオン）を通じて Drupal のユーザーシステムと統合します。ユーザーはあなたの Drupal サイトにサインインし、モジュールがその身元を自動的に FastComments に渡します。追加のアカウントを作成する必要も、初期同期を実行する必要もありません。

モジュールは 3 つの SSO モードをサポートしており、Administration > Configuration > Content > FastComments で設定します。

なし

SSO なし。ユーザーはゲストとしてコメントするか、FastComments アカウントを作成します。サイトが公開されていてコメントを Drupal ユーザーに紐付ける必要がない場合はこれを使用してください。

シンプル

サーバー側の検証なしに、Drupal ユーザーの名前、メール、およびアバターを FastComments に渡します。API Secret は不要です。内部用またはリスクの低いサイトに適しています。

セキュア（推奨）

HMAC-SHA256 を使用して各ユーザーの身元を FastComments 側で検証します。API Secret を設定している場合に使用すべきモードであり、訪問者が他のユーザーになりすますのを防げる唯一のモードです。

ユーザーの身元はユーザーがコメントスレッドを表示するたびに FastComments に渡されます。実行する必要のある初期同期や継続的な同期はありません。

(任意) 管理者を Users & Administrators に、モデレーターを Comment Moderators に追加すると、操作性が向上しモデレーターの統計トラッキングが有効になります。

SSO の仕組みを詳しく知りたい場合は、カスタマイズドキュメントの SSO セクション を参照してください。

権限 Internal Link

このモジュールは、People > Permissions の下でロールごとに割り当てできる3つのDrupal権限を追加します。

  • Administer FastComments - /admin/config/content/fastcomments にある FastComments 設定フォームへのアクセス。
  • View FastComments - コメントウィジェットを表示するために必要です。この権限がないとウィジェットは表示されません。
  • Toggle FastComments - フィールドウィジェットを使用して、エンティティごとにコメントを有効または無効にできるようにします。

デフォルトでは、administer site configuration 権限を持つユーザーのみが FastComments の設定を変更できます。訪問者にウィジェットを表示したい場合は、匿名および認証済みユーザーに View FastComments を付与してください。

多言語対応 Internal Link

このモジュールは現在の Drupal サイトの言語を各 FastComments ウィジェットに自動的に渡します。もし Drupal サイトが複数言語に設定されている場合、コメント用 UI は追加の設定なしに対応する言語で表示されます。

これはすべてのウィジェットタイプに適用されます: Live Comments, Streaming Chat, Collab Chat, Image Chat, Recent Comments, and Top Pages.

EU内データ保管 Internal Link

FastComments アカウントが EU にホストされている場合は、Administration > Configuration > Content > FastComments で 2 つの設定を更新してください：

  • CDN URL - https://cdn-eu.fastcomments.com
  • Site URL - https://eu.fastcomments.com

また、Tenant ID と API Secret はデフォルトの米国ダッシュボードではなく、EU のダッシュボード eu.fastcomments.com/auth/my-account/api から取得してください。モジュールのその他の部分は同じように動作します。

カスタマイズ Internal Link

FastComments はあなたのサイトに合わせてカスタマイズできるよう設計されています。

カスタムスタイリングを追加したり、設定を調整したい場合は、カスタマイズのドキュメント をご覧ください。

要件 Internal Link

  • Drupal 10 または 11
  • PHP 8.1 以降
  • FastComments のアカウント

このモジュールはその他の Drupal モジュールやサードパーティのライブラリを必要としません。依存しているのは Drupal コア（user, field）のみです。

A <noscript> フォールバックは、JavaScript を使用していない訪問者向けにサーバー側でレンダリングされたコメントを提供するため、スクリプトが無効なブラウザでも Live Comments と Streaming Chat は引き続き動作します。

このガイドに貢献する