FastComments.com
Menu Icon

Sprache 🇩🇪 Deutsch
🇺🇸 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

Kurzfassung

Schnellstart

Drupal-Installation

Installation
Konfiguration
Widget-Blöcke
Felder des Inhaltstyps
Einmalanmeldung (SSO)
Berechtigungen
Mehrsprachig
EU-Datenresidenz
Anpassung
Anforderungen

Add Live Commenting to Drupal Sites

Schnellstart Internal Link

Dies ist die "zu lang; nicht gelesen"-Version der Drupal-Anleitung.

  1. Installieren Sie das Modul mit composer require drupal/fcom, oder legen Sie es in modules/custom/fastcomments/ ab.
  2. Aktivieren Sie es mit drush en fastcomments, oder über die Admin-Oberfläche unter /admin/modules.
  3. Gehen Sie zu Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).
  4. Geben Sie Ihre Tenant-ID und Ihr API-Secret aus Einstellungen > API/SSO ein (EU).
  5. Fügen Sie das Feld FastComments zu einem beliebigen Inhaltstyp über Structure > Content types > [type] > Manage fields hinzu.

Das Modul ist auf drupal.org/project/fcom veröffentlicht.

Installation Internal Link

Das FastComments-Drupal-Modul ersetzt die eingebauten Kommentare von Drupal durch ein schnelles, Echtzeit-Kommentarsystem. Das Modul ist auf drupal.org veröffentlicht und funktioniert mit Drupal 10 und 11.

Es gibt zwei Möglichkeiten, es zu installieren.

Installation mit Composer

composer require drupal/fcom
drush en fastcomments

Manuelle Installation

Laden Sie das Modul von drupal.org/project/fcom herunter und legen Sie es im Verzeichnis Ihrer Website modules/custom/fastcomments/ ab. Aktivieren Sie es dann mit drush en fastcomments, oder über die Administrationsoberfläche unter Extend (/admin/modules).

Hinweis! Das Modul hängt nur vom Drupal-Core (user und field) ab. Es sind keine weiteren Drupal-Module oder Bibliotheken erforderlich.

Sobald das Modul aktiviert ist, gehen Sie zum Abschnitt Configuration, um Ihre Tenant ID und Ihr API Secret einzurichten.

Konfiguration Internal Link

Alle Einstellungen befinden sich unter Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).

Erforderlich

  • Tenant ID - Ihre FastComments Tenant ID. Finden Sie diese unter Settings > API/SSO (EU).
  • API Secret - Erforderlich für Secure SSO, Webhook-Verifizierung und Seiten-Synchronisation. Zu finden unter Settings > API/SSO (EU).

Kommentarstil

Wählen Sie das Widget, das dazu passt, wie Besucher auf Ihrer Seite kommunizieren sollen.

  • Live Comments - Echtzeit-Thread-Kommentare.
  • Streaming Chat - Live-Chat-Oberfläche, gut für Veranstaltungen und Live-Streams.
  • Collab Chat - Anmerkungen durch Textauswahl im Hauptinhalt. Besucher markieren Text und starten eine Diskussion im Kontext.
  • Collab Chat + Comments - Sowohl Collab Chat als auch normale Kommentare auf derselben Seite.

SSO-Modus

  • None - Kein SSO. Nutzer kommentieren als Gäste oder erstellen ein FastComments-Konto.
  • Simple - Übermittelt Drupal-Benutzerinformationen (Name, E-Mail, Avatar) an FastComments ohne serverseitige Verifikation.
  • Secure - Verwendet HMAC-SHA256, um Drupal-Benutzer mit FastComments zu verifizieren. Empfohlen, wenn ein API Secret konfiguriert ist.

Siehe den Abschnitt Single Sign-On (SSO) für Details.

Weitere Einstellungen

  • CDN URL - Standardmäßig https://cdn.fastcomments.com.
  • Site URL - Standardmäßig https://fastcomments.com.
  • Email notifications - Sendet eine E-Mail an den Inhaltsautor, wenn ein neuer Kommentar zu seinem Inhalt veröffentlicht wird.

Für Informationen zur Datenresidenz in der EU siehe den Abschnitt EU Data Residency.

Widget-Blöcke Internal Link

Das Modul enthält mehrere Blöcke, die Sie unter Structure > Block layout (/admin/structure/block) platzieren können.

  • FastComments Widget - Das Hauptkommentar-Widget. Erkennt die aktuelle Entität automatisch. Es überspringt Entitäten, die bereits das FastComments-Feld angehängt haben, sodass Sie keine doppelten Widgets auf derselben Seite sehen.
  • FastComments Live Chat - Echtzeit-Streaming-Chat. Kann auf derselben Seite neben dem Kommentarfeld platziert werden.
  • FastComments Collab Chat - Anmerkungen und Diskussionen zu Textauswahlen.
  • FastComments Image Chat - Koordinatenbasierte Anmerkungen auf Bildern. Besucher klicken auf ein Bild, um Kommentare zu hinterlassen, die an bestimmte Positionen gebunden sind.
  • FastComments Recent Comments - Zeigt die neuesten Kommentare auf Ihrer Website an. Die Anzahl ist im Block konfigurierbar.
  • FastComments Top Pages - Zeigt die Seiten Ihrer Website mit den meisten Kommentaren an.

Die inhaltszentrierten Blöcke (Live Chat, Collab Chat, Image Chat) erkennen die aktuelle Entität automatisch und greifen auf einen pfadbasierten Bezeichner für Nicht-Entitätsseiten zurück. Das bedeutet, dass sie auf Taxonomie-Seiten, Views und benutzerdefinierten Routen ohne zusätzliche Einrichtung funktionieren.

Felder des Inhaltstyps Internal Link

Für die meisten Websites ist die einfachste Möglichkeit, Kommentare hinzuzufügen, das Anfügen des Feldes FastComments an Ihre Inhaltstypen. Gehen Sie zu Structure > Content types > [type] > Manage fields und fügen Sie das Feld hinzu.

Each entity that has the field gets:

  • A status toggle so editors can turn commenting on or off per entity.
  • An optional custom identifier so you can use a stable ID that isn't tied to the Drupal entity path.

The main FastComments Widget block knows about this field, and will skip entities that already have it attached. That way you can mix per-entity comments with the block without seeing the widget twice on the same page.

Einmalanmeldung (SSO) Internal Link

FastComments integriert sich in Drupals Benutzersystem über SSO, also Single Sign-On. Ihre Nutzer melden sich auf Ihrer Drupal-Seite an, und das Modul übermittelt deren Identität automatisch an FastComments. Keine zusätzlichen Konten zu erstellen, kein anfänglicher Sync erforderlich.

Das Modul unterstützt drei SSO-Modi, die unter Administration > Configuration > Content > FastComments eingestellt werden.

Keine

Kein SSO. Nutzer kommentieren als Gäste oder erstellen ein FastComments-Konto. Verwenden Sie dies, wenn Ihre Seite öffentlich ist und Sie Kommentare nicht an Drupal-Benutzer binden müssen.

Einfach

Übermittelt den Drupal-Benutzernamen, die E-Mail und das Avatar an FastComments ohne serverseitige Verifizierung. Kein API Secret nötig. Gut für interne oder gering riskante Seiten.

Sicher (empfohlen)

Verwendet HMAC-SHA256, um jede Benutzeridentität gegenüber FastComments zu verifizieren. Dies ist der Modus, den Sie verwenden sollten, wenn ein API Secret konfiguriert ist, und er ist der einzige Modus, der verhindert, dass ein Besucher einen anderen Nutzer vortäuscht.

Die Benutzeridentität wird an FastComments übermittelt, jedes Mal, wenn ein Nutzer einen Kommentarthread ansieht. Es gibt keinen anfänglichen oder kontinuierlichen Sync, der ausgeführt werden muss.

(Optional) Fügen Sie Ihre Administratoren zu Benutzer & Administratoren und Moderatoren zu Kommentarmoderatoren hinzu, um deren Experience zu verbessern und die Statistikverfolgung für Moderatoren zu aktivieren.

Für einen tieferen Einblick, wie SSO funktioniert, siehe den SSO-Abschnitt der Anpassungsdokumentation.

Berechtigungen Internal Link

Das Modul fügt drei Drupal-Berechtigungen hinzu, die Sie pro Rolle unter People > Permissions zuweisen können.

  • Administer FastComments - Zugriff auf das FastComments-Einstellungsformular unter /admin/config/content/fastcomments.
  • View FastComments - Erforderlich, um das Kommentierungs-Widget zu sehen. Ohne diese Berechtigung wird das Widget nicht gerendert.
  • Toggle FastComments - Ermöglicht es Benutzern, Kommentare pro Entität mithilfe des Feld-Widgets zu aktivieren oder zu deaktivieren.

Standardmäßig können nur Benutzer mit der Berechtigung administer site configuration die FastComments-Einstellungen ändern. Weisen Sie View FastComments anonymen und authentifizierten Benutzern zu, wenn Besucher das Widget sehen sollen.

Mehrsprachig Internal Link

Das Modul übergibt automatisch die aktuelle Drupal-Site-Sprache an jedes FastComments widget. Wenn Ihre Drupal-Site für mehrere Sprachen konfiguriert ist, wird die Kommentar-UI in der entsprechenden Sprache angezeigt, ohne dass zusätzliche Konfiguration erforderlich ist.

Dies gilt für alle Widget-Typen: Live Comments, Streaming Chat, Collab Chat, Image Chat, Recent Comments und Top Pages.

EU-Datenresidenz Internal Link

Wenn Ihr FastComments-Konto in der EU gehostet wird, aktualisieren Sie zwei Einstellungen unter Administration > Configuration > Content > FastComments:

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

Außerdem sollten Sie Ihre Tenant ID und Ihr API Secret vom EU-Dashboard unter eu.fastcomments.com/auth/my-account/api abrufen, anstatt vom standardmäßigen US-Dashboard. Alles andere im Modul funktioniert gleich.

Anpassung Internal Link

FastComments wurde so konzipiert, dass es an Ihre Website angepasst werden kann.

Wenn Sie benutzerdefinierte Styles hinzufügen oder die Konfiguration anpassen möchten, sehen Sie sich unsere Dokumentation zu Anpassungen und Konfiguration an, um zu erfahren, wie.

Anforderungen Internal Link

  • Drupal 10 oder 11
  • PHP 8.1 oder neuer
  • Ein FastComments Konto

Das Modul benötigt keine weiteren Drupal-Module oder Bibliotheken von Drittanbietern. Es hängt nur vom Drupal-Kern (user, field) ab.

Ein <noscript>-Fallback liefert serverseitig gerenderte Kommentare für Besucher ohne JavaScript, sodass Live Comments und Streaming Chat weiterhin in Browsern mit deaktiviertem Skript funktionieren.

Zu diesem Leitfaden beitragen