WordPress Integration

Das Lymbe AI WordPress Plugin: Installation, Konfiguration, Page Filter und Troubleshooting.

Übersicht

Das offizielle Lymbe AI WordPress Plugin bindet das Chat-Widget automatisch auf deiner WordPress-Website ein. Kein manuelles Bearbeiten von Theme-Dateien erforderlich.

Anforderungen

WordPress 5.8 oder höher
PHP 7.4 oder höher
Ein aktives Lymbe AI Konto mit mindestens einem Bot

Installation

Option 1: Über das WordPress-Dashboard

Gehe in deinem WordPress-Admin-Bereich zu Plugins → Installieren
Suche nach „Lymbe AI"
Klicke auf „Jetzt installieren" und dann auf „Aktivieren"
Gehe zu Einstellungen → Lymbe AI
Gib deinen API-Key ein und wähle den Bot aus

Option 2: Manueller Upload

Lade die aktuelle Plugin-Datei (lymbe-ai.zip) von deinem Dashboard herunter
Gehe zu Plugins → Installieren → Plugin hochladen
Wähle die ZIP-Datei aus und klicke auf „Jetzt installieren"
Aktiviere das Plugin

Konfiguration

Nach der Aktivierung findest du die Einstellungen unter Einstellungen → Lymbe AI:

Einstellung	Beschreibung
API-Key	Dein Lymbe AI API-Key (lymbe_sk_...)
Bot auswählen	Wähle den Bot, der auf der Website angezeigt werden soll
Position	Unten rechts oder unten links
Primärfarbe	Akzentfarbe des Widgets (Hex-Wert)
Auf allen Seiten laden	Widget global einbinden (Standard: Ja)
Seiten ausschließen	Kommagetrennte Liste von Seiten-IDs, auf denen das Widget NICHT angezeigt wird
Nur auf Seiten laden	Kommagetrennte Liste von Seiten-IDs, auf denen das Widget NUR angezeigt wird
Verzögerung (ms)	Wartezeit bevor der Button erscheint
Für eingeloggte Benutzer deaktivieren	Widget nur für Besucher anzeigen

Page Filter

Du kannst steuern, auf welchen Seiten das Widget angezeigt wird. Verwende dafür die Felder „Seiten ausschließen" oder „Nur auf Seiten laden" mit den WordPress-Seiten-IDs:

# Seiten ausschließen (Widget wird auf diesen Seiten NICHT geladen)
Seiten ausschließen: 42, 108, 256

# Nur auf bestimmten Seiten laden
Nur auf Seiten laden: 1, 15, 30

Seiten-ID findenDie Seiten-ID findest du in der URL, wenn du eine Seite im WordPress-Editor bearbeitest: wp-admin/post.php?post=42&action=edit → ID ist 42.

Shortcode

Alternativ kannst du den Shortcode [lymbe_chat] verwenden, um das Widget gezielt in bestimmte Seiten oder Beiträge einzubinden:

[lymbe_chat bot_id="DEINE_BOT_ID" position="bottom-right" color="#09CC78"]

Troubleshooting

Widget wird nicht angezeigt

Prüfe, ob der API-Key korrekt eingegeben ist
Stelle sicher, dass der Bot aktiv ist (Status: Aktiv)
Prüfe die Domain-Whitelist im Lymbe AI Dashboard
Prüfe die Browser-Konsole auf JavaScript-Fehler
Deaktiviere vorübergehend Caching-Plugins und teste erneut
Stelle sicher, dass kein Ad-Blocker das Script blockiert

Caching-Probleme

Das Lymbe AI Widget-Script wird mit einem Versions-Parameter geladen, um Caching-Probleme zu vermeiden. Falls du trotzdem veraltete Versionen siehst:

Leere den Cache deines Caching-Plugins (WP Super Cache, W3 Total Cache, etc.)
Leere den CDN-Cache (Cloudflare, etc.)
Führe einen Hard-Refresh im Browser durch (Ctrl+Shift+R)

Plugin-Konflikte

In seltenen Fällen können andere Plugins das Widget beeinträchtigen. Bekannte Konflikte:

Plugin	Problem	Lösung
Autoptimize	Script wird zusammengefasst und bricht	Lymbe-Script von Optimierung ausschließen
WP Rocket	Lazy-Load verhindert Laden	Script unter Ausnahmen hinzufügen: app.lymbe.ai
Elementor	z-index Konflikt	z-index über data-z-index Attribut anpassen

VorherigeÜbersicht NächsteShopify