FastComments.com
Menu Icon

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

TLDR

Snelstart

Drupal-installatie

Installatie
Configuratie
Widgetblokken
Inhoudstypevelden
Single Sign-On (SSO)
Machtigingen
Meertalig
EU-gegevensresidentie
Aanpassing
Vereisten

Polls

Polls toevoegen aan uw Drupal-site

Live reacties toevoegen aan Drupal-sites

Snelstart 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 - Je FastComments Tenant ID. Je vindt deze onder Settings > API/SSO (EU).
  • API Secret - Vereist voor Secure SSO, webhook-verificatie en paginasynchronisatie. Te vinden onder Settings > API/SSO (EU).

Het API Secret opslaan

De module leest het API Secret uit de eerste van deze bronnen die een waarde bevat:

  1. Key module - Installeer Key, maak een Authentication-sleutel aan en selecteer deze onder API Secret key op het instellingenformulier. De sleutel kan worden ondersteund door een omgevingsvariabele of een bestand buiten de web root.
  2. settings.php - Voeg $config['fastcomments.settings']['api_secret'] = 'your-secret'; toe aan settings.php of settings.local.php. Het secret komt nooit in geëxporteerde configuratie terecht.
  3. Het instellingenformulier - Vul het in het veld API Secret in. Dit slaat de waarde op in fastcomments.settings, waardoor deze in configuratie-exporten terechtkomt. Het Drupal-statusrapport geeft een waarschuwing wanneer dit de actieve bron is.

Het formulier toont welke bron actief is. Als je het veld leeg laat, blijft het opgeslagen secret behouden. Vink Remove the API Secret stored in configuration aan om het te verwijderen nadat je het secret naar de Key module of settings.php hebt verplaatst.

Commentaarstijl

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

  • Live Comments - Reacties in real-time met discussielijnen.
  • Streaming Chat - Live chat-interface, geschikt voor evenementen en livestreams.
  • Collab Chat - Annotatie op tekstselectie in het hoofdcontentgebied. Bezoekers markeren tekst en starten een discussie in 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 bij FastComments. Aanbevolen wanneer je een API Secret hebt geconfigureerd.

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

Overige instellingen

  • CDN URL - Standaard https://cdn.fastcomments.com.
  • Site URL - Standaard https://fastcomments.com.
  • E-mailnotificaties - Stuur een e-mail naar een contentauteur wanneer er een nieuwe reactie op hun content wordt geplaatst.

Zie voor EU-dataresidentie 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.

Inhoudstypevelden 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. Je gebruikers melden zich aan op je Drupal-site en de module geeft hun identiteit automatisch door aan FastComments. Geen extra accounts om aan te maken, geen initiële synchronisatie die uitgevoerd moet worden.

De module ondersteunt drie SSO-modi, in te stellen onder Administration > Configuration > Content > FastComments.

None

Geen SSO. Gebruikers reageren als gast of maken een FastComments-account aan. Gebruik dit als je site publiek is en je 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 server-side verificatie. Geen API Secret nodig. Geschikt voor interne of laag-risico sites.

Secure (aanbevolen)

Gebruikt HMAC-SHA256 om elke gebruikersidentiteit te verifiëren met FastComments. Dit is de modus die je wilt wanneer je 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 elke keer dat een gebruiker een commentaarthread bekijkt aan FastComments doorgegeven. Er hoeft geen initiële of doorlopende synchronisatie uitgevoerd te worden.

(Optioneel) Voeg je beheerders toe aan Users & Administrators en moderatoren aan Comment Moderators om hun ervaring te verbeteren en statistiekregistratie voor moderatoren in te schakelen.

Voor een diepere blik op hoe SSO werkt, zie de SSO-sectie van de aanpassingsdocumentatie.

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.

Aanpassing 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.

Polls toevoegen aan uw Drupal-site Internal Link

Zodra FastComments op uw Drupal‑site staat, kunt u ook live peilingen uitvoeren direct in de reacties. Schakel Enable Polls in uw widget‑aanpassingsinstellingen in en er verschijnt een peilingknop in de reactie‑werkbalk. Peilingen hebben 2 tot 10 opties, resultaten worden live bijgewerkt voor iedereen op de pagina, en u bepaalt wie peilingen kan maken en of stemmen een login vereist. Er is verder niets te installeren op Drupal.

Probeer de Live Polls‑demo of lees de Polls‑documentatie om ze in te stellen.

Bijdragen aan deze gids