ChatReact
StartseiteDokumentation

WordPress Plugin

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

Download

ChatReact Plugin v1.1.0 herunterladen

Installation

Methode 1: Upload über WordPress Admin

  1. Laden Sie die Plugin-ZIP-Datei oben 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 2: Manueller Upload per FTP

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

Konfiguration

Nach der Aktivierung gehen Sie zu Einstellungen → ChatReact für Nutzungshinweise.

Ihre Chatbot-ID finden

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

Ihre Formular-ID finden

  1. Melden Sie sich bei chatreact.ai an
  2. Gehen Sie zu Formulare
  3. Wählen Sie Ihr Formular
  4. Kopieren Sie die Formular-ID

Nutzungsmöglichkeiten

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

1. Shortcodes

Fügen Sie zu jeder Seite, jedem Beitrag oder Widget-Bereich hinzu:

Chat-Widget:

[chatreact id="IHRE_CHATBOT_ID"]

Optionale Attribute: position, language, primary_color, auto_open

Kontaktformular:

[chatreact_form id="IHRE_FORMULAR_ID"]

Optionale Attribute: language

FAQ-Akkordeon:

[chatreact_faq id="IHRE_CHATBOT_ID"]

Optionale Attribute: categories, container, language

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 Chat Widget, Form Widget oder FAQ Widget
  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 nach "ChatReact" in den Widgets
  3. Ziehen Sie das Widget auf Ihre Seite
  4. Konfigurieren Sie im linken Panel

4. Seitenbezogene Zuweisung

Weisen Sie Widgets bestimmten Seiten ohne Shortcodes zu:

  1. Bearbeiten Sie eine beliebige Seite oder einen Beitrag
  2. Suchen Sie die "ChatReact Widget" Meta-Box
  3. Wählen Sie einen Widget-Typ
  4. Geben Sie Ihre ID ein
  5. Speichern Sie die Seite

Shortcode-Beispiele

Einfaches Chat-Widget

[chatreact id="abc123"]

Chat-Widget mit Optionen

[chatreact id="abc123" position="bottom-left" language="de" auto_open="true"]

FAQ mit Kategoriefilter

[chatreact_faq id="abc123" categories="versand,retouren"]

Kontaktformular mit Sprache

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

Unterstützte Sprachen

Das Plugin unterstützt 24 EU-Sprachen:

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

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 Caching-Plugins
  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 weiterhin Probleme auftreten (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 JS-Minimierung/-Zusammenfassung in Ihren Caching-Plugin-Einstellungen aus
  3. Das Plugin verwendet data-api-url-Attribute als Fallback, um die korrekte API-Kommunikation sicherzustellen

Styling-Konflikte

Wenn das Widget fehlerhaft aussieht:

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

Mehrere Widgets

Sie können verschiedene Chatbots auf verschiedenen Seiten verwenden, indem Sie eindeutige IDs in jedem Shortcode oder Block 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 Inhalts-Metadaten direkt von Ihrer WordPress-Seite bereitstellt.

So funktioniert es

  1. Integrations-Schlüssel generieren im ChatReact-Dashboard (Wissensdatenbank → Websites → CMS-Integrationen)
  2. Schlüssel einfügen in den WordPress-Plugin-Einstellungen unter dem Tab Integration
  3. Inhaltstypen auswählen, die Sie teilen möchten (Seiten, Beiträge, Benutzerdefinierte Beitragstypen)
  4. Prioritäten festlegen (Hoch/Mittel/Niedrig) pro Inhaltstyp
  5. Beim Crawlen Ihrer Website nutzt ChatReact automatisch die Smart Sitemap statt der normalen Link-basierten Erkennung

Vorteile

  • Schnelleres Crawling – Direkte URL-Liste statt Link-für-Link-Erkennung
  • Inhaltstyp-Erkennung – Der Crawler weiß, ob eine URL eine Seite, ein Beitrag oder ein Custom Post Type ist
  • Prioritätsbasierte Indexierung – Wichtige Inhalte (wie Seiten) können höher gewichtet werden als Blogbeiträge
  • Selektive Freigabe – Teilen Sie nur die Inhaltstypen, die Sie möchten
  • Einzelne Ausschlüsse – Schließen Sie einzelne Beiträge/Seiten über die Meta-Box aus

Prioritätsstufen

PrioritätStandard fürBeschreibung
HochSeitenKern-Geschäftsinhalte (Über uns, Leistungen, Kontakt)
MittelBeiträgeBlog-Artikel, Neuigkeiten
Niedrig–Ergänzende Inhalte

Sicherheit

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

Einzelne Beiträge ausschließen

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

Anforderungen

Änderungsprotokoll

1.1.0

  • NEU: Smart Sitemap (CMS-Integration) — strukturiertes Inhalts-Sharing mit dem ChatReact-Crawler
  • NEU: Integration-Tab in den Plugin-Einstellungen
  • NEU: Inhaltstyp-Auswahl mit Prioritätsstufen
  • NEU: Einzel-Ausschluss von der Sitemap über Meta-Box
  • NEU: Geschützter REST-API-Endpoint für die Smart Sitemap
  • FIX: Volle Kompatibilität mit Caching-Plugins (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
  • FIX: Widget-Ladeprobleme für ausgeloggte Besucher mit Caching-Plugins
  • GEÄNDERT: Widget-Einstellungen werden jetzt zentral im ChatReact-Dashboard verwaltet — Position, Sprache, Primärfarbe und Auto-Öffnen-Einstellungen wurden aus dem Plugin entfernt

1.0.24

  • Gutenberg-Blöcke Unterstützung
  • Elementor-Integration
  • 24 Sprachübersetzungen
  • Seitenbezogene Widget-Zuweisung

Nächste Schritte

Vorherige
Shopify-Integration