FastComments.com
Menu Icon

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

要約

クイックスタート

Drupal インストール

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

投票

Drupal サイトに投票を追加

Drupal サイトにライブコメントを追加

クイックスタート 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

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

インストール方法は2つあります。

Composerでインストール

composer require drupal/fcom
drush en fastcomments

手動でインストール

drupal.org/project/fcomからモジュールをダウンロードし、サイトのmodules/custom/fastcomments/ディレクトリに配置します。その後、drush en fastcommentsで有効化するか、管理UIのExtend(/admin/modules)から有効化してください。

注意！ このモジュールはDrupalコア(userとfield)にのみ依存しています。他のDrupalモジュールやライブラリは必要ありません。

モジュールを有効化したら、Configurationセクションに移動してTenant IDとAPI Secretを設定してください。

設定 Internal Link

All settings live under Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).

必要

  • Tenant ID - あなたの FastComments テナント IDです。これを Settings > API/SSO（EU）で確認できます。
  • API Secret - Secure SSO、Webhook 検証、ページ同期に必要です。これを Settings > API/SSO（EU）で確認できます。

API シークレットの保存

モジュールは、以下のソースのうち最初に値が設定されているものから API シークレットを読み取ります。

  1. Key モジュール - Key をインストールし、Authentication キーを作成して、設定フォームの API Secret key で選択します。キーは環境変数またはウェブルート外のファイルでバックアップできます。
  2. settings.php - $config['fastcomments.settings']['api_secret'] = 'your-secret'; を settings.php または settings.local.php に追加します。シークレットはエクスポートされた設定に含まれません。
  3. 設定フォーム - API Secret フィールドに入力します。これにより値は fastcomments.settings に保存され、設定エクスポートに含まれます。Drupal のステータスレポートは、これがアクティブなソースであることを警告します。

フォームはどのソースがアクティブかを表示します。フィールドを空白のままにすると、保存されたシークレットが保持されます。シークレットを Key モジュールまたは settings.php に移動した後、Remove the API Secret stored in configuration にチェックを入れて削除してください。

コメントスタイル

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

  • Live Comments - リアルタイムのスレッドコメント。
  • Streaming Chat - ライブチャットインターフェースで、イベントやライブストリームに最適です。
  • Collab Chat - メインコンテンツ領域でテキスト選択に基づく注釈。訪問者はテキストをハイライトし、コンテキスト内でディスカッションを開始します。
  • Collab Chat + Comments - 同じページ上でコラボチャットと標準コメントの両方を利用できます。

SSO モード

  • None - SSO なし。ユーザーはゲストとしてコメントするか、FastComments アカウントを作成します。
  • Simple - サーバー側の検証なしで、Drupal のユーザー情報（名前、メール、アバター）を FastComments に渡します。
  • Secure - HMAC-SHA256 を使用して Drupal ユーザーを FastComments と照合します。API シークレットが設定されている場合に推奨されます。

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 は引き続き動作します。

Drupal サイトに投票を追加 Internal Link

FastComments が Drupal サイトに導入されると、コメント内でライブ投票を実行できます。ウィジェットのカスタマイズ設定で Enable Polls をオンにすると、コメントツールバーに投票ボタンが表示されます。投票は 2 から 10 のオプションを取り、結果はページ上の全員にリアルタイムで更新され、投票を作成できるユーザーや投票にログインが必要かどうかを選択できます。Drupal に追加でインストールするものは何もありません。

Try the Live Polls demo または Polls documentation を読んで設定してください。

このガイドに貢献する