In OXID eShop 7 binden Sie das Widget mit einem kleinen Modul ein, das einen Block des aktiven Themes erweitert, beim APEX-Theme über eine Twig-Vorlage mit {{ parent() }}.
Artikelbilder markieren Sie mit --ai im Dateinamen, vergeben vor dem Hochladen auf der Registerkarte Bilder.
Script-Tag einbinden
<script src="https://www.ai-label.app/widget.js" defer></script>
Die OXID-Entwicklerdokumentation zeigt, wie ein Modul einen Block des aktiven Themes erweitert. Beim APEX-Theme liegt die Erweiterung im Modul unter views/twig/extensions/themes/apex/, im selben Pfad wie die Originalvorlage. Sie erbt mit {% extends %} von der Vorlage und überschreibt einen Block mit demselben Namen:
{% extends 'layout/base.html.twig' %}
{% block BLOCKNAME %}
{{ parent() }}
<script src="https://www.ai-label.app/widget.js" defer></script>
{% endblock %}
Vorlage und Blockname sind Platzhalter. Wählen Sie einen Block, der auf jeder Seite im Kopf- oder Fußbereich ausgegeben wird; die Namen stehen in den Vorlagen des APEX-Themes auf GitHub. {{ parent() }} behält den ursprünglichen Inhalt. Aktivieren Sie das Modul danach neu.
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.jpgodervase--ai-mod.jpg. - Alt-Text, der mit „(KI-generiert)“ oder „(Mit KI verändert)“ endet.
In OXID markieren Sie am einfachsten über den Dateinamen. Öffnen Sie im Adminbereich die Artikeldetails, Registerkarte Bilder, und benennen Sie die Datei vor dem Hochladen um, etwa in vase--ai.jpg. Das System erzeugt daraus Vorschaubild und Icon. Prüfen Sie im Seitenquelltext, ob --ai in der ausgelieferten Bildadresse steht.
Ob Sie einen eigenen Alt-Text für Artikelbilder pflegen können, hängt von Theme und Version ab. Wenn ja, geht auch der Zusatz am Ende. In eigenen Vorlagen setzen Sie das Attribut data-ai-label direkt.
Stolpersteine
- HTML-Sanitizer: OXID 7.5 bringt einen HTML-Sanitizer mit, standardmäßig abgeschaltet. Eingeschaltet entfernt er unter anderem
<script>und Event-Handler. Ein Script-Tag in CMS-Inhalten ist deshalb nicht verlässlich. - Theme-Update: Änderungen direkt in den Dateien des APEX-Themes gehen beim Update verloren, das Modul bleibt.
- Vergrößerte Ansicht: Prüfen Sie, ob das Label in der Zoom-Ansicht 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 mitdata-min) bleiben ohne Label. - Prüfen Sie, ob der gewählte Block in Warenkorb und Bestellabschluss ausgegeben wird.
- 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 OXID eShop ist geplant, einen Termin gibt es noch nicht.
Benachrichtigen, wenn die App für OXID eShop kommt
Wir schreiben Ihnen einmal, wenn die App erscheint.
Häufige Fragen
Wo binde ich das Skript in OXID ein?
Mit einem Modul, das einen Block des aktiven Themes erweitert, beim APEX-Theme unter views/twig/extensions/themes/apex/.
Kann ich das Script-Tag in eine CMS-Seite schreiben?
Das ist nicht verlässlich. Ein eingeschalteter HTML-Sanitizer entfernt <script>, und das Skript liefe nur auf dieser Seite.
Quellen
Rn. steht für die Randnummer in den Leitlinien der EU-Kommission zu Art. 50, C(2026) 5054.
- OXID Developer-Doku: Block eines aktiven Themes erweiternOXID eSales · Plattform · 11.10.2026
- OXID Developer-Doku: HTML-Sanitizer (7.5)OXID eSales · Plattform · 11.10.2026
- OXID-Handbuch: Artikel, Registerkarte BilderOXID eSales · Plattform · 11.10.2026
- APEX-Theme auf GitHubOXID eSales · Plattform · 11.10.2026
- Code of Practice on Transparency of AI-Generated Content (finale Fassung)Europäische Kommission · Verhaltenskodex · 10.06.2026
- Verordnung (EU) 2024/1689 (KI-Verordnung)EUR-Lex · Gesetz · 12.07.2024


