Zum Inhalt springen
Stone & Water
Doku · 02 Produktlisting

Produktlisting · Filter, Spalten, Inline-Edit, Quickview

Das zentrale Listing zeigt deinen gesamten Produktbestand - mit konfigurierbaren Spalten, mächtigen Filtern, Inline-Bearbeitung und einem Quickview-Modal für die schnelle Stammdaten-Pflege.

Aufbau der Ansicht

Das Listing besteht aus fünf Bereichen:

  • Filter-Bar oben - beliebig viele Filter-Bedingungen mit UND/ODER
  • Spalten-Header - sortierbar, breitenanpassbar, ein-/ausblendbar
  • Datenzeilen - pro Produkt eine Zeile, Variantsartikel inline aufklappbar
  • Footer-Toolbar - Auswahl, Bulk-Aktionen, Export/Import
  • Bottom-Save-Bar - erscheint bei aktiven Inline-Änderungen

Filter mit UND / ODER

Beliebig viele Filterbedingungen lassen sich kombinieren. Pro Bedingung wählst du Feld, Operator und Wert.

9 Vergleichsmodi

  • Text: enthält, enthält nicht, beginnt mit, endet mit, ist gleich, ist nicht gleich, ist leer, ist nicht leer
  • Zahl: gleich, ungleich, größer, kleiner, größer/gleich, kleiner/gleich, leer, nicht leer
  • Multi: ist in Liste (Pipe-separiert)

UND / ODER-Verknüpfung

Zwischen Bedingungen lässt sich UND oder ODER wählen - auch in Kombination. Beispiele:

  • Bestand < 5 UND Kategorie „Reduziert"
  • Bestand < 5 UND (Hersteller = „Nike" ODER Hersteller = „Adidas")
  • Aktiv = ja UND Cover-Bild = leer

Variantenartikel-aware

Filter durchforsten automatisch Parent- und Children-Felder. Filterst du nach „Farbe = rot", werden auch Parents mit passenden Variants getroffen.

Spalten konfigurieren

Sichtbare Spalten sind pro User konfigurierbar:

  • Hinzufügen: Plus-Icon oben rechts - alle Felder durchsuchbar
  • Reihenfolge: Drag-and-Drop am Spalten-Header
  • Breite: Drag am Spalten-Rand
  • Sortierung: Klick auf den Spaltenkopf

Alle Einstellungen werden pro User in der Datenbank gespeichert.

Eigene Spalten

Über den Button „Eigene Spalte" (oben rechts in der Spalten-Konfiguration) legst du eine Spalte mit eigenem Namen und Quellfeld an - ein Stammdatenfeld (Erscheinungsdatum, Bestand, Maße, Datumsfelder, …) oder ein beliebiges Zusatzfeld. Die Quellfeld-Auswahl ist ein durchsuchbares Dropdown mit Gruppen (Stammdaten / Zusatzfelder). Optional als sortierbar markierbar (Sortierung über den DAL-Pfad des Feldes per Klick auf den Spaltenkopf). Werte werden automatisch formatiert (Datum deutsch, Ja/Nein bei Boolean). Neue Spalten sind einordbar, entfernbar und werden persistent gespeichert.

Filter- und Spalten-Presets

Häufige Konfigurationen als Preset speichern und mit einem Klick laden:

  • Eigene Presets - nur für den eigenen User
  • Geteilte Presets - für andere User mit gleicher Rolle
  • System-Presets - vom Admin gesetzte Vorlagen, schreibgeschützt

Inline-Bearbeitung

Direkt in der Listing-Zeile editierbar - auch für Varianten:

  • Bestand - Zahlenfeld mit Locale-bewusster Trennung
  • Preis - Brutto-Eingabe mit automatischer Netto-Berechnung
  • EAN, Herstellernummer - Text-Felder
  • Gewicht - Zahlenfeld
  • Aktiv-Status - Toggle-Slider

Änderungen werden lokal gepuffert. Erst Klick auf Speichern in der Bottom-Save-Bar überträgt sie. Tastenkürzel: Enter bestätigt, Esc bricht ab, Tab springt zum nächsten Feld.

Read-back-Verifikation: Nach dem Speichern wird der gespeicherte Wert verifiziert. Wenn Shopware den Wert verwirft - z.B. wegen Vererbungslogik bei Varianten - erscheint ein Warnhinweis statt fälschlich Erfolg.

Quickview-Modal

Pro Zeile öffnet das Quickview-Icon ein kompaktes Modal mit den wichtigsten Stammdaten - ohne Wechsel in die volle Detailansicht. Ideal für serielle Pflege.

Sektionen im Modal

  • Artikel-Basisdaten: Artikelnummer, Name, EAN, MPN, Aktiv-Status
  • Preise: Brutto/Netto, Einkaufspreis, Omnibus-Preis
  • Bestand & Versand: Bestand, Wiederauffüllzeit, Closeout, Versandkostenfrei
  • Bestellmengen: Min/Max/Schrittweite
  • Beschreibung als Textarea
  • SEO: Meta-Title, Meta-Description, Suchbegriffe

Welche Felder pro Sektion sichtbar sind, steuerst du in der Konfigmatrix unter „Quickview". Sektionen ohne aktivierte Felder werden automatisch ausgeblendet - kein leerer Akkordeon-Header.

Variantenanzeige

Variantsartikel werden als Hauptartikel-Zeile dargestellt mit Badge der Variantenzahl. Klick aufs Plus-Icon klappt die Varianten inline darunter aus - Lazy-Loading: Sie werden erst beim Aufklappen geladen.

Kategoriefilter

Neben den frei kombinierbaren Bedingungen gibt es einen eigenen Filter über den Kategoriebaum. Er stellt den Katalog in beliebiger Tiefe dar - auch fünf, sechs oder mehr Ebenen lassen sich aufklappen und auswählen.

Hakst du eine Kategorie an, werden alle darunter liegenden gleich mit ausgewählt; beim Abwählen verschwinden sie entsprechend wieder. Das ist der praktisch wichtige Teil, denn Produkte hängen meist an der untersten Ebene - die Oberkategorie allein hätte nichts gefunden.

Hinweis: Bis Version 1.10.22 endete der Auswahlbaum nach vier Ebenen, und jede Unterkategorie musste einzeln angeklickt werden. Ab 1.10.23 ist beides behoben.

Zusammenspiel der Filter

Alle Filter wirken gemeinsam und schränken die Treffermenge ein - Verkaufskanal, Kategorien, Vollständigkeit, eigene Bedingungen, Warengruppen, Preisspanne, Bilder, Beschreibung, Sichtbarkeit, Eigenschaften und Lieferzeit.

Ist ein eigener Filter gesetzt, sucht das Plugin zusätzlich in den Varianten und holt deren Stammartikel in die Liste, damit ein Treffer nicht übersehen wird, wenn nur eine Variante passt. Der gewählte Verkaufskanal wird dabei ebenfalls berücksichtigt.

Verneinende Bedingungen wie „enthält nicht" oder „ist nicht" wirken bewusst nur auf den Stammartikel. Andernfalls würde eine einzige passende Variante genügen, um einen Artikel in die Liste zu holen, der dem Filter eigentlich widerspricht.

Zur Diagnose: Nach dem Laden der Liste steht die tatsächlich gesendete Abfrage in der Browser-Konsole unter window.stawPimLastCriteria. Damit lässt sich bei mehreren gleichzeitig gesetzten Filtern nachvollziehen, welche Bedingungen wirklich ankommen.

Bildfilter: Hauptartikel oder Varianten

Für Titelbilder gibt es zwei getrennte Filter. "Titelbild (Hauptartikel)" prüft das Bild des Stammartikels, "Titelbild (Varianten)" prüft, ob die Varianten ein eigenes Bild haben.

Der zweite Filter sucht Stammartikel, die mindestens eine Variante ohne eigenes Titelbild haben; die betroffenen Varianten erscheinen darunter. Produktliste, gespeicherte Voreinstellungen und CSV-Export liefern dasselbe Ergebnis.

Hinweis: Bis Version 1.10.27 hießen die Filter "Cover-Bild" und "Variant-Cover" und lieferten beim Variantenfall kein Ergebnis. Beides ist behoben.

Performance bei großen Katalogen

Bei 1000+ Produkten zeichnet der Browser nur sichtbare Zeilen via content-visibility: auto. Spürbar flüssigeres Scrollen ohne sichtbare UI-Änderung. Zusätzlich:

  • Zeilenanzahl wählbar: 10 / 25 / 50 / 100 / 200 / 500
  • Sticky Pagination oben und unten
  • Schnell-zurück-nach-oben-Button
  • Varianten laden schlanker: Beim Aufklappen werden nur die Felder geladen, die die Liste tatsächlich anzeigt, samt Vorschaubild und Varianten-Optionen. Eigene Spalten bleiben berücksichtigt.
  • Vollständigkeit kommt vom Server - nach derselben Vorschrift wie der Vollständigkeitsfilter. Beschreibung und Meta-Texte jeder Variante müssen dafür nicht mehr geladen werden.
  • Laufzeitmessung: Die Zeiten je Ladephase stehen nach dem Laden in der Browser-Konsole unter window.stawPimLastLoadTimings.

Übersetzungen prüfen - Filter und Vollständigkeit

  • Filter „Übersetzung fehlt" in den Varianten Name fehlt, Beschreibung fehlt und Beides fehlt. Die Treffer werden serverseitig gegen genau die gewählte Sprache ermittelt und auf Stammartikel eingegrenzt; leere Texte zählen wie fehlende. Ohne ausdrückliche Sprachwahl gilt die aktive Sprache.
  • Der Filter-Chip nennt die Sprache - zum Beispiel „Übersetzung: Name fehlt (Alpendampf DE)". So ist auf einen Blick nachvollziehbar, worauf sich das Ergebnis bezieht.
  • Sprachvererbung wird berücksichtigt: Liegt ein Text nur bei der übergeordneten Sprache, greift er im Shop - Filter und Vollständigkeit prüfen deshalb die gesamte Sprachkette. Produkte ohne jede Übersetzung in der Kette werden weiterhin zuverlässig gefunden.
  • Vollständigkeit folgt dem Verkaufskanal: Die übersetzbaren Felder werden gegen die Sprache des gewählten Kanals gerechnet; ohne Kanalauswahl gegen die Systemsprache.
  • UVP-Status („UVP fehlt", „UVP kleiner als Brutto") wird serverseitig über den gesamten Bestand ermittelt, sodass Trefferzahl, Blätterung und Ergebnis zusammenpassen.

Weiter geht's

Weiter mit der Mehrfachänderung, dem Herzstück des Plugins - viele Produkte in einem Schritt pflegen.