Handbuch KI Bild Hinweis.

Von der Installation bis zur Diagnose: Tag festlegen, Hinweistext anpassen, Sonderfälle abdecken und im Zweifel herausfinden, warum ein Hinweis ausbleibt.

Systemvoraussetzungen

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.

Verfügbarkeit

Direkt über Stone & Water

Ab sofort möglich

Monatlich9,99 €
Halbjährlich49,99 €16 % günstiger
Bester PreisJährlich89,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.