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

Installatie

Methode 1: WordPress Plugin Directory (Aanbevolen)

  1. Ga naar Plugins → Nieuwe toevoegen in uw WordPress-beheeromgeving
  2. Zoek naar ChatReact
  3. Klik op Nu installeren, vervolgens 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. Ga naar het Dashboard van uw chatbot
  3. Klik op de Kopieer-knop naast de Chatbot ID (getoond bovenaan)

Uw formulier-ID vinden

  1. Log in op chatreact.ai
  2. Ga naar Forms
  3. Klik op Copy embed code bij uw formulier (of open het formulier en schakel over naar het Embed-tabblad)
  4. Uw Form ID is de waarde van data-form-id in de gekopieerde embed-code

Gebruiksopties

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

1. Shortcodes

Voeg toe aan elke pagina, bericht of widgetgebied:

Chat Widget:

[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 automatisch openen 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 blokeditor:

  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 in de blokinstellingen

3. Elementor

Als u Elementor gebruikt:

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

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 beheerzijbalk
  2. Ga op het tabblad Chat Widget naar Widget Assignments
  3. Klik op Add Assignment, kies een pagina of bericht (of selecteer Everywhere), en voer uw Chatbot ID in
  4. Klik op Save Changes

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 Pages doorzoekbaar bij toewijzen. Klik op de Post Types-knop om andere contenttypes (bijv. Posts 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 vaste taal

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

FAQ met categoriefilter

[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 maken deel uit van de HTML van de pagina 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 is standaard ingeschakeld. Om het uit te schakelen of een specifieke Chatbot ID in te stellen voor het bestand, 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, zodat meertalige sites direct werken — gebruik het language-shortcode-attribuut 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 pagina-cache-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 minificeren 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/combinatie in de instellingen van uw caching-plugin
  3. De plugin gebruikt data-api-url-attributen als fallback om correcte API-communicatie te garanderen

FAQs worden niet bijgewerkt

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

Stijlconflicten

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 ID's in elk shortcode of blok op te geven.

CMS-integratie (Smart Sitemap)

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

Hoe het werkt

  1. Genereer een Integration Key op het ChatReact-dashboard (Knowledge Base → Websites → CMS Integrations)
  2. Plak de key in de WordPress-plugininstellingen onder het tabblad Integration
  3. Selecteer contenttypes die u wilt delen (Pages, Posts, 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 ontdekking

Voordelen

  • Snellere crawling – Directe URL-lijst in plaats van link-voor-link ontdekking
  • Contenttype-bewustzijn – De crawler weet of een URL een Page, Post of Custom Post Type is
  • Prioriteitsgebaseerde indexering – Belangrijke inhoud (zoals Pages) kan hoger worden gewogen dan blogposts
  • Selectief delen – Deel alleen de contenttypes die u wilt
  • Per-post uitsluiting – Sluit individuele posts/pagina's uit van de sitemap via het meta-box

Prioriteitsniveaus

PriorityDefault forDescription
HighPagesKernbedrijf-inhoud (Over, Diensten, Contact)
MediumPostsBlogartikelen, nieuwsupdates
LowAanvullende inhoud

Beveiliging

De 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 er met de juiste key toegang toe krijgen.

Individuele posts uitsluiten

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

Vereisten

  • WordPress 5.8 of hoger
  • PHP 7.4 of hoger
  • Een ChatReact-account (sign up free)

Changelog

1.2.0

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

1.1.3

  • FIX: Single-category FAQ-widgets 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 content verandert in het ChatReact-dashboard

1.1.1

  • FIX: Vertaalverbeteringen (Roemeens, Nederlands)

1.1.0

  • NEW: Smart Sitemap (CMS Integration) — gestructureerd content delen met de ChatReact-crawler
  • NEW: Integration-tabblad in plugininstellingen
  • NEW: Contenttype-selectie met prioriteitsniveaus
  • NEW: Per-post uitsluiting uit sitemap via meta-box
  • NEW: Beveiligde 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 rechtstreeks vanuit plugininstellingen
  • Gutenberg-blokkenondersteuning
  • Elementor-integratie
  • 24 taalvertalingen
  • Pagina-niveau widgettoewijzing
  • CHANGED: Widgetinstellingen worden nu centraal beheerd in het ChatReact-dashboard — de position, primary_color en auto_open shortcode-attributen zijn verwijderd (language wordt nog steeds ondersteund)

Volgende stappen