Add Comments to Your Drupal Site
Dit is de officiële Drupal-module voor FastComments.
Een Drupal-module die FastComments integreert met Drupal 10/11 en widgetblokken, integratie van entiteitsvelden, SSO en gedetailleerde machtigingen biedt.
Repository
Installatie 
- Plaats deze module in de map van uw Drupal-site
modules/custom/fastcomments/(of installeer via Composer:composer require drupal/fcom). - Activeer de module:
Of activeer via de beheerdersinterface onder Uitbreiden (drush en fastcomments/admin/modules).
Configuratie
Ga naar Administratie > Configuratie > Inhoud > FastComments (/admin/config/content/fastcomments).
Instellingen
- Tenant ID (required) - Uw FastComments Tenant ID. Vind dit onder Instellingen > API/SSO (EU).
- API Secret - Vereist voor Secure SSO, webhook-verificatie en page sync. Te vinden onder Instellingen > API/SSO (EU).
- SSO Mode - Single Sign-On-integratie:
- None - Geen SSO, gebruikers reageren als gasten of maken FastComments-accounts.
- Simple - Stuurt Drupal-gebruikersinformatie (naam, e-mail, avatar) naar FastComments zonder server-side verificatie.
- Secure - Gebruikt HMAC-SHA256-verificatie om Drupal-gebruikers veilig te authenticeren bij FastComments (aanbevolen).
- Commenting Style - Het type widget dat wordt weergegeven:
- Live Comments - Real-time geneste reacties.
- Streaming Chat - Live chat-interface.
- Collab Chat - Collaboratieve annotatie via tekstselectie in het hoofdinhoudsgebied.
- Collab Chat + Comments - Zowel collab chat als standaardreacties.
- CDN URL - FastComments CDN-URL (standaard:
https://cdn.fastcomments.com). - Site URL - FastComments-site-URL (standaard:
https://fastcomments.com). - Email notifications - Stuur een e-mail naar de auteurs van de inhoud wanneer een nieuwe reactie op hun inhoud wordt geplaatst.
Reacties toevoegen aan inhoudstypen
Voeg het FastComments-veld toe aan uw inhoudstypes via Structuur > Inhoudstypes > [type] > Velden beheren. Het veld heeft een status-schakelaar en een optionele aangepaste identificator per entiteit.
EU Data Residency
Voor EU-gegevensresidentie, wijzig:
- CDN URL naar
https://cdn-eu.fastcomments.com - Site URL naar
https://eu.fastcomments.com
Widgetblokken
Verschillende blokken zijn beschikbaar via Structuur > Blokindeling (/admin/structure/block):
- FastComments Widget - De belangrijkste widget voor reacties. Detecteert automatisch de huidige entiteit. Slaat entiteiten over die al het FastComments-veld hebben (om duplicaten te voorkomen).
- FastComments Live Chat - Realtime streamingchat. Kan naast het reactieveld op dezelfde pagina worden geplaatst.
- FastComments Collab Chat - Annotatie en discussie op basis van tekstselectie.
- FastComments Image Chat - Annotatie op afbeeldingen op basis van coördinaten.
- FastComments Recent Comments - Toont recente reacties op uw site. Aantal reacties configureerbaar.
- FastComments Top Pages - Toont pagina's met de meeste reacties.
Inhoudsgerichte blokken (Live Chat, Collab Chat, Image Chat) detecteren automatisch de huidige entiteit en vallen terug op een padgebaseerde identificator op niet-entiteitspagina's.
Meertalig
De module geeft automatisch de huidige taal van de Drupal-site door aan alle widgets.
Machtigingen
- Beheer FastComments - Toegang tot het instellingenformulier van FastComments.
- Bekijk FastComments - Vereist om de reactie-widget te zien.
- Schakel FastComments in/uit - Maakt het gebruikers mogelijk reacties per entiteit in of uit te schakelen via de veldwidget.
Hoe het werkt
Wanneer een gebruiker een entiteit bezoekt met het FastComments-veld ingeschakeld:
- Het FastComments JavaScript-widget wordt geladen vanaf het CDN.
- Als SSO is geconfigureerd, wordt de Drupal-identiteit van de gebruiker doorgegeven aan FastComments.
- Een
<noscript>fallback levert server-gerenderde reacties voor gebruikers zonder JavaScript (alleen in de Live Comments- en Streaming Chat-modi).
Vereisten
Hulp nodig?
Als u problemen ondervindt of vragen heeft over de Drupal-module, neem dan:
Bijdragen
Bijdragen zijn welkom! Bezoek de GitHub repository voor richtlijnen voor bijdragen.