Installation & Konfiguration

DasBild in Shopware 6.7 einrichten

Installation

  1. Plugin-Ordner in custom/plugins/SvenDasBild/ ablegen
  2. Plugin-Liste aktualisieren:
    bin/console plugin:refresh
  3. Plugin installieren und aktivieren:
    bin/console plugin:install --activate SvenDasBild
  4. Administration-Assets kompilieren:
    bin/console administration:build
    bin/console theme:compile
  5. Cache leeren:
    bin/console cache:clear
Voraussetzungen: PHP 8.1+ mit ext-gd (Bildverkleinerung) und ext-curl (API-Calls). Prüfen mit php -m | grep -E 'gd|curl'.
Nach der Installation erscheint im Shopware-Admin unter Kataloge > Farberkennung die Übersichtsseite. Auf jeder Produktdetailseite ist zusätzlich der KI-Button eingeblendet.

Konfiguration

Alle Einstellungen liegen unter Erweiterungen > Meine Erweiterungen > DasBild > Konfigurieren. Die Konfiguration ist in zwei Karten unterteilt: Allgemein und KI-Bilderkennung.

Karte 1 – Allgemein

EinstellungBeschreibungStandard
Name der Farb-Eigenschaftsgruppe Name der Property-Group, in der die erkannten Farben gespeichert werden. Vom Typ color — ergibt automatisch Swatches im Storefront-Filter. Image Colors
Maximale Anzahl Farben Wie viele dominante Farben die KI pro Produkt liefern darf (1–5). 3

Karte 2 – KI-Bilderkennung: Anbieter & API-Key

EinstellungBeschreibungStandard
API Key erstellen Komfort-Komponente mit Direktlinks zu console.anthropic.com und platform.openai.com.
KI-Anbieter Anthropic (Claude) oder OpenAI (GPT-4o). Bestimmt, welche API das Plugin aufruft und welches Default-Modell genommen wird. anthropic
API Key Passwort-Feld. Anthropic-Keys beginnen mit sk-ant-, OpenAI-Keys mit sk-. Wird niemals im Admin zurückgegeben.
Modell Modell-ID. Leer lassen nutzt den Default:
• Anthropic: claude-sonnet-4-20250514
• OpenAI: gpt-4o
(leer)
API Key testen Schaltfläche, die einen Probe-Request mit max_tokens: 5 losschickt und klar meldet, wenn der Key ungültig ist, das Guthaben fehlt oder das Modell unbekannt ist.
Kostenhinweis: Beide Anbieter rechnen pro verarbeitetem Bild + Output-Tokens ab. Für eine Batch-Analyse lohnt sich der --dry-run (siehe CLI-Befehle), um vorher zu testen. Pro Produkt wird ein Call ausgeführt; große Produktkataloge können mit --delay gedrosselt werden.

Aktive KI-Felder

Multi-Select über alle verfügbaren Felder. Nur ausgewählte Felder werden analysiert und gespeichert. Standard-Selection:

farben, designer, hersteller, material, stil, epoche,
design_referenz, muster, herkunft, technik,
meta_titel, beschreibung

Die Optionen entsprechen den Keys aus Standard-Felder. Wenn eigene Felder definiert sind (siehe unten), erscheinen diese zusätzlich — Felder, die es nicht (mehr) gibt, werden automatisch ignoriert, damit nichts still ausfällt.

Eigene KI-Felder (fortgeschritten)

Textarea für branchen-spezifische Felder. Eine Zeile pro Feld, Pipe-getrennt:

field_key | DE Label | EN Label | multi (ja/nein) | Prompt-Hinweis

Ist das Feld leer, greift der Standard-Set für Design- und Vintage-Shops (12 Felder). Details und Beispiele auf der Seite KI-Bildanalyse → Eigene KI-Felder.

Reservierte Keys: farben (Palette + Hex-Codes), beschreibung (Custom Field ki_beschreibung) und meta_titel (natives Produkt-Meta) haben Sonderlogik. Nicht überschreiben.

SEO-Schalter

EinstellungBeschreibungStandard
Meta-Titel automatisch setzen Überschreibt den Shopware-Meta-Titel mit dem KI-Feld meta_titel (max. 60 Zeichen, SEO-optimiert). false
Meta-Beschreibung automatisch setzen Schreibt die ersten ~155 Zeichen der KI-Beschreibung (HTML gestrippt) in die Meta-Beschreibung. false

Beschreibungslänge

WertZielwörterEinsatzgebiet
short~50Kategorie-Teaser
medium (Standard)~120Standard-Produktseite
long~250Ausführliche SEO-Seiten
Pro Sales-Channel konfigurierbar: Alle Einstellungen sind Sales-Channel-fähig — unterschiedliche Shops können unterschiedliche Felder, Modelle oder Beschreibungslängen nutzen.
← Übersicht Weiter: KI-Bildanalyse →