FastComments.com
Menu Icon

Taal 🇳🇱 Nederlands
🇺🇸 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

Kort samengevat

Snel aan de slag

Drupal-installatie

Installatie
Configuratie
Widgetblokken
Velden voor inhoudstypen
Single Sign-On (SSO)
Machtigingen
Meertalig
EU-gegevensresidentie
Aanpassingen
Vereisten

Add Live Commenting to Drupal Sites

Snel aan de slag Internal Link

Dit is de "te lang; niet gelezen" versie van de Drupal-instructies.

  1. Installeer de module met composer require drupal/fcom, of plaats deze in modules/custom/fastcomments/.
  2. Schakel deze in met drush en fastcomments, of via de admin-UI op /admin/modules.
  3. Ga naar Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).
  4. Voer uw Tenant ID en API Secret in van Instellingen > API/SSO (EU).
  5. Voeg het veld FastComments toe aan elk contenttype via Structure > Content types > [type] > Manage fields.

De module is gepubliceerd op drupal.org/project/fcom.

Installatie Internal Link

De FastComments Drupal-module vervangt de ingebouwde reacties van Drupal door een snel, real-time reactiesysteem. De module is gepubliceerd op drupal.org en werkt met Drupal 10 en 11.

Er zijn twee manieren om het te installeren.

Installeren met Composer

composer require drupal/fcom
drush en fastcomments

Handmatig installeren

Download de module van drupal.org/project/fcom en plaats deze in de map modules/custom/fastcomments/ van uw site. Schakel het vervolgens in met drush en fastcomments, of via de beheer-UI bij Extend (/admin/modules).

Opmerking! De module is alleen afhankelijk van Drupal core (user en field). Er zijn geen andere Drupal-modules of bibliotheken vereist.

Zodra de module is ingeschakeld, gaat u naar de sectie Configuration om uw Tenant ID en API Secret in te stellen.

Configuratie Internal Link

Alle instellingen bevinden zich onder Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).

Vereist

  • Tenant ID - Uw FastComments Tenant ID. Dit vindt u onder Settings > API/SSO (EU).
  • API Secret - Vereist voor Secure SSO, webhookverificatie en pagina-synchronisatie. Te vinden onder Settings > API/SSO (EU).

Commentaarstijl

Kies de widget die past bij hoe u wilt dat mensen op uw site met elkaar praten.

  • Live Comments - Realtime geneste reacties.
  • Streaming Chat - Live chat-interface, geschikt voor evenementen en livestreams.
  • Collab Chat - Tekstselectie-annotatie op het hoofdinhoudsgebied. Bezoekers markeren tekst en starten een discussie in de context.
  • Collab Chat + Comments - Zowel collab chat als standaardreacties op dezelfde pagina.

SSO-modus

  • None - Geen SSO. Gebruikers reageren als gasten of maken een FastComments-account aan.
  • Simple - Geeft Drupal-gebruikersgegevens (naam, e-mail, avatar) door aan FastComments zonder server-side verificatie.
  • Secure - Gebruikt HMAC-SHA256 om Drupal-gebruikers te verifiëren met FastComments. Aanbevolen wanneer u een API Secret hebt geconfigureerd.

Zie de Single Sign-On (SSO) sectie voor details.

Overige instellingen

  • CDN URL - Standaard https://cdn.fastcomments.com.
  • Site URL - Standaard https://fastcomments.com.
  • Email notifications - Stuurt een e-mail naar de auteur van de inhoud wanneer er een nieuwe reactie op hun inhoud wordt geplaatst.

Voor EU-gegevensresidentie, zie de sectie EU Data Residency.

Widgetblokken Internal Link

De module bevat meerdere blokken die je kunt plaatsen via Structure > Block layout (/admin/structure/block).

  • FastComments Widget - De hoofdopmerkingen-widget. Detecteert automatisch de huidige entiteit. Het slaat entiteiten over die al het FastComments field hebben gekoppeld, zodat je geen dubbele widgets op dezelfde pagina ziet.
  • FastComments Live Chat - Realtime streamingchat. Kan naast het reactieveld op dezelfde pagina geplaatst worden.
  • FastComments Collab Chat - Annotatie en discussie bij tekstselectie.
  • FastComments Image Chat - Annotatie op basis van coördinaten in afbeeldingen. Bezoekers klikken op een afbeelding om opmerkingen achter te laten die aan specifieke locaties zijn gekoppeld.
  • FastComments Recent Comments - Toont recente opmerkingen op je site. Het aantal is configureerbaar via het blok.
  • FastComments Top Pages - Toont de pagina's op je site met de meeste opmerkingen.

De contentgerichte blokken (Live Chat, Collab Chat, Image Chat) detecteren automatisch de huidige entiteit en vallen terug op een pad-gebaseerde identificatie op niet-entiteitspagina's. Dat betekent dat ze werken op taxonomiepagina's, views en aangepaste routes zonder extra configuratie.

Velden voor inhoudstypen Internal Link

Voor de meeste sites is de eenvoudigste manier om reacties toe te voegen het koppelen van het FastComments-veld aan uw inhoudstypen. Ga naar Structure > Content types > [type] > Manage fields en voeg het veld toe.

Elke entiteit die het veld heeft, krijgt:

  • Een statusschakelaar zodat redacteuren reacties per entiteit kunnen in- of uitschakelen.
  • Een optionele aangepaste identificatie zodat u een stabiel ID kunt gebruiken dat niet is gekoppeld aan het pad van de Drupal-entiteit.

Het hoofdblok FastComments Widget kent dit veld en zal entiteiten overslaan waaraan het al is gekoppeld. Op die manier kunt u per-entiteit reacties combineren met het blok zonder dat u de widget twee keer op dezelfde pagina ziet.

Single Sign-On (SSO) Internal Link

FastComments integreert met het gebruikerssysteem van Drupal via SSO, of single-sign-on. Uw gebruikers melden zich aan op uw Drupal-site, en de module geeft hun identiteit automatisch door aan FastComments. Geen extra accounts aan te maken, geen initiële synchronisatie uit te voeren.

De module ondersteunt drie SSO-modi, ingesteld onder Administration > Configuration > Content > FastComments.

None

Geen SSO. Gebruikers plaatsen opmerkingen als gasten of maken een FastComments-account aan. Gebruik dit als uw site openbaar is en u reacties niet aan Drupal-gebruikers hoeft te koppelen.

Simple

Geeft de naam, het e-mailadres en de avatar van de Drupal-gebruiker door aan FastComments zonder verificatie aan de serverzijde. Er is geen API Secret nodig. Goed voor interne of laag-risico sites.

Gebruikt HMAC-SHA256 om elke gebruikersidentiteit te verifiëren met FastComments. Dit is de modus die u wilt gebruiken wanneer u een API Secret hebt geconfigureerd, en het is de enige modus die voorkomt dat een bezoeker zich voordoet als een andere gebruiker.

De gebruikersidentiteit wordt aan FastComments doorgegeven telkens wanneer een gebruiker een discussiedraad bekijkt. Er is geen initiële of continue synchronisatie die uitgevoerd moet worden.

(Optioneel) Voeg uw beheerders toe aan Users & Administrators en moderators aan Comment Moderators om hun ervaring te verbeteren en het bijhouden van statistieken voor moderators mogelijk te maken.

Voor een diepere blik op hoe SSO werkt, zie de SSO section van de customisatiedocumentatie.

Machtigingen Internal Link

De module voegt drie Drupal-machtigingen toe die je per rol kunt toewijzen onder People > Permissions.

  • Administer FastComments - Toegang tot het instellingenformulier van FastComments op /admin/config/content/fastcomments.
  • View FastComments - Vereist om de commentaarwidget te zien. Zonder deze toestemming wordt de widget niet weergegeven.
  • Toggle FastComments - Maakt het gebruikers mogelijk om opmerkingen per entiteit aan of uit te schakelen met behulp van de veld-widget.

Standaard kunnen alleen gebruikers met de administer site configuration-machtiging de FastComments-instellingen wijzigen. Geef View FastComments aan anonieme en geauthenticeerde gebruikers als je wilt dat bezoekers de widget zien.

Meertalig Internal Link

De module geeft automatisch de huidige taal van de Drupal-site door aan elk FastComments-widget. Als uw Drupal-site is geconfigureerd voor meerdere talen, wordt de commentaarinterface weergegeven in de overeenkomende taal zonder extra configuratie.

Dit geldt voor alle widgettypen: Live Comments, Streaming Chat, Collab Chat, Image Chat, Recent Comments, en Top Pages.

EU-gegevensresidentie Internal Link

Als uw FastComments-account in de EU wordt gehost, werk dan twee instellingen bij in Administration > Configuration > Content > FastComments:

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

U wilt ook uw Tenant ID en API Secret ophalen uit het EU-dashboard op eu.fastcomments.com/auth/my-account/api in plaats van het standaard Amerikaanse dashboard. Verder werkt de module hetzelfde.

Aanpassingen Internal Link

FastComments is ontworpen om te worden aangepast zodat het bij uw site past.

Als u aangepaste styling wilt toevoegen, of de configuratie wilt aanpassen, Bekijk onze documentatie over aanpassingen en configuratie om te leren hoe.

Vereisten Internal Link

  • Drupal 10 of 11
  • PHP 8.1 of nieuwer
  • Een FastComments account

De module vereist geen andere Drupal-modules of bibliotheken van derden. Het is alleen afhankelijk van Drupal core (user, field).

Een <noscript>-fallback biedt servergerenderde reacties voor bezoekers zonder JavaScript, zodat Live Comments en Streaming Chat nog steeds werken in browsers met scripting uitgeschakeld.

Bijdragen aan deze gids