Von der Installation bis zur Diagnose: Tag festlegen, Hinweistext anpassen, Sonderfälle abdecken und im Zweifel herausfinden, warum ein Hinweis ausbleibt.
Shopware 6.7 mit Storefront, PHP 8.2 oder neuer. Es wird kein Theme-Build benötigt, die Installation läuft per Upload im Admin ohne SSH.
Wichtig: Gepflegt wird ausschließlich über einen Tag in der Mediathek. Die Bilddatei selbst wird nicht verändert.
Installation
ZIP im Admin unter Erweiterungen, Meine Erweiterungen, Erweiterung hochladen einspielen, danach installieren und aktivieren.
Anschließend den Lizenzschlüssel im Abschnitt Allgemein eintragen. Ohne gültigen Schlüssel bleiben die übrigen Einstellungen ausgeblendet und im Shop erscheint kein Hinweis.
In zwei Schritten einsatzbereit
Erstens: In der Mediathek das Bild öffnen und den Tag setzen. Voreingestellt ist "KI".
Zweitens: Nichts weiter. Das Bild trägt den Hinweis überall dort, wo es im Shop ausgegeben wird.
Tipp: Lege den Tag einmal in der Mediathek an, bevor du ihn im Plugin auswählst. Dann erscheint er in der Auswahlliste und Tippfehler sind ausgeschlossen.
Den Tag festlegen
Im Abschnitt Allgemein bestimmst du, welcher Tag als Kennzeichnung gilt. Die Auswahlliste zeigt alle in der Mediathek vorhandenen Tags samt Suchfeld.
Ist der gewünschte Tag noch nicht angelegt, lässt er sich als freier Text eintragen. Er wirkt, sobald er in der Mediathek an einem Bild gesetzt wird.
Den Hinweistext anpassen
Der Text liegt als Textbaustein unter dem Namen stawKiImageBadge.label vor. Voreingestellt sind "KI generiert" auf Deutsch und "AI generated" auf Englisch.
Änderungen sind an zwei Stellen möglich: unter Einstellungen, Textbausteine je Sprache, oder direkt im Plugin über ein eigenes Textfeld. Der Eintrag im Plugin hat Vorrang.
Wo der Hinweis erscheint
Ohne weiteres Zutun abgedeckt sind Produktlisten, Detailseiten, Galerien, Slider, Produkt-Slider und Bildelemente in Erlebniswelten. Diese Ausgabewege laufen alle über die zentrale Bildausgabe von Shopware.
Zwei Sonderfälle sind über eigene Schalter abgedeckt. Der erste betrifft Bilder, die als rohes HTML in einer Produktbeschreibung oder einem Textelement stehen; sie werden über den Dateinamen zugeordnet. Der zweite ist ein Sicherheitsnetz für Bilder, die ein Theme selbst ausgibt, etwa aus einem Zusatzfeld einer Kategorie.
Zur Sparsamkeit: Beim Sicherheitsnetz werden ausschließlich die Dateinamen der gerade aufgerufenen Seite übergeben, nicht die gesamte Mediathek.
Wie der Hinweis sitzt
Der Hinweis wird am Bild ausgerichtet, nicht am umgebenden Kasten. Der Versatz zwischen beiden wird gemessen und herausgerechnet, Rahmenbreiten eingeschlossen. Dadurch stehen die Hinweise nebeneinander liegender Bilder auf gleicher Höhe.
Neu positioniert wird beim Laden des Bildes, beim Ändern der Fenstergröße und bei einer Größenänderung des Bildes selbst, sofern der Browser einen Größenbeobachter kennt.
Liegen mehrere Bilder im selben Container, bekommt jedes seinen eigenen Hinweis.
Je Verkaufskanal
Der Hinweis lässt sich je Verkaufskanal getrennt ein- und ausschalten. Das ist nützlich, wenn du mehrere Marken betreibst und die Kennzeichnung nicht überall gleich handhaben willst.
Die Diagnose berücksichtigt den oben ausgewählten Kanal, prüft also genau die Kombination, die du gerade betrachtest.
Diagnose bei fehlendem Hinweis
Der Prüfen-Knopf beantwortet die häufigsten Fragen in einem Durchgang: Existiert der Tag überhaupt, wie viele Bilder tragen ihn, ist der Hinweis im gewählten Verkaufskanal wirksam, wurde die Konfiguration schon einmal gespeichert.
Dazu kommen bis zu fünf Beispieldateien und eine Liste ähnlich geschriebener Tags mit Bildanzahl. Damit fällt sofort auf, wenn der Tag in der Mediathek etwa "KI-generiert" statt "KI" heißt.
Seit Version 1.1.0 nennt die Diagnose zusätzlich den Lizenzstatus im Klartext.
Lizenz
Die Prüfung ist bewusst streng: Ohne gültigen, aktiven und zur Domain passenden Schlüssel bleibt der Hinweis im Shop aus. So ist ausgeschlossen, dass eine abgelaufene Lizenz unbemerkt weiterläuft.
Ist der Lizenzserver einmal nicht erreichbar, greift ein Kulanzzeitraum von drei Tagen ab der letzten gültigen Prüfung. Das Ergebnis wird sechs Stunden zwischengespeichert, es entsteht also kein Netzwerkaufruf je Seitenaufruf.
Mögliche Gründe im Klartext: kein Schlüssel hinterlegt, Schlüssel inaktiv, Schlüssel unbekannt, Domain passt nicht, Server nicht erreichbar, Kulanzzeitraum aktiv.
Problemlösung
Kein Hinweis sichtbar: Zuerst die Diagnose aufrufen. Sie nennt Tag, Bildanzahl, Kanalwirksamkeit und Lizenzstatus - meist steht die Antwort schon dort.
Hinweis nur bei manchen Bildern: Prüfe die beiden Schalter für Textinhalte und für übrige Bilder. Bilder aus Beschreibungen und aus Theme-eigener Ausgabe hängen daran.
Hinweis sitzt falsch: Das Bild muss geladen sein, bevor positioniert wird. Bei sehr eigenwilligen Themes kann es helfen, den Cache zu leeren und die Seite neu zu laden.
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.
Alle Einstellungen
Jede Einstellung des Plugins mit Standardwert und Erklärung, in derselben Reihenfolge wie im Administrationsbereich. Die Texte stammen direkt aus dem Plugin (Version 1.2.0).
Allgemein
Aktivierung und der Tag, der ein Bild als KI generiert kennzeichnet.
Hinweis im Storefront anzeigenStandard: an
Blendet den Hinweis auf den als KI-Bild markierten Bildern im Shop ein oder aus.
LizenzschlüsselStandard: leer
Der Lizenzschlüssel aus deinem Kundenkonto bei Stone & Water. Ohne gültige Lizenz zeigt der Shop keinen Hinweis.
Lizenz-Server (optional)Standard: leer
Nur ändern, wenn von Stone & Water vorgegeben. Leer = Standard-Server.
TagStandard: KI
Bilder der Mediathek, die diesen Tag tragen, bekommen im Shop den Hinweis. Liste der vorhandenen Tags aus der Mediathek. Freie Eingabe, falls der Tag noch nicht existiert. Standard: KI
Auch Bilder in Textinhalten kennzeichnenStandard: an
Erfasst zusätzlich Bilder, die im Text-Element einer Erlebniswelt oder in der Produktbeschreibung eingefügt wurden. Diese laufen nicht über die Bildausgabe von Shopware, sie werden anhand des Dateinamens zugeordnet.
Alle übrigen Bilder ebenfalls prüfenStandard: an
Sicherheitsnetz für Bilder, die ein Theme oder ein anderes Plugin direkt ausgibt, etwa Medien aus Zusatzfeldern einer Kategorie. Die getaggten Dateien der aufgerufenen Seite werden ans Storefront übergeben und dort abgeglichen.
Text des Hinweises
Der Text kommt aus einem Textbaustein und kann hier überschrieben werden.
Eigener Text (optional)Standard: leer
Leer = der Text kommt aus dem Textbaustein und ist unter Einstellungen, Textbausteine mehrsprachig pflegbar:
Darstellung
Position, Stil und Größe des Badges im Storefront.
Position im BildStandard: Unten rechts
In welcher Ecke des Bildes der Hinweis sitzt: unten rechts, unten links, oben rechts oder oben links.
StilStandard: Dunkel (transparent)
Aussehen des Hinweises: dunkel oder hell mit Transparenz, in der Akzentfarbe oder nur als Umriss.
Schriftgröße (px)Standard: 11
Schriftgröße des Hinweistexts in Pixeln. Möglich sind 8 bis 24.
Deckkraft (%)Standard: 90
Deckkraft des Hinweises in Prozent. Niedrigere Werte lassen mehr vom Bild durchscheinen. Möglich sind 10 bis 100.
Eckenradius (px)Standard: 4
Rundung der Ecken des Hinweises in Pixeln. Möglich sind 0 bis 24.
Abstand zum Bildrand (px)Standard: 8
Abstand des Hinweises zum Bildrand in Pixeln. Möglich sind 0 bis 40.
Mindestbreite des Bildes (px)Standard: 160
Kleinere Bilder, etwa im Warenkorb oder in der Suche, bleiben ohne Badge. 0 = immer anzeigen. Möglich sind 0 bis 2000.
Symbol vor dem TextStandard: aus
Zeigt ein kleines Funkeln-Symbol vor dem Hinweistext.
Verfügbarkeit
Direkt über Stone & Water
Ab sofort möglich
Monatlich9,99 €
Bester PreisJährlich101,90 €15 % günstiger
Alle Preise netto zzgl. USt.
Lade die kostenlose Plugin Suite herunter und spiele sie im Admin ein, ganz ohne SSH. Darüber installierst und aktualisierst du das Plugin mit einem Klick. Die Lizenz kaufst du direkt bei uns, mit Rechnung von uns und 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.