HUSKY - WooCommerce Product Filter Professional

HUSKY Turbo Mode funktioniert nicht: Ausgegrauter Filter, fehlende Produkte

Wenn der HUSKY Turbo Mode nicht funktioniert, wirken die Symptome auf den ersten Blick unzusammenhängend: Der Filter bleibt ausgegraut, eine Kategorie liefert keine Produkte, neue Produkte erscheinen nie, die Anzahlen stimmen nicht, oder der AJAX-Modus lässt sich nicht ausschalten. Fast alle gehen auf eine einzige Entwurfsentscheidung zurück: Im Turbo Mode läuft die Filterung im Browser des Besuchers, und zwar gegen eine vorab erstellte Datei mit Produktdaten. Im Folgenden steht, wie diese Datei entsteht und verwendet wird, und wie Sie jedes Symptom beheben.

So funktioniert der Turbo Mode und wann er sich lohnt

Im normalen Modus führt der Server bei jedem Filterklick eine WooCommerce-Abfrage aus und zählt die Produkte für jeden Begriff. Der Turbo Mode verlagert diese Arbeit in den Browser. HUSKY schreibt alle veröffentlichten Produkte und ihre Varianten in eine einzige JSON-Datei (standardmäßig in wp-content/uploads/uploads_woof_turbo_mode/) mit ID, Titel, SKU, Preisen, Lagerstatus, den Begriffen jeder Produkttaxonomie und den Werten der Meta-Filterfelder. Der Browser lädt sie auf jeder Frontend-Seite herunter, auf der das Plugin läuft (beschränken Sie diese Seiten mit Plugin nur auf den nächsten Seiten der Website initialisieren (Init plugin on the next site pages only) auf dem Tab Erweitert (Advanced)), findet die passenden Produkte und zeichnet die Anzahlen; der Server rendert nur noch die gefundenen Produkte anhand ihrer IDs.

Die Ergebnisse sind also nur so aktuell wie die Datei, ein Produkt, das in ihr fehlt, kann nicht gefunden werden, es werden nur Bedingungen angewendet, die der Browser versteht, und jeder Besucher lädt den gesamten Katalog herunter, was bei Zehntausenden von Produkten und Varianten Megabytes und einen langsamen Start auf Smartphones bedeutet. Der Turbo Mode lohnt sich bei einem schwachen Server mit einem mittelgroßen Katalog, der sich selten ändert. Wenn der Server die Abfragen bewältigen kann, probieren Sie zuerst den normalen Modus mit den Caches aus, die in So beschleunigen Sie die Produktfilterung in großen Katalogen beschrieben sind.

In der richtigen Reihenfolge einschalten

  1. WooCommerce → Einstellungen → Products Filter → Erweiterungen (Extensions): Setzen Sie ein Häkchen bei Turbo-Modus (Turbo mode) und speichern Sie.
  2. Erweitert (Advanced) → Turbo-Modus (Turbo mode): Stellen Sie Turbomodus aktivieren (Enable turbo mode) auf Ja (Yes) und speichern Sie.
  3. Klicken Sie unter Stellen Sie die Produktdaten jetzt neu zusammen! (Reassemble products data now!) auf Jetzt aktualisieren! (Update now!) und lassen Sie die Seite geöffnet, bis Datei aktualisiert!!! (File updated!!!) erscheint. Ohne die Datei kann der Filter nicht suchen.
  4. Wählen Sie den WordPress-Cron-Zeitraum (WordPress Cron period) und den Speicherort der Produktdatendatei (Where to keep products data file) und speichern Sie.
  5. Stellen Sie im Tab Optionen (Options) Anzahl anzeigen (Show count), Dynamische Nachzählung (Dynamic recount) und Leere Begriffe ausblenden (Hide empty terms) ein, die im Turbo Mode eigene Kopien sind (siehe unten), und leeren Sie dann den Seiten-Cache und einen eventuellen CDN-Cache.

Der Filter ist ausgegraut und wird nie anklickbar

Die graue Ebene ist ein Element mit der Klasse woof_turbo_mode_overlay. Es deckt den Filter von Anfang an ab, und das Turbo-Mode-Skript entfernt es, sobald die Datei geladen und die Anzahlen gezeichnet sind. Bleibt die Ebene bestehen, wurde dieses Skript nicht fertig ausgeführt:

  • Skripte verzögert, aufgeschoben oder zusammengefasst. Optimierungsfunktionen in WP Rocket, LiteSpeed Cache und ähnlichen Plugins können die Skripte zu spät, in falscher Reihenfolge oder gar nicht starten. Der Turbo Mode benötigt ext/turbo_mode/js/turbo_mode.js und ext/quick_search/js/alasql/alasql.min.js aus wp-content/plugins/woocommerce-products-filter/, und zwar nach jQuery. Schließen Sie den Plugin-Ordner von Verzögerung, Aufschub und Zusammenfassung aus und leeren Sie dann alle Caches; der Filter mit WP Rocket und Caching erklärt die Ausnahmen.
  • Ein JavaScript-Fehler. Öffnen Sie die Browser-Konsole (F12) und laden Sie die Seite neu. Der erste rote Fehler nennt das Skript, das die übrigen gestoppt hat.
  • Eine große Datei bei langsamer Verbindung. Prüfen Sie im Tab „Netzwerk“ (Network) Größe und Ladezeit von data_0000_xxx.json. Hält der Download den Filter über mehrere Sekunden grau, ist der Katalog für den Turbo Mode zu groß.

Die Ebene per CSS auszublenden (.woof_turbo_mode_overlay{display:none;}) verbirgt nur das Symptom: Der Filter wird zwar anklickbar, kann ohne geladene Datei aber nicht suchen.

Lässt sich die Datei nicht laden, wird der Filter durch den Hinweis Oh nein! Es sieht so aus, als könne der Filter die Suchdatei nicht öffnen. (Oh no! It looks like the filter can't open the search file.) ersetzt. Prüfen Sie Folgendes:

  • Die Datei existiert. Eine Datei im Plugin-Ordner (plugins\woocommerce-products-filter\ext\turbo_mode\data) wird bei jedem Plugin-Update gelöscht; erstellen Sie sie daher nach Updates neu oder speichern Sie sie in wp-uploads\uploads_woof_turbo_mode;
  • keine Serverregel und kein Sicherheits-Plugin blockiert .json-Dateien in Uploads: Rufen Sie die Dateiadresse aus dem Tab „Netzwerk“ direkt auf;
  • die Adresse stimmt. Das Plugin fordert wp-content/uploads/uploads_woof_turbo_mode/ an, daher liefert die Anfrage bei einer Multisite-Unterseite oder bei verschobenem Uploads-Ordner einen 404-Fehler. Behalten Sie die Datei in diesem Fall im Plugin-Ordner.

Keine Produkte gefunden oder Produkte fehlen nach dem Filtern

Der Turbo Mode liefert nur Produkte, die in der Datei stehen, und gleicht sie mit den dort gespeicherten Daten ab. Prüfen Sie beides in der Browser-Konsole, auf einer Seite mit dem Filter, nachdem dieser geladen wurde:

woof_turbo_mode_file.length                  // records in the file: products + variations
woof_turbo_mode_file.find(p => p.id == 123)  // what is stored for product 123

Vergleichen Sie die erste Zahl mit Ihren veröffentlichten Produkten plus Varianten; mit WP-CLI liefert sie wp post list --post_type=product,product_variation --post_status=publish --format=count. Gibt ein Produkt undefined zurück, steht es nicht in der Datei. Ist es vorhanden, sehen Sie sich seine taxonomies und seinen stock an.

Die Datei ist veraltet

Neue Produkte, geänderte Kategorien, Attribute, Preise und Lagerbestände erreichen den Filter erst mit der nächsten Neuerstellung. Typische Anzeichen: Ein neues Produkt wird auf der Shopseite aufgelistet, verschwindet aber nach dem ersten Filterklick, neue Begriffe zeigen die Anzahl 0, die letzten Seiten der Seitennummerierung sind leer, oder ein nach der letzten Neuerstellung hinzugefügtes Meta-Filterelement findet nichts. Erstellen Sie die Datei nach Importen und nach Änderungen an den Elementen des Filters neu.

Das Limit von 15.000

Jetzt aktualisieren! (Update now!) stoppt nach 15.000 Datensätzen, und Varianten zählen mit. Ein Shop mit 2.000 variablen Produkten zu je acht Varianten kommt bereits auf 18.000. Die Schaltfläche verarbeitet die neuesten Produkte zuerst, die ausgelassenen Produkte sind also Ihre ältesten. Steht der Zähler neben der Schaltfläche bei Produkte und Varianten: 15000 (Products and Variants: 15000), haben Sie das Limit erreicht. Erhöhen Sie es mit dem Hook woof_turbo_mode_products_limit und erstellen Sie die Datei neu:

/*
 * HUSKY Turbo mode: let "Update now" write up to 40,000 products and variations.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_turbo_mode_products_limit', function ($limit) {
    return 40000;
});

Die geplante Neuerstellung wird durch diesen Hook nicht begrenzt; sie verarbeitet den gesamten Katalog.

Produkte in Unterkategorien werden nicht gefunden

Die Datei speichert nur die Kategorien, die bei jedem Produkt angehakt sind, und der Browser vergleicht sie wörtlich; den Kategoriebaum kennt er nicht. WordPress zeigt Produkte von Unterkategorien in einer übergeordneten Kategorie an, der Turbo Mode jedoch nicht: Ein Produkt, das nur in Laufschuhe angehakt ist, wird auf der Seite „Schuhe“ bis zum ersten Filterklick aufgelistet und verschwindet dann, der Filterbegriff „Schuhe“ findet es nicht, und die Anzahl bei „Schuhe“ lässt es aus. Haken Sie bei solchen Produkten jede Ebene der Kette an (Schuhe und Laufschuhe), zum Beispiel mit der Massenbearbeitung unter Produkte → Alle Produkte, und erstellen Sie dann die Datei neu.

Ausgeblendete und nicht vorrätige Produkte

Produkte, deren Sichtbarkeit im Katalog (Catalog visibility) auf Nur Shop (Shop only) oder Ausgeblendet (Hidden) steht, gelten als von der Suche ausgeschlossen, und der Turbo Mode gibt sie nach dem Filtern nie zurück, unabhängig von Sichtbarkeit des Listenkatalogs (Listen catalog visibility). Ein Produkt mit Nur Shop erscheint daher auf der Shopseite und verschwindet nach dem ersten Klick; stellen Sie es auf Shop und Suchergebnisse (Shop and search results), wenn es filterbar sein soll. Ist die WooCommerce-Option Nicht vorrätige Artikel im Katalog ausblenden (Hide out of stock items from the catalog) aktiviert, werden nicht vorrätige Produkte nicht in die Datei geschrieben, und ein Produkt, das wieder vorrätig ist, fehlt bis zur nächsten Neuerstellung weiterhin.

WPML-Sprachen

Mit WPML schreibt HUSKY pro Sprache eine Datei (data_0000_en.json, data_0000_de.json) und lädt die Datei der aktuellen Sprache. Ein Produkt ohne Übersetzung fehlt in der Datei dieser Sprache; erstellen Sie die Datei daher nach dem Übersetzen neu.

Die Suchdatei aktuell halten

Jetzt aktualisieren! (Update now!) erstellt die Datei in Stapeln zu zehn Produkten oder Varianten, höchstens einen Stapel pro Sekunde, mit einem Zähler Produkte und Varianten (Products and Variants). Jeder Stapel schreibt die gesamte Datei neu, 15.000 Datensätze dauern also mindestens 25 Minuten. Anders als die geplante Neuerstellung löscht die Schaltfläche zuerst die aktuelle Datei, und bis sie fertig ist, filtert die Website mit unvollständigen Daten: Führen Sie sie zu einer ruhigen Zeit aus, lassen Sie die Seite geöffnet und schalten Sie den Turbo Mode nicht mittendrin aus.

Der WordPress-Cron-Zeitraum (WordPress Cron period) legt die automatische Neuerstellung fest: täglich (daily), wöchentlich (weekly) (Standard), zweimal im Monat (twicemonthly), monatlich (monthly), min1 oder ohne Update (without update). Trotz des Namens ist dies kein WP-Cron-Ereignis. HUSKY führt einen eigenen Zeitplan (die Option woof_turbo_init_wpcrone_): Ist eine Neuerstellung fällig, fügt jede Anfrage, die WordPress mit dem Plugin lädt, höchstens einmal alle fünf Sekunden die nächsten zehn Datensätze zu einer temporären Datei hinzu, die nach dem letzten Stapel die aktive Datei ersetzt. Bis dahin behalten die Besucher die bisherigen Daten. Daraus folgt:

  • WP Crontrol und ähnliche Werkzeuge führen sie nicht auf, und DISABLE_WP_CRON hält sie nicht an.
  • Die Geschwindigkeit hängt von Anfragen ab, die PHP erreichen; aus einem Seiten-Cache ausgelieferte Seiten zählen nicht. 20.000 Datensätze erfordern mindestens 2.000 Anfragen im Abstand von fünf Sekunden, also fast drei Stunden gleichmäßigen Traffic, auf einer ruhigen Website Tage.
  • Die erste automatische Neuerstellung erfolgt einen vollen Zeitraum nach dem Speichern des Zeitplans; klicken Sie daher nach dem Aktivieren auf Jetzt aktualisieren!.
  • Der Zeitraum wird ab dem Ende der vorherigen Neuerstellung gezählt. min1 startet die nächste eine Minute später, die Website baut also ständig neu auf; verwenden Sie das nur für kleine Kataloge.
  • Ein Klick auf Jetzt aktualisieren! während einer automatischen Neuerstellung löscht auch deren temporäre Datei; sobald der automatische Lauf endet, ersetzt er Ihre vollständige Datei durch den Teil, den er danach aufgebaut hat. Fehlen Produkte Stunden nach einer manuellen Neuerstellung erneut, klicken Sie noch einmal auf die Schaltfläche.

Auf einer Website mit wenig Traffic kann ein Server-Cronjob die Anfragen liefern; die FAQ Warum automatische Cron-Updates fehlschlagen zeigt die Einrichtung und die PHP-Limits. Rufen Sie ihn jede Minute auf, nicht einmal am Tag, denn jeder Aufruf fügt einen Stapel hinzu. Wenn Sie das Plugin mit Plugin nur auf den nächsten Seiten der Website initialisieren eingeschränkt haben, lassen Sie ihn /wp-admin/admin-ajax.php aufrufen, wo das Plugin immer geladen wird. Selbst dann kommen nur 600 Datensätze pro Stunde hinzu; klicken Sie daher bei Katalogen, die sich massenhaft ändern, nach jedem Import auf Jetzt aktualisieren!.

Weitere Zeiträume lassen sich mit dem Hook woof_turbo_mode_schedules hinzufügen, ohne Plugin-Dateien zu bearbeiten; wählen Sie dann den neuen Zeitraum und speichern Sie:

/*
 * HUSKY Turbo mode: add "every 12 hours" to WordPress Cron period.
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('woof_turbo_mode_schedules', function ($schedules) {
    $schedules['every_12_hours'] = array(
        'name'  => 'every 12 hours',
        'value' => 12 * HOUR_IN_SECONDS,
    );
    return $schedules;
});

Die Datei behält nach jeder Neuerstellung dieselbe Adresse. Speichert ein CDN oder der Browser .json-Dateien im Cache, erhalten Besucher möglicherweise weiterhin alte Daten: Schließen Sie den Ordner uploads_woof_turbo_mode vom CDN-Caching aus oder leeren Sie ihn nach Neuerstellungen.

Der Turbo Mode benötigt AJAX und hat eigene Zähleinstellungen

Solange der Turbo Mode aktiviert ist, setzt HUSKY bei jedem Seitenaufruf vier Einstellungen zurück: Versuchen Sie AJAX im Shop (Try to ajaxify the shop) wird zu Ja, und die regulären Einstellungen Anzahl anzeigen, Dynamische Nachzählung und Leere Begriffe ausblenden werden zu Nein (No). Der Tab Optionen zeigt dann die eigenen Kopien dieser drei Einstellungen des Turbo Mode unter denselben Namen, und Dynamische Nachzählung bietet Ja, für alle Geräte (Yes, for all devices) oder Ja, nur für PC (Yes, only for PC).

  • AJAX lässt sich nicht ausschalten, solange der Turbo Mode eingeschaltet ist. Stellen Sie Turbomodus aktivieren auf Nein, speichern Sie und ändern Sie erst dann Versuchen Sie AJAX im Shop.
  • Wenn das Produktraster des Themes nach der AJAX-Filterung kaputtgeht (ein Produkt pro Zeile, verlorene Spalten, defekte Seitennummerierung), erbt der Turbo Mode das Problem: Siehe Spaltenanzahl im AJAX-Modus festlegen und Probleme mit der Seitennummerierung im AJAX-Modus, oder lassen Sie den Turbo Mode für dieses Theme ausgeschaltet.
  • Stellen Sie nach dem Ausschalten des Turbo Mode Anzahl anzeigen, Dynamische Nachzählung und Leere Begriffe ausblenden erneut ein: Sie stehen weiterhin auf Nein, weshalb die Zähler in diesem Moment verschwinden.
  • Leere Begriffe ausblenden funktioniert nur, wenn Anzahl anzeigen und Dynamische Nachzählung eingeschaltet sind; schalten Sie Anzahl anzeigen aus, werden die beiden anderen ebenfalls ausgeschaltet.
  • Cachen Sie die dynamische Nachzählungsnummer für jedes Element im Filter (Cache dynamic recount number for each item in filter), Cache-Begriffe (Cache terms) und Preisfilter optimieren (Optimize price filter) verschwinden aus Erweitert → Optionen, solange der Turbo Mode eingeschaltet ist; sie gelten für ihn nicht.

Was der Turbo Mode nicht kann

  • Das Element Hierarchie-Dropdown (Hierarchy drop-down) funktioniert damit nicht, wie auf der Seite der Turbo-Mode-Erweiterung aufgeführt.
  • Anzahlen und Leere Begriffe ausblenden funktionieren für die Standardelemente (Checkbox, Radiobutton, Dropdowns, Farbe, Bild, Label, Slider). Mit dem Smart Designer erstellte Elemente erhalten keine Anzahlen.
  • Auf Lager (In stock) betrachtet nur den eigenen Lagerstatus jedes Produkts; die Einstellung, die Varianten prüft, hat keine Wirkung, sodass ein Filter nach Größe weiterhin nicht vorrätige Varianten anzeigen kann.
  • Die Textsuche vergleicht die eingegebenen Wörter nur mit Produkttiteln, auch wenn das Textsuche-Element so eingestellt ist, dass es in Beschreibungen oder anderen Feldern sucht. Das separate SKU-Element funktioniert.
  • In PHP hinzugefügte Bedingungen nehmen an der Suche nicht teil, weil der Browser entscheidet, welche Produkte passen. Eigener Code auf woof_products_query oder pre_get_posts, eigene Erweiterungen und Plugins, die Produkte pro Anbieter oder Kundengruppe begrenzen, können gefundene Produkte höchstens nachträglich ausblenden, wodurch Anzahlen und Seitennummerierung nicht mehr zusammenpassen.

Wenn Ihr Shop eine dieser Funktionen braucht oder sich seine Preise und Lagerbestände stündlich ändern, schalten Sie den Turbo Mode aus und beschleunigen Sie stattdessen den normalen Modus mit Caching.

Checkliste

  • Keine roten Fehler in der Konsole; die Skripte des Plugins sind von Verzögerung, Aufschub und Zusammenfassung ausgenommen.
  • woof_turbo_mode_file.length entspricht den veröffentlichten Produkten plus Varianten; der Zähler ist nicht am Limit stehen geblieben.
  • Die Datei wurde nach dem letzten Import oder der letzten Filteränderung neu erstellt; Seiten-Cache und CDN sind geleert.
  • Produkte sind in der gesamten Kategoriekette angehakt und haben die Sichtbarkeit Shop und Suchergebnisse.
  • Die Zähleinstellungen sind in den Kopien des Turbo Mode gesetzt, und nach dem Ausschalten des Turbo Mode erneut.

Wenn sich der Filter weiterhin falsch verhält, eröffnen Sie ein Thema im HUSKY-Support-Forum mit dem Seitenlink, den Konsolenfehlern, dem Wert von woof_turbo_mode_file.length und der Anzahl Ihrer Produkte und Varianten.