Joomla Integration
Das Lymbe AI Joomla Plugin: Installation, Konfiguration und Page Filter per Itemid.
Übersicht
Das Lymbe AI Plugin für Joomla integriert das Chat-Widget in deine Joomla-Website. Es unterstützt Joomla 3.x und 4.x und bietet umfangreiche Konfigurationsmöglichkeiten.
Anforderungen
- Joomla 3.10+ oder Joomla 4.x / 5.x
- PHP 7.4 oder höher
- Ein aktives Lymbe AI Konto
Installation
- Lade die Plugin-Datei (plg_lymbeai.zip) aus deinem Lymbe AI Dashboard herunter
- Gehe im Joomla-Backend zu System → Installieren → Erweiterungen
- Lade die ZIP-Datei hoch und klicke auf „Installieren"
- Gehe zu System → Plugins und suche nach „Lymbe AI"
- Aktiviere das Plugin und öffne die Einstellungen
Plugin-Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| API-Key | Text | - | Dein Lymbe AI API-Key |
| Bot-ID | Text | - | Die Bot-ID aus deinem Dashboard |
| Position | Dropdown | bottom-right | Widget-Position |
| Primärfarbe | Color Picker | #09CC78 | Akzentfarbe |
| Verzögerung | Number | 0 | Anzeigeverzögerung in ms |
| Seiten-Filter | Dropdown | Alle Seiten | alle / nur ausgewählte / ausschließen |
| Itemid-Liste | Text | - | Kommagetrennte Menüpunkt-IDs |
| Sprache | Dropdown | de | Widget-Sprache |
Page Filter per Itemid
In Joomla werden Seiten über Menüpunkte (Items) gesteuert. Jeder Menüpunkt hat eine eindeutige Itemid. Du kannst das Widget auf bestimmte Menüpunkte beschränken:
# Widget nur auf bestimmten Seiten anzeigen
Seiten-Filter: Nur ausgewählte Seiten
Itemid-Liste: 101, 105, 120
# Widget auf bestimmten Seiten ausblenden
Seiten-Filter: Seiten ausschließen
Itemid-Liste: 110, 115Itemid findenDie Itemid findest du in Joomla unter Menüs → [Dein Menü]. In der Spalte „ID" siehst du die Itemid jedes Menüpunkts.
Mehrsprachige Websites
Für mehrsprachige Joomla-Websites kannst du pro Sprache einen eigenen Bot zuweisen. Erstelle dazu einen Sprachoverride oder nutze die Plugin-Parameter in Kombination mit dem Joomla-Sprachfilter:
override.phpphp
// In einem Joomla System Plugin oder Template-Override
$lang = JFactory::getLanguage()->getTag();
$botIds = [
'de-DE' => 'bot-id-deutsch',
'en-GB' => 'bot-id-english',
'fr-FR' => 'bot-id-francais',
];
$botId = $botIds[$lang] ?? $botIds['de-DE'];Troubleshooting
- Plugin-Reihenfolge – Stelle sicher, dass das Lymbe AI Plugin nach dem Joomla System-Core-Plugin geladen wird
- Cache leeren – Gehe zu System → Cache leeren nach Konfigurationsänderungen
- Template-Konflikte – Prüfe, ob dein Template das