HUSKY - WooCommerce Product Filter Professional

WooCommerce Filter nach Größe zeigt ausverkaufte Variationen: Lösung

Ein Kunde wählt die Größe M, und der WooCommerce Filter nach Größe zeigt ein T-Shirt, dessen Variation M nicht auf Lager ist. Auf der Produktseite steht dann, dass die Größe ausverkauft ist, und der Kunde geht. Der Filter ist nicht kaputt: Standardmäßig beurteilt er ein variables Produkt nach seinem übergeordneten Produkt, genau wie WooCommerce, und das übergeordnete Produkt bleibt auf Lager, solange eine seiner Variationen es ist. Im Folgenden: warum der Filter nicht vorrätige Variationen anzeigt, welche HUSKY-Einstellung ihn den Lagerbestand der gewählten Größe prüfen lässt, nach welchen Regeln diese Prüfung arbeitet und was Sie korrigieren, wenn Ergebnisse oder Zähler weiterhin falsch sind.

Warum der Filter nach Größe ausverkaufte Variationen anzeigt

In WooCommerce besteht ein variables Produkt aus zwei Arten von Datensätzen. Das übergeordnete Produkt ist das, was Shop- und Kategorieseiten auflisten. Sein Tab Attribute (Attributes) enthält die Werte (Größe: S, M, L; Farbe: schwarz, rot), und diese Werte sind dem übergeordneten Produkt als Attribut-Begriffe zugeordnet. Jede Variation, etwa M / schwarz, ist ein eigener Datensatz mit eigenem Preis und eigenem Lagerbestand.

Ein Filter nach Attributen sucht übergeordnete Produkte, die den gewählten Begriff haben. Führt das T-Shirt M in seinem Tab Attribute (Attributes) auf, passt es zur Größe M, ganz gleich, wie der Lagerbestand der Variation M aussieht. Auch der Lagerstatus des übergeordneten Produkts hilft nicht: WooCommerce hält ihn auf Auf Lager (In stock), solange mindestens eine Variation auf Lager ist (oder auf Auf Lieferrückstand (On backorder), wenn eine auf Lieferrückstand ist), und setzt ihn erst auf Nicht auf Lager (Out of stock), wenn jede Variation ausverkauft ist. Aus demselben Grund löst auch die WooCommerce-Option Nicht vorrätige Artikel im Katalog ausblenden (Hide out of stock items from the catalog) (WooCommerce → Settings → Products → Inventory) das Problem nicht: Sie blendet das T-Shirt erst aus, wenn alle seine Größen weg sind. Die Frage „Ist Größe M verfügbar?“ muss an die Variationen gestellt werden, und der Filter stellt sie nur, wenn Sie es ihm sagen.

HUSKY den Lagerbestand der gewählten Größe prüfen lassen

Die Variationsprüfung gehört zum Element Auf Lager (In stock). In HUSKY 3.4.6 ist es eine eingebaute Erweiterung, die immer aktiv ist; im Tab Erweiterungen (Extensions) ist also nichts einzuschalten.

  1. Öffnen Sie WooCommerce → Settings → Products Filter, Tab Struktur (Structure), und suchen Sie die Zeile Auf Lager (In stock). Setzen Sie sie auf Ja (Yes), wenn Kunden die Checkbox sehen sollen.
  2. Klicken Sie auf den Zahnrad-Button daneben (Zusatzoptionen (additional options)). Setzen Sie im sich öffnenden Fenster die erste Einstellung, Suche in variablen Produkten (Search in variable produts), auf Suche in Produkten und deren Variationen (Search in products and their variations). Der Standardwert Nur einfache Produkte (Simple products only) betrachtet nur den eigenen Lagerstatus jedes Produkts, der bei einem variablen Produkt der des übergeordneten ist.
  3. Lassen Sie Neue DB verwenden (Use new DB.) auf Ja (Yes) und wählen Sie unter Ansicht (View) Checkbox oder Schalter (Switcher).
  4. Speichern Sie, leeren Sie den Seiten-Cache und testen Sie: Wählen Sie eine Größe, von der Sie wissen, dass sie bei einem Produkt ausverkauft ist, setzen Sie das Häkchen bei Auf Lager (In stock), und dieses Produkt sollte aus den Ergebnissen verschwinden.

Die Prüfung läuft nur, solange Auf Lager (In stock) Teil der Suche ist und mindestens ein Produktattribut (eine pa_-Taxonomie wie Größe oder Farbe) ausgewählt ist. Ohne Auf Lager (In stock) bleibt die Attributfilterung am übergeordneten Produkt orientiert. Die Einstellung verursacht zusätzliche Datenbankarbeit und ist deshalb standardmäßig aus; siehe den Abschnitt zur Geschwindigkeit weiter unten.

„Auf Lager“ ohne Checkbox anwenden

Sollen ausverkaufte Größen nie passen, müssen Sie sich nicht darauf verlassen, dass Kunden das Kästchen anhaken. Der Filter woof_get_request_data kann die Bedingung „auf Lager“ zu jeder Suche hinzufügen, die das Plugin ausführt:

/*
 * HUSKY: always search in-stock products only.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_get_request_data', function ($data) {
    $data['stock'] = 'instock';
    return $data;
});

Das entfernt außerdem nicht vorrätige einfache Produkte und vollständig ausverkaufte variable Produkte aus jeder Produktliste, die der Filter steuert, wie im FAQ zum ausschließlichen Anzeigen lieferbarer Produkte beschrieben. Setzen Sie die Zeile Auf Lager (In stock) auf Nein (No), damit Kunden keine Checkbox sehen, die immer angehakt ist.

Sollen nicht vorrätige Produkte beim Stöbern sichtbar bleiben und erst herausfallen, wenn nach einem Attribut gefiltert wird, fügen Sie die Bedingung nur hinzu, wenn ein Attribut in der Suche vorkommt:

/*
 * HUSKY: apply In stock only when a product attribute (pa_*) is being filtered.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_get_request_data', function ($data) {
    foreach (array_keys($data) as $key) {
        if (strpos($key, 'pa_') === 0) {
            $data['stock'] = 'instock';
            break;
        }
    }
    return $data;
});

Wie die Variationsprüfung entscheidet

Mit Neue DB verwenden (Use new DB.) auf Ja (Yes) liest HUSKY die Attribut-Lookup-Tabelle von WooCommerce, in der jede Variation für jeden ihrer Attributwerte eine Zeile samt Lager-Kennzeichen („auf Lager“) hat. Für jedes variable Produkt sammelt es die Variationen, die einen der gewählten Werte tragen, und entfernt das Produkt, wenn solche Variationen existieren und keine davon auf Lager ist. Diese Regel erklärt die Ergebnisse, die zunächst seltsam wirken:

ProduktSucheErgebnis
S auf Lager, M ausverkauftGröße M + Auf LagerAusgeblendet
S auf Lager, M ausverkauftGröße S oder M + Auf LagerAngezeigt: S ist verfügbar
M im Tab Attribute (Attributes) aufgeführt, aber es gibt keine Variation MGröße M + Auf LagerAngezeigt: Eine Variation M, die nicht vorrätig sein könnte, gibt es nicht
Eine Variation auf Beliebige Größe (Any Size) gesetzt, auf LagerGröße L + Auf LagerAngezeigt: Eine Variation Beliebige Größe (Any Size) zählt für jede am Produkt aufgeführte Größe
M / schwarz ausverkauft, M / rot und S / schwarz auf LagerGröße M + Farbe schwarz + Auf LagerAngezeigt: Jeder gewählte Wert hat eine Variation auf Lager
Variation M Auf Lieferrückstand (On backorder)Größe M + Auf LagerAngezeigt: Lieferrückstand gilt als verfügbar

Die dritte Zeile ist ein Datenproblem, kein Filterproblem. Ein Wert, der im Tab Attribute (Attributes) des übergeordneten Produkts stehen bleibt, nachdem Sie seine Variation gelöscht haben, oder der nie für eine Variation verwendet wurde, passt weiterhin und wird weiter mitgezählt. Behalten Sie nur die Werte, zu denen es Variationen gibt, oder legen Sie die Variation an und markieren Sie sie als Nicht auf Lager (Out of stock).

Die letzten beiden Zeilen sind die Grenzen der Prüfung. Werte verschiedener Attribute werden einzeln geprüft, nicht als genaue Kombination, die der Kunde gewählt hat; ein Produkt kann also weiterhin erscheinen, wenn genau diese eine Kombination ausverkauft ist. Variationen auf Lieferrückstand sind kaufbar, daher behält Auf Lager (In stock) sie; sollen sie ebenfalls nicht passen, fügen Sie das Element Produkte auf Lieferrückstand ausschließen hinzu, das dieselbe Einstellung Suche in Produkten und deren Variationen (Search in products and their variations) hat. Prüfen Sie außerdem, was ein Import tatsächlich geschrieben hat: Eine Variation, die als Auf Lieferrückstand (On backorder) statt als Nicht auf Lager (Out of stock) gespeichert wurde, bleibt in den Ergebnissen.

Ergebnisse weiterhin falsch: Die WooCommerce-Lookup-Tabelle aktualisieren

Die Lookup-Tabelle (wc_product_attributes_lookup) gehört WooCommerce. Sie wird aktualisiert, wenn ein Produkt oder eine Variation über WooCommerce gespeichert wird, standardmäßig mit kurzer Verzögerung: WooCommerce plant die Aktualisierung als Hintergrundaktion ein. Die Tabelle hinkt hinterher, wenn:

  • der Lagerbestand durch einen Import oder ein Synchronisierungs-Tool geändert wird, das direkt in die Datenbank schreibt, statt Produkte über WooCommerce zu speichern;
  • Hintergrundaktionen nicht laufen, zum Beispiel weil WP-Cron deaktiviert ist, ohne dass ein Server-Cron ihn ersetzt. Ausstehende Aktionen mit dem Hook woocommerce_run_product_attribute_lookup_update_callback stauen sich dann unter WooCommerce → Status → Scheduled Actions;
  • eine vollständige Neugenerierung der Tabelle unterbrochen wurde.

Der Filter arbeitet dann mit alten Lagerdaten, und die Ergebnisse wirken zufällig. Um die Tabelle neu aufzubauen, öffnen Sie WooCommerce → Status → Tools und klicken Sie neben Lookup-Tabelle der Produktattribute neu generieren (Regenerate the product attributes lookup table) auf Neu generieren (Regenerate). Sie läuft in Stapeln im Hintergrund; die Schaltfläche zeigt Befüllung läuft (Filling in progress) mit einem Zähler an, bis sie fertig ist. Dieselben Werkzeuge behandelt das FAQ zu nicht funktionierenden Preis- und Lagerfiltern. Ändert sich der Lagerbestand häufig, ziehen Sie WooCommerce → Settings → Products → Advanced → Lookup-Tabelle der Produktattribute (Product attributes lookup table) → Direkte Aktualisierungen (Direct updates) in Betracht, was die Tabelle genau in dem Moment aktualisiert, in dem ein Produkt gespeichert wird.

Zum Testen oder wenn sich die Tabelle nicht aktuell halten lässt, setzen Sie Neue DB verwenden (Use new DB.) auf Nein (No). HUSKY liest dann die Variationen selbst (ihre Werte _stock_status und attribute_pa_…). Das ist bei vielen Variationen langsamer und folgt einer strengeren Regel: Ein Produkt wird entfernt, wenn irgendeine Variation mit einem gewählten Wert nicht vorrätig ist; „Größe S oder M“ blendet das T-Shirt aus der obigen Tabelle also aus. Um dieselbe Regel wie mit der Lookup-Tabelle zu erhalten, fügen Sie hinzu:

/*
 * HUSKY, In stock with "Use new DB." = No: keep a variable product when at least
 * one variation with a selected value is in stock.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_exclude_existing_variations', '__return_true');

Zähler, die nicht vorrätige Variationen einschließen

Die Zahlen neben den Größen stammen aus denselben Abfragen wie die Ergebnisse und folgen daher denselben Regeln.

  • Ohne Auf Lager (In stock) in der Suche enthält der Zähler für M jedes Produkt, das M am übergeordneten Produkt hat, ausverkauft oder nicht. Ist Auf Lager (In stock) aktiv (angehakt oder mit dem obigen Snippet erzwungen) und die Variationssuche eingeschaltet, wird jede Größe mit der Variationsprüfung für diese Größe gezählt.
  • Fügen Sie Dynamische Nachzählung (Dynamic recount) und Leere Begriffe ausblenden (Hide empty terms) (Tab Optionen (Options)) hinzu, und eine Größe, deren Zähler auf null fällt, verschwindet aus dem Filter, sodass ausverkaufte Größen gar nicht mehr angeboten werden.
  • Blendet WooCommerce nicht vorrätige Artikel aus, lassen Sie Sichtbarkeit des Listenkatalogs (Listen catalog visibility) (Advanced → Options) auf Ja (Yes). Mit Nein (No) enthalten die Zähler auch die Produkte, die WooCommerce ausblendet, und ein Begriff kann einen Zähler anzeigen, während seine Ergebnisse leer sind.
  • Mit Cachen Sie die dynamische Nachzählungsnummer für jedes Element im Filter (Cache dynamic recount number for each item in filter) (Advanced → Options) werden Zähler gespeichert und folgen Lageränderungen nicht, bis der Cache automatisch oder mit der Schaltfläche Cache leeren (clear cache) geleert wird. Auch ein Seiten-Cache kann alte Zahlen ausliefern.

Geschwindigkeit: Der Preis der Variationsprüfung

Jede Suche, die ein Attribut mit Auf Lager (In stock) kombiniert, führt zusätzliche Abfragen aus: zwei auf der Lookup-Tabelle mit Neue DB verwenden (Use new DB.) auf Ja (Yes), oder eine über alle passenden Variationen mit Nein (No). Mit Dynamische Nachzählung (Dynamic recount) läuft die Prüfung zudem für jeden Wert, der einen Zähler bekommt; ein Filter mit 40 Größen und Farben wiederholt sie also 40-mal pro Seite. Bei Zehntausenden Variationen ist das spürbar.

  • Lassen Sie Neue DB verwenden (Use new DB.) auf Ja (Yes) und halten Sie die Lookup-Tabelle aktuell; das ist die schnellere Methode.
  • Aktivieren Sie Cachen Sie die dynamische Nachzählungsnummer für jedes Element im Filter (Cache dynamic recount number for each item in filter) und wählen Sie ein Intervall für die automatische Leerung, das dazu passt, wie schnell sich Ihr Lagerbestand ändert.
  • Weitere Möglichkeiten finden Sie unter Produktfilterung in großen Katalogen beschleunigen.

Der Turbo-Modus ist hier keine Abkürzung. Er filtert im Browser des Besuchers anhand einer vorab erzeugten Datei, und seine Prüfung Auf Lager (In stock) betrachtet nur den eigenen Lagerstatus jedes Produkts: Die Variationseinstellung hat dort keine Wirkung, und Lageränderungen erscheinen erst, nachdem die Datei neu aufgebaut wurde. Dürfen ausverkaufte Größen nicht passen, lassen Sie den Turbo-Modus ausgeschaltet; seine weiteren Einschränkungen sind in der Fehlerbehebung für den Turbo-Modus aufgeführt.

Checkliste

  • Auf Lager (In stock) → Zahnrad → Suche in Produkten und deren Variationen (Search in products and their variations) ausgewählt und gespeichert.
  • Auf Lager (In stock) ist Teil der Suche: vom Kunden angehakt oder mit woof_get_request_data erzwungen.
  • Variable Produkte führen nur die Attributwerte auf, zu denen es Variationen gibt.
  • Ausverkaufte Variationen haben den Status Nicht auf Lager (Out of stock), nicht Auf Lieferrückstand (On backorder).
  • Die Lookup-Tabelle wurde nach Importen neu generiert, und in Scheduled Actions hängen keine Lookup-Aktualisierungen fest.
  • Nachzähl-Cache und Seiten-Cache nach Lageränderungen geleert; Turbo-Modus aus.

Liefert der Filter weiterhin ein Produkt, dessen gewählte Größe ausverkauft ist, eröffnen Sie im HUSKY-Support-Forum ein Thema mit dem Filterlink, dem Produkt und dem Lagerstatus seiner Variationen.