StartseiteDokumentation

WordPress Plugin

Fügen Sie ChatReact AI-Chatbots, Kontaktformulare und FAQ-Akkordeons zu Ihrer WordPress-Seite mit unserem offiziellen Plugin hinzu.

Download

Das Plugin ist im offiziellen WordPress Plugin Directory verfügbar oder als Direktdownload:

Download ChatReact Plugin v1.2.1

Installation

Methode 1: WordPress Plugin-Verzeichnis (Empfohlen)

  1. Gehen Sie in Ihrem WordPress-Admin zu Plugins → Add New
  2. Suchen Sie nach ChatReact
  3. Klicken Sie auf Install Now, dann Aktivieren

Methode 2: Upload über WordPress-Admin

  1. Laden Sie die oben stehende Plugin-ZIP-Datei herunter
  2. Gehen Sie zu Plugins → Add New → Upload Plugin
  3. Wählen Sie die ZIP-Datei und klicken Sie auf Install Now
  4. Klicken Sie auf Activate Plugin

Methode 3: Manueller Upload per FTP

  1. Entpacken Sie die ZIP-Datei
  2. Laden Sie den chatreact-Ordner hoch nach /wp-content/plugins/
  3. Gehen Sie im WordPress-Admin zu Plugins
  4. Finden Sie "ChatReact" und klicken Sie Aktivieren

Konfiguration

Nach der Aktivierung öffnen Sie das ChatReact-Menü in Ihrer WordPress-Admin-Seitenleiste für Einstellungen und Nutzungshinweise.

So finden Sie Ihre Chatbot-ID

  1. Melden Sie sich bei chatreact.ai an
  2. Öffnen Sie Ihren Chatbot und gehen Sie zum Einbetten-Tab
  3. Klicken Sie Code kopieren, um das Einbettungs-Snippet zu kopieren, oder lesen Sie die ID vom data-chatbot-id-Attribut im kopierten Code

So finden Sie Ihre Formular-ID

  1. Melden Sie sich bei chatreact.ai an
  2. Gehen Sie zu Formulare
  3. Klicken Sie Embed-Code kopieren an Ihrem Formular (oder öffnen Sie das Formular und wechseln Sie zum Einbetten-Tab)
  4. Ihre Formular-ID ist der Wert von data-form-id im kopierten Embed-Code

Verwendungsoptionen

Das Plugin bietet mehrere Möglichkeiten, ChatReact auf Ihrer Seite einzufügen:

1. Shortcodes

Fügen Sie es auf jeder Seite, in jedem Beitrag oder Widget-Bereich hinzu:

Chat-Widget:

[chatreact id="YOUR_CHATBOT_ID"]

Optionale Attribute: language

Kontaktformular:

[chatreact_form id="YOUR_FORM_ID"]

Optionale Attribute: language

FAQ-Akkordeon:

[chatreact_faq id="YOUR_CHATBOT_ID"]

Optionale Attribute: categories, container, language

Visuelle Einstellungen wie Position, Farben und Automatisches Öffnen werden zentral in Ihrem ChatReact-Dashboard verwaltet und gelten automatisch für Ihre WordPress-Seite. Das language-Attribut ist bei allen Shortcodes optional — wenn Sie es weglassen, wird die Sprache der aktuellen Seite automatisch erkannt (funktioniert mit mehrsprachigen Seiten).

2. Gutenberg-Blöcke

Im Block-Editor:

  1. Klicken Sie auf +, um einen Block hinzuzufügen
  2. Suchen Sie nach "ChatReact"
  3. Wählen Sie ChatReact Chat, ChatReact Form oder ChatReact FAQ
  4. Geben Sie Ihre ID in den Block-Einstellungen ein

3. Elementor

Wenn Sie Elementor verwenden:

  1. Bearbeiten Sie Ihre Seite mit Elementor
  2. Suchen Sie in den Widgets nach "ChatReact"
  3. Ziehen Sie das Widget auf Ihre Seite
  4. Konfigurieren Sie es im linken Panel

4. Widget-Zuweisungen (Plugin-Einstellungen)

Zeigen Sie einen Chatbot auf bestimmten Seiten — oder auf der gesamten Website — ohne Inhalte zu bearbeiten:

  1. Öffnen Sie das ChatReact-Menü in Ihrer Admin-Seitenleiste
  2. Auf dem Chat Widget-Tab finden Sie Widget Assignments
  3. Klicken Sie auf Add Assignment, wählen Sie eine Seite oder einen Beitrag (oder Everywhere) und geben Sie Ihre Chatbot-ID ein
  4. Klicken Sie Änderungen speichern

Für Everywhere-Zuweisungen können Sie bestimmte URLs ausschließen — eine pro Zeile, mit Wildcard-Unterstützung (z. B. /blog/* oder /checkout) — um das Widget auf Landingpages oder während des Checkouts auszublenden.

Standardmäßig sind beim Zuweisen nur Seiten durchsuchbar. Klicken Sie auf die Post Types-Schaltfläche, um andere Inhaltstypen (z. B. Posts oder benutzerdefinierte Beitragstypen) ebenfalls durchsuchbar zu machen.

5. Seitenbasierte Zuweisung

Weisen Sie einen Chatbot einer einzelnen Seite direkt im Editor zu:

  1. Bearbeiten Sie eine beliebige Seite oder einen Beitrag
  2. Finden Sie das Meta-Box „ChatReact Widget"
  3. Aktivieren Sie Enable custom widget for this page
  4. Geben Sie Ihre Chatbot-ID ein und wählen Sie optional eine Position (Default, Bottom Right, Bottom Left)
  5. Speichern Sie die Seite

Die gleiche Meta-Box bietet auch eine Option Disable all widgets on this page, falls Sie ChatReact auf bestimmten Seiten vollständig ausblenden möchten.

Shortcode-Beispiele

Einfaches Chat-Widget

[chatreact id="abc123"]

Chat-Widget mit festgelegter Sprache

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

FAQ mit Kategorienfilter

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

Gestyltes Kontaktformular

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

FAQ-Widget: SEO & Caching

SEO-freundliche FAQs

Seit Version 1.1.2 werden FAQ-Widgets serverseitig gerendert: Ihre FAQs sind Teil des Seiten-HTML und enthalten JSON-LD-Strukturdaten (FAQPage-Schema). Suchmaschinen und KI-Assistenten können sie lesen, ohne JavaScript auszuführen.

llms.txt für KI-Crawler

Das Plugin kann Ihre FAQ-Inhalte unter yoursite.com/llms.txt bereitstellen, einer Discovery-Datei, die von KI-Crawlern gelesen wird. Sie ist standardmäßig aktiviert. Um sie zu aktivieren/deaktivieren oder eine bestimmte Chatbot-ID für die Datei festzulegen, gehen Sie zu ChatReact → FAQ Widget → Cache & SEO Settings.

FAQ-Caching

FAQ-Daten werden auf Ihrem Server zwischengespeichert, um schnelle Seitenladezeiten zu gewährleisten. Unter ChatReact → FAQ Widget → Cache & SEO Settings können Sie:

  • Die Cache Duration einstellen — 1, 3, 6 (empfohlen), 12 oder 24 Stunden oder das Caching deaktivieren
  • Auf Clear Cache klicken, um Ihre FAQs sofort zu aktualisieren

Der Cache wird auch automatisch geleert, wann immer sich Ihre FAQs im ChatReact-Dashboard ändern.

Unterstützte Sprachen

Das Plugin unterstützt 24 EU-Sprachen:

  • Bulgarisch, Kroatisch, Tschechisch, Dänisch, Niederländisch, Englisch
  • Estnisch, Finnisch, Französisch, Deutsch, Griechisch, Ungarisch
  • Irisch, Italienisch, Lettisch, Litauisch, Maltesisch, Polnisch
  • Portugiesisch, Rumänisch, Slowakisch, Slowenisch, Spanisch, Schwedisch

Seit Version 1.2.0 sind Übersetzungen für alle 24 Sprachen im Plugin enthalten. Die Widget-Sprache wird automatisch von der aktuellen Seite erkannt, sodass mehrsprachige Seiten sofort funktionieren — verwenden Sie das language-Shortcode-Attribut nur, wenn Sie eine bestimmte Sprache erzwingen möchten.

Fehlerbehebung

Widget erscheint nicht

  1. Überprüfen Sie, ob Ihre Chatbot-ID korrekt ist
  2. Prüfen Sie, ob der Chatbot in Ihrem ChatReact-Dashboard aktiv ist
  3. Leeren Sie alle Seiten-Caching-Plugins (siehe unten)
  4. Prüfen Sie die Browser-Konsole auf JavaScript-Fehler

Kompatibilität mit Caching-Plugins

Das Plugin ist voll kompatibel mit gängigen Caching- und Optimierungs-Plugins wie WP Rocket, LiteSpeed Cache, Autoptimize und WP Super Cache. Das Plugin verhindert automatisch, dass diese Tools ChatReact-Skripte minimieren oder cachen.

Wenn Sie weiterhin Probleme haben (z. B. 404-Fehler, Widget lädt nicht für ausgeloggte Besucher):

  1. Leeren Sie den Cache Ihres Caching-Plugins
  2. Schließen Sie chatreact von der JS-Minifizierung/-Kombination in den Einstellungen Ihres Caching-Plugins aus
  3. Das Plugin verwendet data-api-url-Attribute als Fallback, um eine korrekte API-Kommunikation sicherzustellen

FAQs werden nicht aktualisiert

Wenn Ihre Seite veraltete FAQs anzeigt, gehen Sie zu ChatReact → FAQ Widget und klicken Sie auf Clear Cache. Der Cache wird auch automatisch geleert, wenn Sie Ihre FAQs im ChatReact-Dashboard bearbeiten.

Styling-Konflikte

Wenn das Widget defekt aussieht:

  • Das Widget verwendet isoliertes CSS
  • Prüfen Sie Ihr Theme auf CSS-!important-Regeln
  • Versuchen Sie, andere Chat-Plugins temporär zu deaktivieren

Mehrere Widgets

Sie können auf verschiedenen Seiten unterschiedliche Chatbots verwenden, indem Sie für jeden Shortcode oder Block eindeutige IDs angeben.

CMS-Integration (Smart Sitemap)

Beginnend mit Version 1.1.0 enthält das ChatReact WordPress-Plugin eine Smart Sitemap-Funktion, die dem ChatReact-Crawler strukturierte Inhalts-Metadaten direkt von Ihrer WordPress-Seite bereitstellt.

So funktioniert es

  1. Generieren Sie einen Integration Key im ChatReact-Dashboard (Knowledge Base → Websites → CMS Integrations)
  2. Fügen Sie den Key ein in den WordPress-Plugin-Einstellungen unter dem Integration-Tab
  3. Wählen Sie Inhaltstypen aus, die Sie teilen möchten (Pages, Posts, Custom Post Types)
  4. Legen Sie Prioritäten fest (High/Medium/Low) pro Inhaltstyp
  5. Beim Crawlen Ihrer Website verwendet ChatReact automatisch die Smart Sitemap anstelle der normalen Link-basierten Discovery

Vorteile

  • Schnelleres Crawlen – Direkte URL-Liste statt linkweiser Entdeckung
  • Bewusstsein für Inhaltstypen – Der Crawler weiß, ob eine URL eine Page, ein Post oder ein Custom Post Type ist
  • Prioritätsbasierte Indexierung – Wichtige Inhalte (z. B. Pages) können höher gewichtet werden als Blogbeiträge
  • Selektives Teilen – Teilen Sie nur die Inhaltstypen, die Sie möchten
  • Ausschluss pro Beitrag – Schließen Sie einzelne Beiträge/Seiten über die Meta-Box vom Sitemap-Export aus

Prioritätsstufen

PriorityDefault forDescription
HighPagesKerninhalte des Unternehmens (About, Services, Contact)
MediumPostsBlogartikel, Neuigkeiten
Low–Ergänzende Inhalte

Sicherheit

Der Smart-Sitemap-Endpunkt (/wp-json/chatreact/v1/sitemap) ist durch den Integration Key geschützt. Er ist für Suchmaschinen oder andere Crawler nicht sichtbar — nur ChatReact kann mit dem korrekten Key darauf zugreifen.

Wenn ein Sicherheits-Plugin die WordPress REST API auf eingeloggte Benutzer beschränkt, lassen Version 1.2.1 und neuer ChatReact-Anfragen mit einem gültigen Integration Key weiterhin zu /wp-json/chatreact/v1/ durch — alle anderen REST-Routen bleiben blockiert. Wenn eine Firewall den Endpunkt blockiert, bevor WordPress geladen wird, erlauben Sie /wp-json/chatreact/v1/ dort. Wann immer die Smart Sitemap nicht erreichbar ist, zeigt die Scan-Vorschau im ChatReact-Dashboard den Grund an und greift auf die öffentliche Sitemap zurück, die Ihre Auswahl der Inhaltstypen ignoriert.

Einzelne Beiträge ausschließen

Im WordPress-Editor hat jeder Beitrag/jede Seite eine ChatReact Widget-Meta-Box mit einer Option "Exclude from ChatReact Sitemap". Markierte Beiträge erscheinen nicht in der Smart Sitemap.

Anforderungen

  • WordPress 5.8 oder höher
  • PHP 7.4 oder höher
  • Ein ChatReact-Konto (sign up free)

Changelog

1.2.1

  • FIX: Smart Sitemap wieder erreichbar auf Seiten, die die REST API auf eingeloggte Benutzer beschränken — Anfragen mit gültigem Integration Key werden durchgelassen, sodass die ausgewählten Inhaltstypen beim Scannen respektiert werden

1.2.0

  • NEW: Gebündelte Übersetzungen für alle 24 offiziellen EU-Sprachen

1.1.3

  • FIX: FAQ-Widgets mit nur einer Kategorie zeigen nicht mehr unnötig eine "All"-Filter-Schaltfläche und Kategorien-Badges an

1.1.2

  • NEW: Serverseitiges Rendering für FAQ-Widgets — FAQs sind für Suchmaschinen und LLMs ohne JavaScript sichtbar
  • NEW: JSON-LD-Strukturdaten (FAQPage-Schema) für verbessertes SEO und Rich Results
  • NEW: llms.txt-Endpunkt für die Auffindbarkeit durch KI-Crawler
  • NEW: Automatische FAQ-Cache-Löschung, wenn Inhalte im ChatReact-Dashboard geändert werden

1.1.1

  • FIX: Verbesserungen bei Übersetzungen (Rumänisch, Niederländisch)

1.1.0

  • NEW: Smart Sitemap (CMS Integration) — strukturierter Inhaltsaustausch mit dem ChatReact-Crawler
  • NEW: Integration-Tab in den Plugin-Einstellungen
  • NEW: Auswahl der Inhaltstypen mit Prioritätsstufen
  • NEW: Ausschluss pro Beitrag vom Sitemap-Export via Meta-Box
  • NEW: Geschützter REST API-Endpunkt für die Smart Sitemap
  • FIX: Volle Kompatibilität mit Caching-Plugins (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
  • FIX: Ladeprobleme von Widgets für ausgeloggte Besucher in Verbindung mit Caching-Plugins

1.0.24

  • Widget-Zuweisungen — Weisen Sie Chatbots direkt in den Plugin-Einstellungen Seiten zu
  • Gutenberg-Block-Unterstützung
  • Elementor-Integration
  • 24 Sprachübersetzungen
  • Seitenbasierte Widget-Zuweisung
  • CHANGED: Widget-Einstellungen werden jetzt zentral im ChatReact-Dashboard verwaltet — entfernt die position, primary_color und auto_open Shortcode-Attribute (language wird weiterhin unterstützt)

Nächste Schritte