
Sprache 🇩🇪 Deutsch
Erste Schritte
Konfiguration
Dokumentation
Add Comments to Your Drupal Site
Dies ist das offizielle Drupal-Modul für FastComments.
Ein Drupal-Modul, das FastComments mit Drupal 10/11 integriert und Widget-Blöcke, Entity-Feld-Integration, SSO und granulare Berechtigungen bereitstellt.
Repository
Installation 
- Platzieren Sie dieses Modul im
modules/custom/fastcomments/Verzeichnis Ihrer Drupal-Website (oder installieren Sie es über Composer:composer require drupal/fcom). - Aktivieren Sie das Modul:
Oder aktivieren Sie es über die Admin-Oberfläche unter Extend (drush en fastcomments/admin/modules).
Konfiguration 
Navigieren Sie zu Administration > Konfiguration > Inhalt > FastComments (/admin/config/content/fastcomments).
Einstellungen
- Tenant-ID (erforderlich) - Ihre FastComments Tenant ID. Finden Sie dies unter Einstellungen > API/SSO (EU).
- API-Geheimnis - Erforderlich für Secure SSO, Webhook-Verifizierung und Page Sync. Zu finden unter Einstellungen > API/SSO (EU).
- SSO-Modus - Single Sign-On-Integration:
- None - Kein SSO, Benutzer kommentieren als Gäste oder erstellen FastComments-Konten.
- Simple - Übermittelt Drupal-Benutzerinformationen (Name, E-Mail, Avatar) an FastComments ohne serverseitige Verifizierung.
- Secure - Verwendet HMAC-SHA256-Verifizierung, um Drupal-Benutzer sicher bei FastComments zu authentifizieren (empfohlen).
- Kommentarstil - Der anzuzeigende Widget-Typ:
- Live Comments - Echtzeit-Thread-Kommentare.
- Streaming Chat - Live-Chat-Oberfläche.
- Collab Chat - Kollaborative Textauswahl-Anmerkung im Hauptinhaltsbereich.
- Collab Chat + Comments - Sowohl Collab-Chat als auch Standardkommentare.
- CDN URL - FastComments CDN-URL (Standard:
https://cdn.fastcomments.com). - Site URL - FastComments Site-URL (Standard:
https://fastcomments.com). - E-Mail-Benachrichtigungen - Sendet eine E-Mail an Inhaltsautoren, wenn ein neuer Kommentar zu ihrem Inhalt veröffentlicht wird.
Hinzufügen von Kommentaren zu Inhaltstypen
Fügen Sie das Feld FastComments zu Ihren Inhaltstypen über Struktur > Inhaltstypen > [type] > Felder verwalten hinzu. Das Feld verfügt über einen Status-Umschalter und einen optionalen benutzerdefinierten Bezeichner pro Entität.
EU-Datenresidenz
Für die EU-Datenresidenz aktualisieren Sie:
- CDN URL zu
https://cdn-eu.fastcomments.com - Site URL zu
https://eu.fastcomments.com
Widget-Blöcke 
Mehrere Blöcke sind verfügbar unter Struktur > Block-Layout (/admin/structure/block):
- FastComments Widget - Das Hauptkommentierungs-Widget. Erkennt automatisch die aktuelle Entität. Überspringt Entitäten, die bereits das FastComments-Feld haben (um Duplikate zu verhindern).
- FastComments Live Chat - Echtzeit-Streaming-Chat. Kann auf derselben Seite neben dem Kommentarfeld platziert werden.
- FastComments Collab Chat - Annotation und Diskussion zu ausgewähltem Text.
- FastComments Image Chat - Koordinatenbasierte Annotation auf Bildern.
- FastComments Recent Comments - Zeigt kürzliche Kommentare auf Ihrer Website an. Die Anzahl der Kommentare ist konfigurierbar.
- FastComments Top Pages - Zeigt Seiten mit den meisten Kommentaren.
Inhaltszentrierte Blöcke (Live Chat, Collab Chat, Image Chat) erkennen automatisch die aktuelle Entität und verwenden auf nicht-Entitätsseiten einen pfadbasierten Bezeichner als Fallback.
Berechtigungen 
- FastComments verwalten - Zugriff auf das Einstellungsformular von FastComments.
- FastComments anzeigen - Erforderlich, um das Kommentar-Widget anzusehen.
- FastComments umschalten - Ermöglicht Benutzern, Kommentare pro Entität über das Feld-Widget zu aktivieren/deaktivieren.
Funktionsweise 
Wenn ein Benutzer eine Entität besucht, bei der das FastComments-Feld aktiviert ist:
- Das FastComments JavaScript-Widget wird vom CDN geladen.
- Wenn SSO konfiguriert ist, wird die Drupal-Identität des Benutzers an FastComments übermittelt.
- Ein
<noscript>-Fallback liefert serverseitig gerenderte Kommentare für Benutzer ohne JavaScript (nur in den Modi Live Comments und Streaming Chat).
Anforderungen 
- Drupal 10 oder 11
- PHP 8.1+
- Ein FastComments-Konto
Benötigen Sie Hilfe?
Wenn Sie auf Probleme stoßen oder Fragen zum Drupal-Modul haben, bitte:
Mitwirken
Beiträge sind willkommen! Bitte besuchen Sie das GitHub-Repository für Richtlinien zur Mitarbeit.