In WooCommerce binden Sie das Widget wie jedes Skript in WordPress ein, mit einem Plugin wie WPCode oder im Child-Theme mit wp_enqueue_script().
Produktbilder markieren Sie über den Alt-Text in der Mediathek, etwa „Vase auf Holztisch (KI-generiert)“. Der Dateiname funktioniert nicht, weil WordPress beim Hochladen aus --ai einen einfachen Bindestrich macht.
Script-Tag einbinden
<script src="https://www.ai-label.app/widget.js" defer></script>
- Ohne Code: mit dem Plugin WPCode (früher „Insert Headers and Footers“). Im Menü „Code Snippets“ fügen Sie das Script-Tag in das Feld für den Kopfbereich („Scripts in Header“) ein und speichern.
- Im Child-Theme: in der
functions.phpmitwp_enqueue_script(). Dort überschreibt ein Theme-Update Ihre Änderung nicht.
add_action( 'wp_enqueue_scripts', function () {
wp_enqueue_script( 'ai-label', 'https://www.ai-label.app/widget.js', array(), null, array( 'strategy' => 'defer' ) );
} );
Öffnen Sie danach eine Produktseite und eine Kategorieseite mit markiertem Bild. Das Label erscheint oben rechts auf dem Bild, auch auf den Produktkarten.
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 WooCommerce markieren Sie über den Alt-Text in der Mediathek, zu finden unter Medien in den Details des Bildes. Produktbild und Galerie setzen Sie im Produkt-Editor in der rechten Spalte, beide verweisen auf Dateien der Mediathek.
Der Dateiname funktioniert in WordPress nicht. Die Funktion sanitize_file_name() fasst beim Hochladen mehrere Bindestriche zu einem zusammen. Aus vase--ai.jpg wird vase-ai.jpg, und das Widget erkennt die Kennung nicht mehr. Das Attribut data-ai-label setzen Sie nur in Vorlagen des Child-Themes.
Stolpersteine
- Verzögertes JavaScript: Optimierungs-Plugins halten Skripte teils zurück, bis der Besucher scrollt, tippt oder die Maus bewegt, bei WP Rocket etwa mit „Delay JavaScript execution“. Dann fehlt das Label beim ersten Blick. Tragen Sie
widget.jsbei „Excluded JavaScript Files“ oder in der Ausnahmeliste Ihres Plugins ein. - Seiten-Cache: Leeren Sie nach dem Einbinden den Cache des Caching-Plugins und gegebenenfalls des CDN.
- Zoom und Vollbild: Die Produktgalerie vergrößert Bilder beim Überfahren und zeigt sie auf Klick im Vollbild. Prüfen Sie, ob das Label dort erscheint.
- Leere Alt-Texte: Fehlt der Alt-Text, setzen manche Themes den Produktnamen ein. Dann fehlt der Zusatz, und das Bild bleibt ohne Label.
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. - Warenkorb und Kasse zeigen oft nur kleine Vorschaubilder. Prüfen Sie beide Seiten.
- 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 WooCommerce ist geplant, einen Termin gibt es noch nicht.
Benachrichtigen, wenn die App für WooCommerce kommt
Wir schreiben Ihnen einmal, wenn die App erscheint.
Häufige Fragen
Brauche ich dafür ein Plugin?
Nein. Im Child-Theme genügt wp_enqueue_script() in der functions.php. WPCode ist der Weg ohne Code.
Gilt die Markierung auch für die Produktkarten?
Ja, wenn Ihr Theme dort dieselbe Datei mit demselben Alt-Text ausgibt. Prüfen Sie Kategorieseite und Suche.
Quellen
Rn. steht für die Randnummer in den Leitlinien der EU-Kommission zu Art. 50, C(2026) 5054.
- WooCommerce: Produktbilder und GalerienWooCommerce · Plattform · 11.10.2026
- WPCode im Plugin-Verzeichnis von WordPressWordPress.org · Plattform · 08.10.2026
- WordPress Developer Resources: wp_enqueue_script()WordPress.org · Plattform · 11.10.2026
- WordPress Theme Handbook: Child-ThemesWordPress.org · Plattform · 26.01.2024
- WordPress-Dokumentation: MediathekWordPress.org · Plattform · 06.06.2024
- WordPress-Quellcode: sanitize_file_name() (Version 7.1.3)WordPress · Plattform · 11.10.2026
- WP Rocket: JavaScript-Ausführung verzögernWP Media · Plattform · 11.03.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


