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)
- Gehen Sie in Ihrem WordPress-Admin zu Plugins → Add New
- Suchen Sie nach ChatReact
- Klicken Sie auf Install Now, dann Aktivieren
Methode 2: Upload über WordPress-Admin
- Laden Sie die oben stehende Plugin-ZIP-Datei herunter
- Gehen Sie zu Plugins → Add New → Upload Plugin
- Wählen Sie die ZIP-Datei und klicken Sie auf Install Now
- Klicken Sie auf Activate Plugin
Methode 3: Manueller Upload per FTP
- Entpacken Sie die ZIP-Datei
- Laden Sie den
chatreact-Ordner hoch nach/wp-content/plugins/ - Gehen Sie im WordPress-Admin zu Plugins
- 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
- Melden Sie sich bei chatreact.ai an
- Öffnen Sie Ihren Chatbot und gehen Sie zum Einbetten-Tab
- 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
- Melden Sie sich bei chatreact.ai an
- Gehen Sie zu Formulare
- Klicken Sie Embed-Code kopieren an Ihrem Formular (oder öffnen Sie das Formular und wechseln Sie zum Einbetten-Tab)
- Ihre Formular-ID ist der Wert von
data-form-idim 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:
- Klicken Sie auf +, um einen Block hinzuzufügen
- Suchen Sie nach "ChatReact"
- Wählen Sie ChatReact Chat, ChatReact Form oder ChatReact FAQ
- Geben Sie Ihre ID in den Block-Einstellungen ein
3. Elementor
Wenn Sie Elementor verwenden:
- Bearbeiten Sie Ihre Seite mit Elementor
- Suchen Sie in den Widgets nach "ChatReact"
- Ziehen Sie das Widget auf Ihre Seite
- 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:
- Öffnen Sie das ChatReact-Menü in Ihrer Admin-Seitenleiste
- Auf dem Chat Widget-Tab finden Sie Widget Assignments
- Klicken Sie auf Add Assignment, wählen Sie eine Seite oder einen Beitrag (oder Everywhere) und geben Sie Ihre Chatbot-ID ein
- 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:
- Bearbeiten Sie eine beliebige Seite oder einen Beitrag
- Finden Sie das Meta-Box „ChatReact Widget"
- Aktivieren Sie Enable custom widget for this page
- Geben Sie Ihre Chatbot-ID ein und wählen Sie optional eine Position (Default, Bottom Right, Bottom Left)
- 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
- Überprüfen Sie, ob Ihre Chatbot-ID korrekt ist
- Prüfen Sie, ob der Chatbot in Ihrem ChatReact-Dashboard aktiv ist
- Leeren Sie alle Seiten-Caching-Plugins (siehe unten)
- 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):
- Leeren Sie den Cache Ihres Caching-Plugins
- Schließen Sie
chatreactvon der JS-Minifizierung/-Kombination in den Einstellungen Ihres Caching-Plugins aus - 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
- Generieren Sie einen Integration Key im ChatReact-Dashboard (Knowledge Base → Websites → CMS Integrations)
- Fügen Sie den Key ein in den WordPress-Plugin-Einstellungen unter dem Integration-Tab
- Wählen Sie Inhaltstypen aus, die Sie teilen möchten (Pages, Posts, Custom Post Types)
- Legen Sie Prioritäten fest (High/Medium/Low) pro Inhaltstyp
- 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
| Priority | Default for | Description |
|---|---|---|
| High | Pages | Kerninhalte des Unternehmens (About, Services, Contact) |
| Medium | Posts | Blogartikel, 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_colorundauto_openShortcode-Attribute (languagewird weiterhin unterstützt)