HomeDocumentatie

WordPress Plugin

Voeg ChatReact AI-chatbots, contactformulieren en FAQ-accordeons toe aan uw WordPress-site met onze officiële plugin.

Download

De plugin is beschikbaar in de officiële WordPress Plugin Directory, of als directe download:

Download ChatReact Plugin v1.2.1

Installatie

Methode 1: WordPress Plugin Directory (Aanbevolen)

  1. Ga naar Plugins → Nieuwe toevoegen in uw WordPress-beheer
  2. Zoek naar ChatReact
  3. Klik op Nu installeren, daarna Activeren

Methode 2: Upload via WordPress-beheer

  1. Download het plugin-ZIP-bestand hierboven
  2. Ga naar Plugins → Nieuwe toevoegen → Plugin uploaden
  3. Kies het ZIP-bestand en klik op Nu installeren
  4. Klik op Plugin activeren

Methode 3: Handmatige upload via FTP

  1. Pak het ZIP-bestand uit
  2. Upload de chatreact-map naar /wp-content/plugins/
  3. Ga naar Plugins in het WordPress-beheer
  4. Zoek "ChatReact" en klik op Activeren

Configuratie

Na activatie opent u het ChatReact-menu in de zijbalk van uw WordPress-beheer voor instellingen en gebruiksinstructies.

Uw Chatbot-ID vinden

  1. Log in op chatreact.ai
  2. Open uw chatbot en ga naar het Insluiten-tabblad
  3. Klik Code kopiëren om het embed-snippet te kopiëren, of lees de ID af van het data-chatbot-id-attribuut in de gekopieerde code

Uw Formulier-ID vinden

  1. Log in op chatreact.ai
  2. Ga naar Formulieren
  3. Klik Kopieer insluitcode op uw formulier (of open het formulier en schakel over naar het Insluiten-tabblad)
  4. Uw Formulier-ID is de waarde van data-form-id in de gekopieerde embed-code

Gebruiksmogelijkheden

De plugin biedt meerdere manieren om ChatReact aan uw site toe te voegen:

1. Shortcodes

Voeg toe aan elke pagina, bericht of widget-gebied:

Chatwidget:

[chatreact id="YOUR_CHATBOT_ID"]

Optionele attributen: language

Contactformulier:

[chatreact_form id="YOUR_FORM_ID"]

Optionele attributen: language

FAQ-accordeon:

[chatreact_faq id="YOUR_CHATBOT_ID"]

Optionele attributen: categories, container, language

Visuele instellingen zoals positie, kleuren en auto-open worden centraal beheerd in uw ChatReact-dashboard en worden automatisch toegepast op uw WordPress-site. Het language-attribuut is optioneel bij alle shortcodes — als u het weglaat wordt de taal van de huidige pagina automatisch gedetecteerd (werkt met meertalige sites).

2. Gutenberg-blokken

In de block-editor:

  1. Klik op + om een blok toe te voegen
  2. Zoek naar "ChatReact"
  3. Kies ChatReact Chat, ChatReact Form of ChatReact FAQ
  4. Voer uw ID in bij de blokk instellingen

3. Elementor

Als u Elementor gebruikt:

  1. Bewerk uw pagina met Elementor
  2. Zoek naar "ChatReact" in de widgets
  3. Sleep de widget naar uw pagina
  4. Configureer in het linkerpaneel

4. Widget-toewijzingen (Plugin-instellingen)

Toon een chatbot op specifieke pagina's — of op uw hele site — zonder inhoud te bewerken:

  1. Open het ChatReact-menu in uw beheerderszijbalk
  2. Ga naar het Chat Widget-tabblad en vind Widget Assignments
  3. Klik op Add Assignment, kies een pagina of bericht (of selecteer Everywhere), en voer uw Chatbot ID in
  4. Klik Wijzigingen opslaan

Voor Everywhere-toewijzingen kunt u specifieke URL's uitsluiten — één per regel, met wildcard-ondersteuning (bijv. /blog/* of /checkout) — om de widget te verbergen op landingspagina's of tijdens de checkout.

Standaard zijn alleen Pagina's doorzoekbaar bij het toewijzen. Klik op de Post Types-knop om andere contenttypes (bijv. Berichten of custom post types) ook doorzoekbaar te maken.

5. Pagina-niveau toewijzing

Wijs een chatbot toe aan een enkele pagina direct vanuit de editor:

  1. Bewerk een pagina of bericht
  2. Zoek het meta-box "ChatReact Widget"
  3. Vink Enable custom widget for this page aan
  4. Voer uw Chatbot ID in en kies optioneel een positie (Default, Bottom Right, Bottom Left)
  5. Sla de pagina op

Hetzelfde meta-box biedt ook een optie Disable all widgets on this page als u ChatReact volledig op bepaalde pagina's wilt verbergen.

Shortcode-voorbeelden

Basis Chat Widget

[chatreact id="abc123"]

Chat Widget met een vaste taal

[chatreact id="abc123" language="de"]

FAQ met categorie-filter

[chatreact_faq id="abc123" categories="shipping,returns"]

Gestyled contactformulier

[chatreact_form id="form123" language="en"]

FAQ-widget: SEO & Caching

SEO-vriendelijke FAQs

Sinds versie 1.1.2 worden FAQ-widgets server-side gerenderd: uw FAQs zijn onderdeel van de pagin HTML en bevatten JSON-LD gestructureerde data (FAQPage-schema). Zoekmachines en AI-assistenten kunnen ze lezen zonder JavaScript uit te voeren.

llms.txt voor AI-crawlers

De plugin kan uw FAQ-inhoud serveren op yoursite.com/llms.txt, een discovery-bestand dat door AI-crawlers wordt gelezen. Het staat standaard ingeschakeld. Om dit uit of aan te zetten of een specifieke Chatbot ID voor het bestand in te stellen, gaat u naar ChatReact → FAQ Widget → Cache & SEO Settings.

FAQ-caching

FAQ-gegevens worden gecached op uw server voor snelle paginaladingen. Onder ChatReact → FAQ Widget → Cache & SEO Settings kunt u:

  • De Cache Duration instellen — 1, 3, 6 (aanbevolen), 12 of 24 uur, of caching uitschakelen
  • Klik op Clear Cache om uw FAQs direct te verversen

De cache wordt ook automatisch geleegd wanneer uw FAQs in het ChatReact-dashboard worden gewijzigd.

Ondersteunde talen

De plugin ondersteunt 24 EU-talen:

  • Bulgaars, Kroatisch, Tsjechisch, Deens, Nederlands, Engels
  • Ests, Fins, Frans, Duits, Grieks, Hongaars
  • Iers, Italiaans, Lets, Litouws, Maltees, Pools
  • Portugees, Roemeens, Slowaaks, Sloveens, Spaans, Zweeds

Sinds versie 1.2.0 worden vertalingen voor alle 24 talen meegeleverd met de plugin. De widgettaal wordt automatisch gedetecteerd op basis van de huidige pagina, dus meertalige sites werken direct — gebruik het language-shortcodeattribuut alleen als u een specifieke taal wilt forceren.

Problemen oplossen

Widget verschijnt niet

  1. Controleer of uw Chatbot ID correct is
  2. Controleer of de chatbot actief is in uw ChatReact-dashboard
  3. Maak eventuele paginacaching-plugins leeg (zie hieronder)
  4. Controleer de browserconsole op JavaScript-fouten

Compatibiliteit met caching-plugins

De plugin is volledig compatibel met populaire caching- en optimalisatieplugins, waaronder WP Rocket, LiteSpeed Cache, Autoptimize en WP Super Cache. De plugin voorkomt automatisch dat deze tools ChatReact-scripts minifiëren of cachen.

Als u nog steeds problemen ondervindt (bijv. 404-fouten, widget laadt niet voor uitgelogde bezoekers):

  1. Maak de cache van uw caching-plugin leeg
  2. Sluit chatreact uit van JS-minificatie/combineringsinstellingen in uw caching-plugin
  3. De plugin gebruikt data-api-url-attributen als fallback om correcte API-communicatie te waarborgen

FAQs worden niet bijgewerkt

Als uw site verouderde FAQs toont, gaat u naar ChatReact → FAQ Widget en klikt u op Clear Cache. De cache wordt ook automatisch gewist wanneer u uw FAQs in het ChatReact-dashboard bewerkt.

Stylingconflicten

Als de widget er kapot uitziet:

  • De widget gebruikt geïsoleerde CSS
  • Controleer op CSS !important-regels in uw thema
  • Probeer tijdelijk andere chat-plugins uit te schakelen

Meerdere widgets

U kunt verschillende chatbots op verschillende pagina's gebruiken door unieke IDs op te geven in elke shortcode of blok.

CMS-integratie (Smart Sitemap)

Vanaf versie 1.1.0 bevat de ChatReact WordPress-plugin een Smart Sitemap-functie die de ChatReact-crawler gestructureerde contentmetadata rechtstreeks van uw WordPress-site levert.

Hoe het werkt

  1. Genereer een Integration Key op het ChatReact-dashboard (Knowledge Base → Websites → CMS Integrations)
  2. Plak de sleutel in de WordPress-plugininstellingen onder het Integration-tabblad
  3. Selecteer contenttypes die u wilt delen (Pagina's, Berichten, Custom Post Types)
  4. Stel prioriteiten in (High/Medium/Low) per contenttype
  5. Wanneer u uw website crawlt, gebruikt ChatReact automatisch de smart sitemap in plaats van reguliere link-gebaseerde discovery

Voordelen

  • Snellere crawling – Directe URL-lijst in plaats van link-voor-link discovery
  • Bewustzijn van contenttypes – De crawler weet of een URL een Pagina, Bericht of Custom Post Type is
  • Prioriteitsgebaseerde indexering – Belangrijke content (zoals Pagina's) kan hoger worden gewogen dan blogposts
  • Selectief delen – Deel alleen de contenttypes die u wilt
  • Uitsluiting per bericht – Sluit individuele berichten/pagina's uit van de sitemap via het meta-box

Prioriteitsniveaus

PriorityDefault forDescription
HighPagesKernzakelijke content (Over, Diensten, Contact)
MediumPostsBlogartikelen, nieuwsupdates
Low–Aanvullende content

Beveiliging

Het smart sitemap-endpoint (/wp-json/chatreact/v1/sitemap) is beveiligd met de Integration Key. Het is niet zichtbaar voor zoekmachines of andere crawlers — alleen ChatReact kan het bereiken met de juiste sleutel.

Als een beveiligingsplugin de WordPress REST API beperkt tot ingelogde gebruikers, laat versie 1.2.1 en later nog steeds ChatReact-verzoeken met een geldige Integration Key door naar /wp-json/chatreact/v1/ — alle andere REST-routes blijven geblokkeerd. Als een firewall het endpoint blokkeert voordat WordPress is geladen, sta /wp-json/chatreact/v1/ daar toe. Wanneer de smart sitemap niet bereikbaar is, toont de scanvoorvertoning in het ChatReact-dashboard de reden en valt terug op de openbare sitemap, die uw contenttype-selectie negeert.

Individuele berichten uitsluiten

In de WordPress-editor heeft elk bericht/pagina een ChatReact Widget-meta-box met een optie "Exclude from ChatReact Sitemap". Aangevinkte berichten verschijnen niet in de smart sitemap.

Vereisten

  • WordPress 5.8 of hoger
  • PHP 7.4 of hoger
  • Een ChatReact-account (gratis aanmaken)

Changelog

1.2.1

  • FIX: Smart sitemap weer bereikbaar op sites die de REST API beperken tot ingelogde gebruikers — verzoeken met een geldige Integration Key worden doorgelaten, zodat de geselecteerde contenttypes gerespecteerd worden tijdens het scannen

1.2.0

  • NEW: Ingebouwde vertalingen voor alle 24 officiële EU-talen

1.1.3

  • FIX: FAQ-widgets met één categorie tonen niet langer een onnodige "All"-filterknop en categoriebadges

1.1.2

  • NEW: Server-side rendering voor FAQ-widgets — FAQs zijn zichtbaar voor zoekmachines en LLMs zonder JavaScript
  • NEW: JSON-LD gestructureerde data (FAQPage-schema) voor verbeterde SEO en rich results
  • NEW: llms.txt-endpoint voor AI-crawler discoverability
  • NEW: Automatische FAQ-cache-purge wanneer inhoud verandert in het ChatReact-dashboard

1.1.1

  • FIX: Vertaalverbeteringen (Roemeens, Nederlands)

1.1.0

  • NEW: Smart Sitemap (CMS Integration) — gestructureerd contentdelen met ChatReact-crawler
  • NEW: Integration-tabblad in plugininstellingen
  • NEW: Contenttype-selectie met prioriteitsniveaus
  • NEW: Uitzondering per bericht van de sitemap via meta-box
  • NEW: Beschermd REST API-endpoint voor smart sitemap
  • FIX: Volledige compatibiliteit met caching-plugins (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
  • FIX: Problemen met widgetladen voor uitgelogde bezoekers bij caching-plugins

1.0.24

  • Widget Assignments — wijs chatbots toe aan pagina's direct vanuit plugininstellingen
  • Gutenberg-blokken ondersteuning
  • Elementor-integratie
  • 24 taalvertalingen
  • Pagina-niveau widgettoewijzing
  • CHANGED: Widgetinstellingen worden nu centraal beheerd in het ChatReact-dashboard — verwijderd de position, primary_color en auto_open shortcode-attributen (language wordt nog steeds ondersteund)

Volgende stappen