Installation – KI-Produktoptimierung¶
Voraussetzungen¶
| Punkt | Anforderung |
|---|---|
| Shopware-Version | 6.5.x, 6.6.x oder 6.7.x |
| PHP | ≥ 8.1 |
| Internet-Zugang | benötigt (Verbindung zu Kommora-Cloud-Backend) |
| Kommora-Account | kostenlos einrichtbar während der Installation |
Variante A: Über den Shopware Store¶
- Erweiterungen → Im Store → „Kommora KI" suchen
- Kostenlos – Plan auswählen und installieren
- Erweiterungen → Meine Erweiterungen → installieren und aktivieren
- Beim ersten Öffnen des Moduls wird nach den Account-Daten gefragt – siehe Account & Verbindung
Variante B: ZIP-Upload¶
cd /var/www/shopware/custom/plugins
unzip /pfad/zu/KommoraConnector-1.x.x.zip
cd /var/www/shopware
php bin/console plugin:refresh
php bin/console plugin:install --activate KommoraConnector
php bin/console cache:clear
Nach der Installation¶
- Im Admin Kommora → Account öffnen
- Wenn Du noch keinen Kommora-Account hast: „Neuen Account erstellen" – Mail-Adresse + Passwort, fertig
- Wenn Du bereits einen Account hast (z.B. weil Du andere Kommora-Plugins gekauft hast): „Einloggen"
- Domain-Verifikation: Plugin prüft automatisch, dass die aktive Shopware-Domain dem Account zugeordnet ist
- Status grün → loslegen
Deinstallation¶
Mit Datenerhalt¶
Plugin deaktivieren und entfernen. Die Account-Connection-Daten und API-Keys bleiben verschlüsselt in system_config.
Mit kompletter Datenlöschung¶
Beim Deinstallieren das Häkchen „Daten löschen" setzen:
- Account-Connection wird getrennt
- Lokale Caches (Statistiken, SEO-Audits, KI-Vorschlags-Historie) werden gelöscht
- Einträge in
system_configwerden entfernt
Konfiguration prüfen¶
Im Admin Kommora → Account → Status:
| Status | Bedeutung |
|---|---|
| Verbunden ✓ | Alles OK |
| Verbunden, Domain nicht verifiziert ⚠️ | Account exists, aber diese Domain ist nicht zugeordnet – nachholen über „Domain zum Account hinzufügen" |
| Nicht verbunden ✗ | Login-Daten falsch oder Internet-Verbindung gebrochen |
| Limit erreicht ⚠️ | Tageslimit der Free-Stufe erreicht – mehr Limits über Premium-Plugins |
Scheduled Tasks¶
| Task | Frequenz | Wirkung |
|---|---|---|
kommora.connector.sync_stats |
täglich 04:00 | synchronisiert aggregierte Statistik-Daten mit dem Backend |
kommora.connector.refresh_token |
alle 6 Stunden | refresht den OAuth-Token bevor er abläuft |
kommora.connector.cleanup_cache |
wöchentlich (sonntags 04:30) | räumt veraltete KI-Vorschlags-Caches auf |
→ Weiter mit Account & Verbindung.