FastComments.com
Menu Icon

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

TLDR

Schnellstart

Drupal-Installation

Installation
Konfiguration
Widget-Blöcke
Felder für Inhaltstypen
Single Sign-On (SSO)
Berechtigungen
Mehrsprachig
EU-Datenresidenz
Anpassung
Anforderungen

Umfragen

Umfragen zu Ihrer Drupal-Website hinzufügen

Live-Kommentare zu Drupal-Websites hinzufügen

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

All settings live under Administration > Konfiguration > Inhalt > 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‑Überprüfung und Seiten‑Synchronisation. Gefunden unter Settings > API/SSO (EU).

Speichern des API Secret

Das Modul liest das API Secret aus der ersten dieser Quellen, die einen Wert enthält:

  1. Key‑Modul – Installieren Sie Key, erstellen Sie einen Authentication‑Schlüssel und wählen Sie ihn unter API Secret key im Einstellungsformular aus. Der Schlüssel kann durch eine Umgebungsvariable oder eine Datei außerhalb des Web‑Root unterstützt werden.
  2. settings.php – Fügen Sie $config['fastcomments.settings']['api_secret'] = 'your-secret'; zu settings.php oder settings.local.php hinzu. Das Geheimnis wird nie in exportierte Konfiguration aufgenommen.
  3. Das Einstellungsformular – Geben Sie es in das Feld API Secret ein. Dies speichert den Wert in fastcomments.settings, sodass er in Konfigurationsexporte gelangt. Der Drupal‑Statusbericht warnt, wenn dies die aktive Quelle ist.

Das Formular zeigt, welche Quelle aktiv ist. Das Feld leer zu lassen bewahrt das gespeicherte Geheimnis. Aktivieren Sie Remove the API Secret stored in configuration, um es zu löschen, nachdem das Geheimnis in das Key‑Modul oder settings.php verschoben wurde.

Kommentarstil

Wählen Sie das Widget, das zu der Art und Weise passt, wie Besucher auf Ihrer Seite kommunizieren sollen.

  • Live Comments – Echtzeit‑Threaded‑Kommentare.
  • Streaming Chat – Live‑Chat‑Oberfläche, gut für Veranstaltungen und Livestreams.
  • Collab Chat – Textauswahl‑Annotation im Hauptinhaltsbereich. Besucher markieren Text und starten eine Diskussion im Kontext.
  • Collab Chat + Comments – Sowohl Collab‑Chat als auch Standardkommentare auf derselben Seite.

SSO‑Modus

  • None – Kein SSO. Benutzer kommentieren als Gäste oder erstellen ein FastComments‑Konto.
  • Simple – Überträgt Drupal‑Benutzerinformationen (Name, E‑Mail, Avatar) an FastComments ohne serverseitige Verifizierung.
  • 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 – Standardwert ist https://cdn.fastcomments.com.
  • Site URL – Standardwert ist https://fastcomments.com.
  • Email notifications – Sendet eine E‑Mail an den Inhaltsautor, wenn ein neuer Kommentar zu seinem Inhalt gepostet wird.

Für EU‑Datenresidenz 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 für Inhaltstypen Internal Link

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

Jede Entität, die das Feld hat, erhält:

  • Einen Status-Umschalter, damit Redakteure Kommentare pro Entität ein- oder ausschalten können.
  • Einen optionalen benutzerdefinierten Bezeichner, damit Sie eine stabile ID verwenden können, die nicht an den Drupal-Entitätspfad gebunden ist.

Der Hauptblock FastComments Widget kennt dieses Feld und überspringt Entitäten, die es bereits angefügt haben. So können Sie Kommentare pro Entität mit dem Block mischen, ohne das Widget zweimal auf derselben Seite zu sehen.

Single Sign-On (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.

Umfragen zu Ihrer Drupal-Website hinzufügen Internal Link

Sobald FastComments auf Ihrer Drupal‑Website ist, können Sie auch Live‑Umfragen direkt in den Kommentaren durchführen. Aktivieren Sie Enable Polls in Ihren Widget‑Anpassungseinstellungen und ein Umfrage‑Button erscheint in der Kommentar‑Symbolleiste. Umfragen können 2 bis 10 Optionen enthalten, die Ergebnisse werden für alle Besucher der Seite live aktualisiert, und Sie entscheiden, wer Umfragen erstellen darf und ob das Abstimmen eine Anmeldung erfordert. Es muss nichts Weiteres auf Drupal installiert werden.

Probieren Sie die Live‑Umfragen‑Demo oder lesen Sie die Umfragen‑Dokumentation, um sie einzurichten.

Zu diesem Leitfaden beitragen