Vom ersten Block bis zum Sonderfall: Positionen kennen, Inhalt mit Twig und KI erzeugen, Sichtbarkeit steuern - und wissen, was zu tun ist, wenn ein Theme sich querstellt.
Shopware 6.7 mit Storefront, PHP 8.2 oder neuer. Für die KI-Erzeugung brauchst du einen eigenen API-Schlüssel bei OpenAI, Anthropic, Google oder Mistral; abgerechnet wird direkt dort.
ZIP im Admin unter Erweiterungen hochladen, installieren, aktivieren. Danach den Lizenzschlüssel im Lizenzbildschirm eintragen. Das Modul ist über die Plugin Suite und zusätzlich unter Einstellungen erreichbar.
Der Block erscheint sofort im Shop. Ein Leeren des Caches ist in der Regel nicht nötig.
Die 52 Positionen sind nach Bereichen gruppiert. Zuerst wählst du den Bereich, dann die Position darin - das hält die Liste überschaubar.
Neben Verkaufskanal, Gerät und Zeitfenster lässt sich ein Block auf einzelne Seitenarten einschränken. Ohne Auswahl erscheint er weiterhin überall, sonst nur auf den gewählten.
Jeder Block trägt drei Felder: den Inhalt, eigenes CSS und optional eigenes JavaScript. Alles hängt am Block - wird er gelöscht, verschwindet auch das Beiwerk.
In allen drei Feldern lassen sich Twig-Ausdrücke und Shopware-Variablen verwenden. An jeder Position stehen bereit: das Produkt (auf der Detailseite), der Kontext, der Verkaufskanal, die Währung und der Kunde.
{{ product.name }} im Inhalt setzt den Artikelnamen ein, {{ context.currency.symbol }} das Währungszeichen. Damit lässt sich ein Hinweis formulieren, der den Namen des betrachteten Artikels nennt.Der Inhalt liegt je Sprache vor. Ein Block kann im deutschen Kanal anders lauten als im englischen, ohne dass du zwei Blöcke pflegen musst.
Im Blockfenster beschreibst du in einem Satz, was der Block zeigen soll. Ein Knopf genügt, und die KI liefert Inhalt, CSS und JavaScript zusammen.
Der Auftrag wird am Block gespeichert und beim nächsten Öffnen wieder angezeigt. So lässt sich nachschärfen, statt jedes Mal neu zu formulieren.
Bilder als Vorlage: Bis zu vier Bilder lassen sich mitgeben - ein Entwurf, ein Bildschirmfoto der gewünschten Optik oder ein Beispiel von einer anderen Seite. Die KI baut den Block daraus nach.Normalerweise wird der Block beim Aufbau der Seite direkt an seiner Position eingesetzt. Das ist der saubere Weg und die Vorgabe.
Manche Themes ersetzen dieselben Twig-Blöcke, die auch dieses Plugin nutzt. Dann käme der Inhalt nicht an. Für diesen Fall gibt es eine zweite Ausgabeart, die den Block per Skript an die richtige Stelle setzt.
Die Blockliste lässt sich nach Bereich filtern und zeigt 25 Einträge je Seite. Über die Mehrfachauswahl lassen sich Blöcke gemeinsam aktivieren, deaktivieren oder löschen.
Deaktivieren nimmt den Block aus dem Shop, ohne ihn zu verlieren - sinnvoll für Aktionen, die später wiederkommen.
Fragen und Wünsche gern direkt an uns - der Support kommt vom Entwickler, nicht aus einer Warteschleife. Über die Plugin Suite im Admin lässt sich zusätzlich ein Feature anfragen.
Jede Einstellung des Plugins mit Standardwert und Erklärung, in derselben Reihenfolge wie im Administrationsbereich. Die Texte stammen direkt aus dem Plugin (Version 1.33.1).
Legt fest, für welchen Verkaufskanal die Einstellungen gelten. Ohne Auswahl gelten sie für alle.
Alle weiteren Einstellungen auf dieser Seite gelten für den hier gewählten Kanal.
Bestimmt, auf welchem Weg die Blöcke in die Seite gelangen.
Über die Vorlagen ist der Standard. Ersetzt ein Theme dieselben Twig-Blöcke, kann die Ausgabe per Skript helfen.
Hinterlege hier Anbieter, Schlüssel und Modell. Ist kein Schlüssel gesetzt, greift das Plugin auf die Zugangsdaten des KI Produktberaters zurück.
Welches Haus das Sprachmodell stellt. Die Auswahl bestimmt, welche Modelle zur Verfügung stehen.
Der Zugangsschlüssel des Anbieters. Er wird verschlüsselt gespeichert und nie im Storefront ausgegeben.
Das verwendete Sprachmodell. Kleinere Modelle antworten schneller, größere schreiben sorgfältiger.
Sendet eine kurze Anfrage an den Anbieter und meldet, ob Zugang und Modell stimmen.
Sichert alle Blöcke als Datei und liest sie in einem anderen Shop wieder ein.
Beim Einlesen werden die Blöcke neu angelegt, vorhandene bleiben unverändert bestehen.
Ein Block ohne Verkaufskanal gilt in allen Shops. Ein Block mit Verkaufskanal ersetzt an derselben Position den allgemeinen Block. Zusatzfelder am Artikel gibt es nur für Blöcke der Detailseite.
Interner Name des Blocks für die Übersicht. Er dient nur der Orientierung in der Blockliste.
Ein Block ohne Verkaufskanal gilt in allen Shops. Ein Block mit Verkaufskanal ersetzt an derselben Position den allgemeinen Block. Zusatzfelder am Artikel gibt es nur für Blöcke der Detailseite.
Der Bereich der Seite, in dem der Block erscheint: freie Position mit eigenem CSS-Selektor, Gestaltung (CSS), Head und Skripte, Detailseite, Header, Footer, Kategorie, Suchergebnisse, Merkzettel, Kundenkonto, Warenkorb und Kasse oder Inhaltsbereich. Er bestimmt, welche Positionen zur Auswahl stehen.
Die genaue Stelle innerhalb des Bereichs, auf der Detailseite etwa über dem Preis, unter dem Warenkorb-Button oder am Ende des Beschreibungstextes. Die Liste richtet sich nach dem gewählten Bereich.
Der Block wird im Browser an das erste passende Element gehängt. Beispiel: .product-detail-buy oder #meinBereich
Wo der Block relativ zum gefundenen Element landet: davor, dahinter, am Anfang darin oder am Ende darin. Nur bei eigenem CSS-Selektor.
Reihenfolge, wenn mehrere Blöcke an derselben Position stehen. Die kleinere Zahl wird zuerst ausgegeben.
Standard ist die Ausgabe über die Vorlagen. Ersetzt ein Theme dieselben Twig-Blöcke ohne parent(), erscheinen die Blöcke nicht. In diesem Fall die Ausgabe per Skript wählen, dann werden sie im Browser an feste Ankerpunkte gesetzt.
Schaltet den Block ein oder aus. Inaktive Blöcke bleiben gespeichert, erscheinen aber nicht im Shop.
Legt fest, ob der Block auf allen Artikeln läuft oder nur dort, wo er am Artikel eingeschaltet wurde.
Blendet den Block je nach Bildschirmbreite ein oder aus. Mobil bis 767 Pixel, Tablet bis 991 Pixel, darüber Desktop.
Ohne Auswahl erscheint der Block auf allen Seiten. Sonst nur auf den gewählten.
Der Block läuft auf allen Artikeln. Hier zugewiesene Artikel können einen abweichenden Inhalt bekommen oder abgeschaltet werden. Der Block läuft nur auf Artikeln, die hier zugewiesen sind oder über Produktgruppe beziehungsweise Kategorie passen.
Mehrere Sprachen möglich. Der Inhalt wird für alle gewählten geschrieben, bearbeitet wird die Sprache mit dem hervorgehobenen Chip.
Darf leer bleiben, wenn nur CSS oder JavaScript gebraucht wird. Twig ist erlaubt. Immer verfügbar sind context, salesChannel, currency und customer, auf der Detailseite zusätzlich product, in den Seitenbereichen page.
Im Bereich Gestaltung wirkt das CSS auf der ganzen Seite, sonst mit dem Block. Das HTML-Feld darf leer bleiben, dann wirkt nur das CSS, etwa um vorhandene Elemente auszublenden. Selektor für diesen Block:
Wird direkt nach dem Block ausgeführt. Nur der Code, das script-Tag setzt das Plugin. Ein vollständiger Tag mit src wird unverändert übernommen.
Leer lassen für dauerhafte Anzeige. Bei aktivem Seiten-Cache kann der Wechsel etwas versetzt sichtbar werden.
Leer lassen für dauerhafte Anzeige. Bei aktivem Seiten-Cache kann der Wechsel etwas versetzt sichtbar werden.
Twig-Ausdrücke sind hier mit Beispielwerten gefüllt. Im Shop stehen die echten Daten.
Alle Preise netto zzgl. USt.
Du kaufst die Lizenz direkt bei uns und bekommst eine Rechnung von uns. Installation per Upload im Admin ohne SSH, Updates über unsere Lizenzplattform, Support direkt vom Entwickler.
Das Plugin wird im offiziellen Shopware Community Store gelistet. Installation und automatische Updates laufen dann über den Plugin Manager im Backend, die Abrechnung über deinen Shopware-Account. Sobald verfügbar, verlinken wir es hier.