Doku · 09 Konfigmatrix

Konfigmatrix · das PIM an deinen Workflow anpassen

Die Konfigmatrix ist das zentrale Steuerungselement des Plugins. In 13 Tabs legt sie fest, welche Felder sichtbar und Pflicht sind, wie Varianten, SEO-URLs, KI, Import und Mehrfachänderung arbeiten und welche Funktionen normale Benutzer sehen.

Video · 1:00 Min.KonfigurationsmatrixDie Funktion in Aktion sehen, mit eingeblendeten Erklärungen.Video ansehen →

Wo du sie findest

Die Konfigmatrix öffnest du über den Menüpunkt PIM Konfigurationsmatrix im Stone & Water-Menü des Shopware-Admins. Ob normale Benutzer sie sehen, regelt der Superadmin-Schalter „PIM-Konfiguration". Eine Schnellsuche mit Strg+K (Mac: ⌘+K) durchsucht alle Tabs, zeigt die Trefferzahl je Tab und springt über Vor- und Zurück-Schaltflächen von Treffer zu Treffer. Änderungen übernimmst du mit „Speichern".

Die 13 Tabs und ihre wichtigsten Einstellungen

1. Allgemein

• Standard-Produktliste auf PIM umleiten (Kataloge → Produkte öffnet die PIM-Liste)
• Filter dauerhaft setzen, optional mit Suchbegriff
• Standardmäßige Seitengröße: 10, 25, 50 oder 100 Einträge
• Kompakte Variantenansicht
• Sichtbare Spalten der Produktliste, Reihenfolge und eigene Spalten
• Kanal- & Sprachleiste fixieren (sticky), Scroll-to-Top-Button, Coverbild immer an erster Position
• Sichtbare Filter und Schnellfilter

2. Dashboard

• Varianten einbeziehen
• Schwellwerte: Bestand kritisch ab (Standard 5), kurze Beschreibung unter (Standard 50 Zeichen)
• KPI-Karten, Datenqualitätsprüfungen und Vollständigkeits-Gewichtung (Ignorieren, 1×, 2×, 3×) - mehr auf der Seite Dashboard

3. Produkte

• Tab-Sichtbarkeit der Detailseite („Stammdaten" ist immer sichtbar)
• Sichtbare Verkaufskanäle
• Zusatzfelder nach Sets gruppieren
• Rundung gebundener Staffelpreise und „Staffelpreise automatisch nachziehen"
• Vorschau für inaktive Artikel mit Dauer der temporären Aktivierung (15 bis 120 Sekunden)
• Je Feld: in der Detailansicht sichtbar und als Pflichtfeld markiert; Reihenfolge der Abschnitte

4. Varianten

• Artikelnummern-Pattern (Standard {parentNumber}-{options}), Trennzeichen, Optionsnamen-Format, max. Länge der Artikelnummer
• Varianten-Name-Pattern (Standard {parentName} {options})
• Hauptvariante automatisch setzen mit Strategie (erste generierte Variante oder niedrigste Artikelnummer), Hauptartikel im Listing verbergen
• Automatisierte Eigenschaftszuordnung, Varianten-Eigenschaften immer auch in den Stammartikel schreiben
• Matrix-Ansicht: Standard-Ansicht, Standard-Wert (Preis, Bestand, Aktiv), max. Varianten (Standard 500)
• Felder, Pflichtfelder und Abschnitte der Varianten-Ansicht, Zusatzfelder nach Sets
• Quickview-Felder (Varianten-Bearbeitung im Listing)

5. SEO-URLs

• Shopware-Standard-SEO-URL oder Zwei-Generator-System, jeweils mit Anzeige im Varianten-Modal und im Quickview
• Feld-Pattern und URL-Pattern (Twig), eigene Patterns je Verkaufskanal, Kategorie-Pfad-Quelle, Trennzeichen, Kleinschreibung, Umlaute umwandeln

6. Texte & Übersetzungen

• Hauptsprache als Platzhalter anzeigen
• Sichtbare Kanal-Sprachen für Mehrfachänderung und CSV-Export
• Masterprompt und Längenvorgaben für KI-Texte
• DeepL, ChatGPT, Claude, Mistral und Gemini: aktivieren, API-Key, Modell, Verbindung testen, Standard-Tonalität; für DeepL, ChatGPT und Claude zusätzlich der Schalter für die Mehrfachänderung, für ChatGPT und Claude die Zahl paralleler Anfragen

7. Import / Export

• Performance: Produkte pro Sync-Batch, parallele Bild-Uploads pro Produkt, gleichzeitige Produkte beim Bild-Import, Übersetzungen pro Sync-Batch, API-Rate-Limit
• Indexierung während des Imports deaktivieren, nach dem Import automatisch re-indexieren, Import bei Fehleranzahl abbrechen
• Export: Standard-Exportprofil, Trennzeichen, max. Produkte (Standard 5.000), Varianten standardmäßig exportieren, Standard-Dateiformat, Dezimaltrennzeichen

8. Mehrfachänderung

• Fehlende Übersetzungen in der Mehrfachänderung anzeigen
• Batch-Größe, max. Produkte über Preset-Filter (Standard 500), Schreibgröße pro API-Request
• Snapshot vor Änderung erstellen, Bestätigung vor Anwendung, bei Abbruch automatisch zurücksetzen
• Varianten standardmäßig einschließen

9. Freigabe

• Freigabe-Workflow aktivieren, Freigabe-Berechtigte (Benutzernamen)
• Freigabe-Protokollierung, Aufbewahrung mit automatischer Bereinigung, Statistik, Daten bereinigen - mehr unter Freigabe-Workflow

10. Änderungshistorie

• Automatische Bereinigung, Aufbewahrungszeitraum (7 Tage bis 1 Jahr, Standard 90 Tage), maximale Einträge pro Produkt (Standard 100)
• Änderungshistorie aktiviert, gesamte Änderungshistorie löschen

11. Snapshots

• Automatische Bereinigung, Aufbewahrungszeitraum (Standard 90 Tage), maximale Anzahl (Standard 50)
• Snapshots bei Mehrfachänderungen und bei CSV-Import erstellen, Diff-Ansicht für beide
• Listen der Snapshots mit Diff anzeigen, Wiederherstellen und Löschen

12. Fremdsysteme

• Schutz vor Fremdsystemen: geschützte Sprachen, Felder und Integrationen, Auslösung, Wartezeit, Referenzstand und Protokoll - mehr unter Fremdsystem-Schutz

13. PIM-Superadmin

• Superadmin-Benutzer, Sichtbarkeit und Funktionen für normale Benutzer, Bearbeitungssperre, PIM auf Standard zurücksetzen - nur für Superadmins sichtbar, mehr unter Rechte & Superadmin

Felder und Abschnitte

In den Tabs Produkte und Varianten schaltest du jedes Feld für die Detailansicht bzw. die Varianten-Ansicht sichtbar oder unsichtbar und markierst es bei Bedarf als Pflichtfeld („Pflicht (manuell)"). Felder, die Shopware ohnehin verlangt, sind als „Pflicht" gekennzeichnet und lassen sich nicht deaktivieren. Welche Felder im Quickview der Produktliste erscheinen, legst du im Tab Varianten fest. Einen eigenen Tab „Quickview" gibt es nicht.

Reihenfolge per Pfeil-Schaltflächen

Die Reihenfolge der Abschnitte in der Produkt-Detailansicht, etwa Stammdaten, Preise, Medien, SEO, Eigenschaften und Cross-Selling, legst du im Tab Produkte fest, die der Varianten-Ansicht im Tab Varianten - jeweils über „Nach oben" und „Nach unten".

Eigene Spalten

Im Tab Allgemein legst du neben den Standardspalten eigene an. Quelle ist ein Stammdatenfeld oder ein beliebiges Zusatzfeld, wahlweise sortierbar. Datums- und Ja/Nein-Werte werden automatisch passend formatiert.

Preise brutto und netto

Alle vier Preisarten lassen sich unabhängig für Brutto und Netto ein- und ausblenden, getrennt für Hauptartikel und Varianten:

• Verkaufspreis
• Einkaufspreis
• Streichpreis / UVP
• Günstigster Preis der letzten 30 Tage (Omnibus)

So ist reine Brutto-Pflege, reine Netto-Pflege oder eine gemischte Anzeige möglich. Bestehende Einstellungen bleiben gültig, eine Migration ist nicht nötig.

SEO-URLs: zwei Wege

Im Tab SEO-URLs wählst du zwischen dem Shopware-Standard (native SEO-URL direkt im PIM bearbeiten) und dem Zwei-Generator-System (Token-Muster in ein Zusatzfeld, Twig-Vorlage für Shopwares SEO-URLs mit 301-Weiterleitungen). Beide Wege, die Variablen und den Konsolenbefehl beschreibt die Seite SEO-URLs.

Funktionen für normale Benutzer

Im Tab PIM-Superadmin legst du die Superadmins fest und schaltest für alle anderen Benutzer einzelne Funktionen ein oder aus, darunter Produkte erstellen und duplizieren, Mehrfachänderungen, Varianten generieren, Löschen, CSV-Import und -Export, Feed-Generator und Kategorien verwalten. Dazu kommen Sichtbarkeitsschalter für die Konfigmatrix und das Dashboard sowie die Bearbeitungssperre. Details auf der Seite Rechte & Superadmin.

Einstellungen gelten für alle Benutzer

Spaltenauswahl, Seitengröße, Tonalität und alle übrigen Einstellungen der Konfigmatrix gelten shopweit für alle Benutzer. Auch Filter-Presets liegen in der Datenbank und stehen allen zur Verfügung. Eine Trennung nach Benutzer gibt es nicht - unterschiedliche Rechte steuerst du über die Superadmin-Liste und die Funktionsschalter.

Pflichtfelder mit Sprung zur Stelle

Fehlt beim Speichern in der Detailansicht ein Pflichtfeld, öffnet sich ein Fenster mit allen Fehlern. Ein Klick springt zum betroffenen Abschnitt, klappt ihn auf und hebt das Feld kurz hervor.

Weiter geht's

Die Felder, die du hier freischaltest, nutzt du vor allem in der Mehrfachänderung und im Produktlisting. Die Einrichtung der KI-Anbieter beschreibt die KI-Textgenerierung.

Häufige Fragen