Handbuch KI Zusatzinhalte.

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.

Systemvoraussetzungen

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.

Ohne KI nutzbar: Blöcke lassen sich vollständig von Hand pflegen. Der KI-Teil ist eine Erleichterung, keine Voraussetzung.

Installation

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 erste Block in vier Schritten

  • Im Modul auf „Block anlegen" klicken
  • Bereich wählen, dann die Position innerhalb des Bereichs
  • Inhalt eintragen oder von der KI schreiben lassen
  • Speichern und aktivieren

Der Block erscheint sofort im Shop. Ein Leeren des Caches ist in der Regel nicht nötig.

Bereiche und Positionen

Die 49 Positionen sind nach Bereichen gruppiert. Zuerst wählst du den Bereich, dann die Position darin - das hält die Liste überschaubar.

  • Detailseite - rund um Name, Artikelnummer, Preis, Steuer, Lieferinformation, Variantenauswahl, Kaufknopf, Merkzettel, Galerie, Bewertungen und Zubehör, dazu vier Punkte rund um den Beschreibungstext
  • Kategorie und Suche - oben und unten in der Kategorie, im Listing, über dem Filter, oben und unten bei den Suchergebnissen
  • Warenkorb und Kasse - Warenkorbseite, Mini-Warenkorb, Bestätigungsseite vor Zahlart und vor dem Absenden, Adressseite, Danke-Seite
  • Konto und Merkzettel - Kundenkonto, Registrierung, Merkzettel
  • Kopf- und Fußbereich - oben und unten im Kopf, oben und unten im Fuß, unterhalb der Urheberzeile
  • Überall - zwei Positionen, die auf jeder Seite greifen, ganz oben und ganz unten
Zu den Positionen „Überall": Sie eignen sich für Hinweisstreifen, die wirklich auf jeder Seite stehen sollen. Weil sie überall greifen, wirken sich Fehler dort auch überall aus - beim Einrichten also zuerst mit einer Geräteauswahl oder einem Zeitfenster eingrenzen.

Inhalt, CSS und JavaScript

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.

Beispiel: {{ 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.

Inhalt von der KI schreiben lassen

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.
Zum Schlüssel: Anbieter, Schlüssel und Modell stehen im Reiter Einstellungen, dazu ein Verbindungstest. Der Schlüssel wird serverseitig gespeichert und nie an den Browser ausgeliefert.

Wer den Block sieht

Verkaufskanal: Ein Block gilt für einen bestimmten Kanal oder für alle.Artikel: Vier Wege stehen zur Wahl - alle Artikel, eine Liste von Artikelnummern, eine dynamische Produktgruppe oder ausgewählte Kategorien. Die Artikelnummern lassen sich als Liste einfügen.
Nur auf der Detailseite: Die Artikelzuordnung wirkt dort, wo es einen Artikel gibt. In anderen Bereichen - etwa im Kopfbereich oder in der Kasse - wird sie ausgeblendet, weil sie dort nichts einschränken kann.
Gerät: Mobil, Tablet, Rechner oder Kombinationen davon, je Block wählbar.Zeitraum: Ein Block kann ab einem Datum erscheinen und an einem anderen wieder verschwinden. Ohne Angabe gilt er unbefristet.Reihenfolge: Liegen mehrere Blöcke an derselben Position, bestimmt die Priorität die Abfolge.

Ausgabeart

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.

Erst die Vorgabe versuchen: Die zweite Art ist die Ausweichlösung. Sie lässt sich allgemein einstellen und zusätzlich je Block abweichend wählen - so bleibt der Ausnahmefall die Ausnahme.

Viele Blöcke verwalten

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.

Problemlösung

Der Block erscheint nicht: Prüfe der Reihe nach: Ist er aktiv? Passt der Verkaufskanal? Liegt das heutige Datum im Zeitfenster? Passt die Geräteauswahl zum Testgerät? Und bei Blöcken der Detailseite: Ist der betrachtete Artikel überhaupt zugeordnet?
Er erscheint an falscher Stelle oder gar nicht, obwohl alles passt: Wahrscheinlich ersetzt dein Theme denselben Twig-Block. Stelle die Ausgabeart des Blocks auf die zweite Art um.
Das CSS wirkt nicht: Themes setzen oft eigene Regeln mit höherer Gewichtung. Formuliere die Regel enger, etwa über eine eigene Klasse im Inhalt des Blocks.

Support

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.

Verfügbarkeit

Direkt über Stone & Water

Ab sofort möglich

Monatlich24,99 €
Halbjährlich124,99 €16 % günstiger
Bester PreisJährlich229,99 €25 % günstiger

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.

Direkt anfragen +49 2555 9997342

Shopware Store

In Vorbereitung

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.