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 Pflege von Varianten.

Vorschaubild zum Video: Filter und Presets Video · 1:25 Min.Filter und PresetsDie Funktion in Aktion sehen, mit eingeblendeten Erklärungen.Video ansehen →

Aufbau der Ansicht

Das Listing besteht aus diesen Bereichen:

  • Filter - Schnellfilter, Kategoriebaum, Verkaufskanal und frei definierbare eigene Filter
  • Spaltenkopf - Sortierung per Klick auf die Spalte
  • Datenzeilen - pro Produkt eine Zeile, Varianten lassen sich darunter aufklappen
  • Aktionen - Mehrfachänderung, CSV-Import/Export, Feed-Generator und Kategorien
  • Blätterung - 10, 25, 50 oder 100 Zeilen pro Seite

Filter mit UND / ODER

Ein eigener Filter besteht aus Feld, Operator und Wert. Du kannst beliebig viele Filter anlegen und einzelne vorübergehend deaktivieren, ohne sie zu löschen.

Operatoren je Feldtyp

  • Text (8): enthält, enthält nicht, ist genau, ist nicht, beginnt mit, endet auf, ist leer, ist nicht leer
  • Zahl (8): =, ≠, >, <, ≥, ≤, ist leer, ist nicht leer
  • Ja/Nein (2): ist aktiv, ist inaktiv

Filterbare Felder: Artikelnummer, Name, Beschreibung, Meta-Description, Meta-Titel, Suchbegriffe, EAN/GTIN, Hersteller-Artikelnr. (MPN), Verpackungseinheit, Lagerbestand, Verfügbar, Preis, Gewicht, Breite, Höhe, Länge, Anzahl Varianten, Status (aktiv) und Topseller-Markierung.

UND / ODER-Verknüpfung

Für den Filtersatz wählst du einen Modus: UND - Produkte müssen alle aktiven Filter erfüllen - oder ODER - Produkte müssen mindestens einen erfüllen. Verschachtelte Klammer-Gruppen gibt es nicht. Beispiele:

  • UND: Lagerbestand < 5 und Status ist aktiv
  • ODER: Beschreibung ist leer oder Meta-Titel ist leer

Variantenartikel-aware

Filter durchsuchen auch die Varianten. Passt nur eine Variante, holt das PIM ihren Stammartikel in die Liste (siehe Zusammenspiel der Filter).

Spalten konfigurieren

Die sichtbaren Spalten legst du zentral in der Konfigmatrix fest: Tab Allgemein → „Sichtbare Spalten in der Produktliste". Die Einstellung gilt für alle Benutzer.

  • Ein- und ausblenden: per Schalter je Spalte; Artikelnummer und Name sind immer sichtbar
  • Reihenfolge: über die Schaltflächen „Nach oben" und „Nach unten"
  • Sortierung: in der Liste per Klick auf den Spaltenkopf

Eigene Spalten

Über „Eigene Spalte hinzufügen" in derselben Spaltenkonfiguration 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; bei Zusatzfeldern hängt das vom Feldtyp ab. Werte werden automatisch formatiert (Datum, Ja/Nein bei Boolean). Neue Spalten sind einordbar, entfernbar und werden in der Konfiguration gespeichert.

Filter-Presets

Häufige Filterkombinationen speicherst du als Preset und lädst sie mit einem Klick:

  • Für alle Benutzer: Presets liegen in der Datenbank des Shops und stehen jedem Benutzer zur Verfügung, eine Trennung nach Benutzer gibt es nicht
  • Schnellfilter: ein Preset kann als Schnellfilter direkt über der Liste erscheinen
  • Weiterverwendung: Presets dienen als Quelle für die Mehrfachänderung, für Feeds und für die Produktzuordnung von Kategorien

Mit „Filter dauerhaft setzen" (Konfigmatrix → Allgemein) bleiben gesetzte Filter beim nächsten Aufruf erhalten, optional samt Suchbegriff.

Inline-Bearbeitung

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

  • Bestand - Zahlenfeld
  • Preis - Brutto-Eingabe, der Nettowert wird über den Steuersatz berechnet
  • EAN und Herstellernummer - Textfelder
  • Gewicht - Zahlenfeld in kg
  • Aktiv-Status - Schalter

Gespeichert wird sofort, sobald du das Feld verlässt, eine Meldung bestätigt das Speichern. Geerbte Werte einer Variante werden hervorgehoben dargestellt. Das Aktiv-Schalten lässt sich über den Funktionsschalter „Aktiv/Inaktiv setzen" für normale Benutzer sperren.

Quickview-Modal

Ein Klick auf eine Variante im Listing öffnet ein kompaktes Modal mit ihren Stammdaten - ohne Wechsel in die volle Detailansicht. Ideal für serielle Pflege von Varianten. Mit gedrückter Strg- bzw. ⌘-Taste öffnet sich der Artikel in einem neuen Tab.

Sektionen im Modal

  • Artikel-Basisdaten: Artikelnummer, Name, EAN/GTIN, MPN, Aktiv/Inaktiv
  • Preise: brutto und netto, Einkaufspreis, Pseudopreis, günstigster Preis 30 Tage (Omnibus)
  • Beschreibung
  • Lieferbarkeit & Maße: Lagerbestand, Wiederauffüllzeit, Abverkauf, Versandkostenfrei, Lieferzeit, Verkaufs- und Grundpreiseinheiten, Mindest- und Maximalabnahme, Staffelung, Gewicht und Maße, Erscheinungsdatum
  • SEO: Meta-Titel, Meta-Beschreibung, Suchbegriffe

Welche Felder erscheinen, steuerst du in der Konfigmatrix im Tab Varianten unter „Quickview-Felder (Varianten-Bearbeitung im Listing)".

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.

Fehlende Texte je Sprache

Der Filter zeigt Artikel, bei denen in einer bestimmten Sprache Text fehlt. Wählbar sind Name, Beschreibung, Meta-Title, Meta-Description und Keywords; ein Artikel zählt schon dann, wenn eines der gewählten Felder leer ist. Der Dialog schlüsselt die Treffer je Feld auf.

Vererbung zwischen Sprachen zählt als vorhanden - Deutsch (Schweiz) erbt von Deutsch. Auf die Systemsprache wird bewusst nicht ausgewichen: Ein Text, der nur dort steht, gilt als fehlend.

Varianten, die aus dem Kanal fallen

Sobald eine Variante eigene Sichtbarkeitszeilen hat, ersetzen sie die des Stammartikels vollständig. Fehlt dort der Verkaufskanal, ist die Variante im Shop nicht auffindbar - an der Variante selbst sieht man das nicht.

Der Filter „Variante im Verkaufskanal" deckt genau diese Fälle auf, wahlweise „Variante fehlt im gewählten Kanal" oder „Variante niedriger sichtbar als der Artikel". Schließen lässt sich die Lücke über „Sichtbarkeit auf Varianten übertragen", einzeln in den Stammdaten oder für viele Artikel in der Mehrfachänderung.

Filter wirken auch auf Varianten

Rund zwanzig weitere Filter greifen inzwischen auch auf den Variantenzeilen: Status, Bestand, Preis und Preisstatus, Gewicht, EAN, Bilder und Titelbild, Hersteller, Steuersatz, Abverkauf, Versandkostenfrei, Topseller, Lieferzeit und die Artikelnummernliste. Geerbte Werte zählen dabei mit - eine Variante ohne eigenen Preis trägt den des Stammartikels.

Trefferzahl am Chip: Die serverseitig ermittelten Filter zeigen ihre Trefferzahl direkt am Chip, etwa „Titelbild (Varianten): Varianten ohne eigenes Bild (0)". Eine leere Liste ließ vorher offen, ob es keine Treffer gibt oder etwas schiefging.

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 (Standard in der Konfigmatrix unter Allgemein)
  • Scroll-to-Top-Button, abschaltbar in der Konfigmatrix
  • 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.

Häufige Fragen

Wie viele Filterbedingungen sind möglich?

Beliebig viele. Je Filtersatz verknüpfst du sie entweder mit UND oder mit ODER. Textfelder bieten 8 Operatoren, Zahlenfelder 8 und Ja/Nein-Felder 2.

Werden Varianten beim Filtern berücksichtigt?

Ja. Die Suche prüft Felder von Stammartikeln und Varianten und findet auch Stammartikel, deren Varianten passen.

Kann ich Werte direkt in der Liste ändern?

Ja. Bestand, Preis, EAN, Herstellernummer und Gewicht lassen sich direkt in der Zeile bearbeiten, auch bei Varianten.

Bleibt die Liste bei vielen Produkten schnell?

Ja. Der Browser zeichnet nur den sichtbaren Bereich, Varianten werden erst beim Aufklappen geladen, und die Seitengröße lässt sich auf 10 bis 100 Zeilen einstellen.