StartseiteDokumentation

WordPress Plugin

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

Download

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

Download ChatReact Plugin v1.2.0

Installation

Methode 1: WordPress Plugin-Verzeichnis (Empfohlen)

  1. Gehen Sie in Ihrem WordPress-Admin zu Plugins → Installieren
  2. Suchen Sie nach ChatReact
  3. Klicken Sie auf Jetzt installieren, dann auf Aktivieren

Methode 2: Upload über WordPress-Admin

  1. Laden Sie die obenstehende Plugin-ZIP-Datei herunter
  2. Gehen Sie zu Plugins → Installieren → Plugin hochladen
  3. Wählen Sie die ZIP-Datei und klicken Sie auf Jetzt installieren
  4. Klicken Sie auf Plugin aktivieren

Methode 3: Manueller Upload per FTP

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

Konfiguration

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

So finden Sie Ihre Chatbot-ID

  1. Melden Sie sich bei chatreact.ai an
  2. Gehen Sie zum Dashboard Ihres Chatbots
  3. Klicken Sie auf die Kopieren-Schaltfläche neben der Chatbot-ID (oben angezeigt)

So finden Sie Ihre Formular-ID

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

Verwendungsoptionen

Das Plugin bietet mehrere Möglichkeiten, ChatReact zu Ihrer Seite hinzuzufügen:

1. Shortcodes

Fügen Sie es in jede Seite, jeden Beitrag oder Widget-Bereich ein:

Chat Widget:

[chatreact id="YOUR_CHATBOT_ID"]

Optionale Attribute: language

Kontaktformular:

[chatreact_form id="YOUR_FORM_ID"]

Optionale Attribute: language

FAQ Accordion:

[chatreact_faq id="YOUR_CHATBOT_ID"]

Optionale Attribute: categories, container, language

Visuelle Einstellungen wie Position, Farben und Auto-Open 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 bei 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 im linken Bedienfeld

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. Wechseln Sie zum Tab Chat Widget und 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 auf Save Changes

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 bei der Zuweisung nur Seiten durchsuchbar. Klicken Sie auf die Post Types-Schaltfläche, um andere Inhaltstypen (z. B. Beiträge oder benutzerdefinierte Beitragstypen) ebenfalls durchsuchbar zu machen.

5. Seitenweite Zuweisung

Weisen Sie einen Chatbot direkt auf einer einzelnen Seite aus dem Editor zu:

  1. Bearbeiten Sie eine beliebige Seite oder einen Beitrag
  2. Finden Sie die 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 die Option Disable all widgets on this page, wenn Sie ChatReact auf bestimmten Seiten vollständig ausblenden möchten.

Shortcode-Beispiele

Einfaches Chat Widget

[chatreact id="abc123"]

Chat Widget mit fester Sprache

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

FAQ mit Kategorie-Filter

[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 strukturierte Daten (FAQPage-Schema). Suchmaschinen und AI-Assistenten können sie lesen, ohne JavaScript auszuführen.

llms.txt für AI-Crawler

Das Plugin kann Ihre FAQ-Inhalte unter yoursite.com/llms.txt bereitstellen, einer Entdeckungsdatei, die von AI-Crawlern gelesen wird. Sie ist standardmäßig aktiviert. Um sie zu toggeln 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 festlegen — 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 außerdem automatisch geleert, whenever Ihre FAQs im ChatReact-Dashboard geändert werden.

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 Websites sofort funktionieren — verwenden Sie das language-Shortcode-Attribut nur, wenn Sie eine bestimmte Sprache erzwingen möchten.

Fehlerbehebung

Widget erscheint nicht

  1. Prüfen Sie, ob Ihre Chatbot-ID korrekt ist
  2. Überprü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 vollständig kompatibel mit beliebten 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 die korrekte API-Kommunikation sicherzustellen

FAQs werden nicht aktualisiert

Wenn Ihre Website 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 beschädigt aussieht:

  • Das Widget verwendet isoliertes CSS
  • Prüfen Sie auf CSS-!important-Regeln in Ihrem Theme
  • Versuchen Sie, andere Chat-Plugins vorübergehend zu deaktivieren

Mehrere Widgets

Sie können auf verschiedenen Seiten unterschiedliche Chatbots verwenden, indem Sie in jedem Shortcode oder Block eindeutige IDs angeben.

CMS-Integration (Smart Sitemap)

Ab Version 1.1.0 enthält das ChatReact WordPress-Plugin eine Smart Sitemap-Funktion, die dem ChatReact-Crawler strukturierte Inhaltsmetadaten direkt von Ihrer WordPress-Website zur Verfügung stellt.

Wie es funktioniert

  1. Generieren Sie einen Integration Key im ChatReact-Dashboard (Knowledge Base → Websites → CMS Integrations)
  2. Fügen Sie den Key ein in den Plugin-Einstellungen unter dem Tab Integration
  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 statt der regulären Link-basierten Entdeckung

Vorteile

  • Schnelleres Crawlen – Direkte URL-Liste statt Link-für-Link-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 (wie Pages) können höher gewichtet werden als Blogbeiträge
  • Selektives Teilen – Teilen Sie nur die Inhaltstypen, die Sie möchten
  • Pro-Post-Ausschluss – Schließen Sie einzelne Beiträge/Seiten über die Meta-Box vom Sitemap-Sharing aus

Prioritätsstufen

PriorityDefault forDescription
HighPagesKerninhalte des Unternehmens (Über, Leistungen, Kontakt)
MediumPostsBlogartikel, Nachrichten-Updates
LowErgä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 richtigen Key darauf zugreifen.

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". Aktivierte 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.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 Kategorie-Badges an

1.1.2

  • NEW: Server-side Rendering für FAQ-Widgets — FAQs sind für Suchmaschinen und LLMs ohne JavaScript sichtbar
  • NEW: JSON-LD strukturierte Daten (FAQPage-Schema) für verbessertes SEO und Rich Results
  • NEW: llms.txt-Endpunkt für die Auffindbarkeit durch AI-Crawler
  • NEW: Automatische FAQ-Cache-Bereinigung, 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) — strukturiertes Teilen von Inhalten mit dem ChatReact-Crawler
  • NEW: Integration-Tab in den Plugin-Einstellungen
  • NEW: Auswahl von Inhaltstypen mit Prioritätsstufen
  • NEW: Pro-Post-Ausschluss vom Sitemap 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: Probleme beim Laden des Widgets für ausgeloggte Besucher mit Caching-Plugins

1.0.24

  • Widget Assignments — Chatbots direkt aus den Plugin-Einstellungen Seiten zuweisen
  • Gutenberg-Blöcke Unterstützung
  • Elementor-Integration
  • 24 Sprachübersetzungen
  • Seitenbezogene Widget-Zuweisung
  • CHANGED: Widget-Einstellungen werden jetzt zentral im ChatReact-Dashboard verwaltet — die Shortcode-Attribute position, primary_color und auto_open wurden entfernt (language wird weiterhin unterstützt)

Nächste Schritte