WordPress-Chatbot-Plugin
Verwenden Sie das offizielle ChattyBox-WordPress-Plugin, wenn Sie eine Installation ohne Code wünschen, die das gehostete Widget lädt, ohne Theme-Dateien zu bearbeiten. Diese Anleitung behandelt die operative Einrichtung. Die WordPress-KI-Chatbot-Seite erklärt die Content- und Crawl-Strategie, während die WordPress-Plugin-Landingpage einen Überblick über das Produkt gibt.
Vor der Installation
Schließen Sie zuerst den Ablauf Erste Schritte ab: Verbinden Sie Ihre öffentliche WordPress-URL, überprüfen Sie indexierte Seiten und verifizieren Sie repräsentative Antworten in Test Chat. Erstellen Sie anschließend unter Public Keys einen browsersicheren öffentlichen Schlüssel und kopieren Sie ihn aus dem Projekt-Tab Embed.
Plugin installieren
Das Plugin hat keine Abhängigkeit von Composer, npm oder einem Build-Schritt. Es wird derzeit aus dem öffentlichen ChattyBox-GitHub-Repository verteilt, nicht aus dem WordPress.org Plugin Directory. Verwenden Sie daher den WordPress-Ablauf Upload Plugin statt der Verzeichnissuche. Von einem Verzeichnis verwaltete automatische Updates sind noch nicht verfügbar.
Das festgepinnte Paket 0.2.0 deklariert WordPress 5.8+ und PHP 7.4+ und nennt Tests bis WordPress 6.8. Testen Sie die tatsächliche WordPress-/PHP-Version und das Theme; diese Metadaten sind keine Kompatibilitätsgarantie für neuere Releases.
- Laden Sie das an Version 0.2.0 gebundene ChattyBox-WordPress-Plugin-ZIP herunter oder sehen Sie sich das öffentliche Quell-Repository an.
- Öffnen Sie in WordPress Plugins > Add New > Upload Plugin, laden Sie das ZIP hoch und aktivieren Sie ChattyBox AI Chatbot. Für eine manuelle Serverinstallation kopieren Sie zuerst das Plugin-Verzeichnis nach
wp-content/plugins/. - Öffnen Sie Settings > ChattyBox.
- Fügen Sie den öffentlichen Widget-API-Schlüssel aus dem Projekt-Tab Embed ein.
- Aktivieren Sie den Chatbot und speichern Sie die Einstellungen.
Das Plugin speichert den öffentlichen Widget-Schlüssel und die Anzeigeeinstellungen in den WordPress-Optionen. Fügen Sie niemals Verwaltungszugangsdaten von ChattyBox in das Plugin ein.
Laden konfigurieren
Die Produktionsstandards sind:
- Widget-Skript:
https://chattybox.ai/widget.js - API-Endpunkt: automatisch vom Plugin konfiguriert
- Locale-Override: leer; das Widget folgt der Projekt-Policy (standardmäßig Auto)
Im Auto-Modus hat <html lang> Vorrang vor der Browsersprache; der Fixed-Modus verwendet die Projekt-Default-Locale. Der optionale Plugin-Override wird zu data-locale und gewinnt nur bei erlaubtem Script-Override. Header- und Welcome-Text werden nicht übersetzt.
Das Plugin lädt das Widget bei öffentlichen Frontend-Anfragen und überspringt absichtlich wp-admin, Feeds, REST und AJAX. Das ist keine Datenschutzprüfung jeder Frontend-Seite: Schließen Sie Checkout, Konto, Passwort- und Mitgliederseiten ausdrücklich aus. Das Plugin crawlt oder synchronisiert keine Beiträge; Indexierung erfolgt in ChattyBox.
Weitere Routen ausschließen
Verwenden Sie den Filter chattybox_load_widget in einem standortspezifischen Plugin oder einem Child-Theme, wenn eine öffentliche Route das Widget nicht anzeigen soll:
add_filter(
'chattybox_load_widget',
static function ( $should_load ) {
return $should_load && ! is_page( array( 'checkout', 'account' ) );
}
);
Lassen Sie zunächst das Standardverhalten des Plugins aktiviert und fügen Sie dann nur die für Ihre Website erforderlichen Routenausschlüsse hinzu. Testen Sie nach der Änderung des Filters sowohl eine ausgeschlossene Route als auch eine normale öffentliche Seite.
Manueller Skript-Fallback
Verwenden Sie das Plugin als Standardweg. Wenn Ihr WordPress-Team Skripte bereits über ein Theme, ein Child-Theme, ein Skript-Plugin oder Google Tag Manager verwaltet, können Sie das gehostete Widget stattdessen manuell laden:
<script
src="https://chattybox.ai/widget.js"
data-api-key="YOUR_API_KEY"
data-api-url="YOUR_WIDGET_API_URL"
async
></script>
Aktivieren Sie nicht gleichzeitig das Plugin und fügen Sie nicht gleichzeitig dasselbe Widget-Snippet hinzu. Wählen Sie einen Loader, damit Besucher keine doppelten Launcher erhalten.
Installation überprüfen
Nach der Konfiguration des Plugins:
- Öffnen Sie eine öffentliche WordPress-Seite in einem Inkognito-Fenster.
- Bestätigen Sie, dass der Launcher einmal erscheint.
- Stellen Sie eine echte Besucherfrage.
- Prüfen Sie, dass eine unterstützte Antwort indexierte WordPress-Seiten zitiert und eine nicht unterstützte Frage den Fallback zeigt, der keine Quellen haben kann.
- Prüfen Sie die Browserkonsole auf fehlendes
data-api-key,data-api-urloder Schlüssel-Fehler. - Testen Sie eine checkout-, account- oder private Route bei konfiguriertem Ausschluss. Leeren Sie nach Änderungen relevante WordPress-/CDN-Caches; CSS-Ausblenden oder Script-Entfernung ist kein vollständiger UI-Teardown oder Consent-Widerruf.
Arbeiten Sie die Launch-Checkliste ab. Nutzen Sie Logs in jedem Tarif und [Analytics]/Content Gaps nur in Pro/Business.