KI-Bilder in Magento und Adobe Commerce kennzeichnen

Script-Tag einbinden

<script src="https://www.ai-label.app/widget.js" defer></script>

1. Im Admin: Content > Design > Configuration.
2. In der Zeile der gewünschten Store View auf Edit klicken.
3. Unter „Other Settings“ den Bereich HTML Head öffnen.
4. Das Script-Tag in das Feld „Scripts and Style Sheets“ einfügen.
5. Save Configuration, danach unter System > Cache Management die als ungültig markierten Caches aktualisieren.

Die Einstellung gilt für die gewählte Ebene. Bei mehreren Store Views, etwa je Sprache, prüfen Sie jede einzeln.

Content Security Policy

Laut Adobe muss JavaScript aus diesem Feld in der Content Security Policy freigegeben sein, sonst läuft es auf den Checkout-Seiten nicht. Ab Version 2.4.7 gilt auf Zahlungsseiten der strenge Modus, auf den übrigen Seiten der Berichtsmodus. Die Freigabe steht in einer Datei csp_whitelist.xml im Ordner etc eines eigenen Moduls:

<policy id="script-src">
    <values>
        <value id="ai-label" type="host">https://www.ai-label.app</value>
    </values>
</policy>

Für Sprachen außer Deutsch und Englisch lädt das Widget eine kleine Textdatei von derselben Adresse nach. Geben Sie die Adresse dann auch für connect-src frei.

Bilder markieren

Welche Bilder ein Label brauchen, entscheiden Sie, etwa mit dem Pflicht-Check. Das Widget kennzeichnet nur markierte Bilder, auf drei kombinierbaren Wegen:

• Attribut am Bild: data-ai-label="generated" für vollständig mit KI erzeugte Bilder, data-ai-label="modified" für mit KI veränderte Fotos.
• Dateiname mit Kennung vor der Endung: vase--ai.jpg oder vase--ai-mod.jpg.
• Alt-Text, der mit „(KI-generiert)“ oder „(Mit KI verändert)“ endet.

In Magento markieren Sie am einfachsten über den Alt-Text des Produktbilds. Öffnen Sie unter Catalog > Products das Produkt, im Bereich „Images And Videos“ das Bild, und ergänzen Sie das Feld „Alt Text“. Alternativ benennen Sie die Datei vor dem Hochladen mit --ai um und prüfen im Seitenquelltext, ob die Kennung in der Bildadresse ankommt. Das Attribut data-ai-label setzen Sie in eigenen Theme-Vorlagen.

Magento Admin/ Catalog / Products / Images And Videos

AI

kerze.jpg

Alt Text

Duftkerze im Glas (KI-generiert)

KI-generiert

Duftkerze im Glas24,90 €

Vase aus Steinzeug32,00 €

KI-generiert

Pilzleuchte59,00 €

Stolpersteine

• Cache: Ohne Aktualisierung unter Cache Management und im Full Page Cache sehen Besucher die Seite weiter ohne Skript.
• CSP im Berichtsmodus: Auf normalen Seiten meldet die Policy einen Verstoß nur und blockiert nicht. Eine fehlende Freigabe fällt deshalb oft erst im Checkout auf.
• Galerie im Vollbild: Prüfen Sie, ob das Label in der vergrößerten Ansicht erscheint.
• Mehrere Store Views: Alt-Texte lassen sich je Store View pflegen. Ergänzen Sie den Zusatz in jeder Sprache, in der das Bild erscheint.

Grenzen des Widgets

• Das Widget erreicht nur <img>-Elemente auf Seiten mit dem Skript. Hintergrundbilder aus dem Stylesheet und Bilder unter 48 Pixeln (einstellbar mit data-min) bleiben ohne Label.
• E-Mails wie Bestellbestätigungen erreicht es nicht. Für Bilder außerhalb der Website erzeugen Sie mit KI-Bild kennzeichnen eine Kopie mit eingebranntem Label.
• Datenschutz: Beim Laden von ai-label.app sieht unser Hoster wie bei jedem Abruf die IP-Adresse. Cookies setzt das Skript nicht. Erwähnen Sie die Einbindung in Ihrer Datenschutzerklärung.

Native App

Eine eigene App für Magento ist geplant, einen Termin gibt es noch nicht.