Shopware 5 anbinden
API-Benutzer mit Leserechten, Plugin hochladen, Caches leeren – getestet mit Shopware 5.7.
Getestet mit: Shopware 5.7.19. Das Plugin ist für 5.2 bis 5.7 freigegeben und braucht PHP 7.0 oder neuer.
Shopware 5 hat keine öffentliche Shop-Schnittstelle wie Shopware 6. Der Assistent liest deshalb alles über die REST-API mit einem eigenen Benutzer.
1. API-Benutzer anlegen
- Backend › Einstellungen › Benutzerverwaltung › Reiter Rollen › neue Rolle „KI-Assistent“ mit Leserechten (read) auf: Artikel, Kategorien, Medien, Bestellungen. Keine Schreibrechte.
- Reiter Benutzer › Benutzer hinzufügen: Benutzername z.B.
shoplyra, Rolle „KI-Assistent“. - Haken bei API-Zugang aktiviert setzen. Der API-Schlüssel erscheint – kopieren.
- Im Konto unter Einstellungen › Verbindungen Benutzername und API-Schlüssel eintragen, Verbindung testen.
Wichtig: Die Shop-Adresse muss mit https:// eingetragen sein. Über HTTP würden Zugangsdaten unverschlüsselt übertragen.
2. Script einbinden
Selbst einfügen – im eigenen Theme in frontend/index/index.tpl:
{extends file="parent:frontend/index/index.tpl"}
{block name="frontend_index_after_body"}
{$smarty.block.parent}
<script src="https://…/widget.js" data-site="DEINE-BOT-ID" defer></script>
{/block}
Mit unserem Plugin – setzt nur diese Zeile, sonst nichts.
Plugin herunterladen (ZIP, nach Anmeldung)
- Backend › Einstellungen › Plugin-Manager › Installiert › Plugin hochladen › ZIP wählen.
- Plugin „ShopLyra.de – KI-Chatbot für Onlineshops“ installieren und aktivieren.
- Konfiguration (pro Shop möglich): bei Einbindungscode die Zeile aus deinem Konto einfügen.
- Einstellungen › Caches/Performance › alle Caches leeren und Theme kompilieren.
- Im Konto Einbindung prüfen.
Besonderheiten bei Shopware 5
- Inhaltsseiten (Versand, AGB, FAQ) liest der Assistent über die Sitemap (
/sitemap.xml) und aus den Kategorie-Texten. Stelle sicher, dass die Sitemap erreichbar ist. - Produkte einer Kategorie sucht der Assistent über den Kategorienamen, weil die Shopware-5-API nicht nach Kategorie filtern kann. Die Produktsuche selbst ist davon nicht betroffen.
- Preise werden aus dem Netto-Preis der Kundengruppe EK plus Steuersatz berechnet.
- Bestellauskunft funktioniert auch für Gastbestellungen, weil der Kunde Bestellnummer und E-Mail-Adresse nennt.