HUSKY - WooCommerce Product Filter Professional

WooCommerce Produktfilter funktioniert nicht mit WP Rocket und Caching

Wenn ein WooCommerce Produktfilter mit WP Rocket oder einem anderen Optimierungs-Plugin nicht funktioniert, ist das Muster fast immer dasselbe: Solange Sie angemeldet sind, läuft alles, doch bei Besuchern reagieren die Klicks nicht, der Ladeindikator dreht sich endlos oder der Preisregler erscheint als einfaches Textfeld. HUSKY liefert beiden denselben Code aus. Der Unterschied: Caching und JavaScript-Optimierung überspringen meist angemeldete Administratoren, sodass Sie die optimierte Seite, die Ihre Besucher erhalten, nie zu sehen bekommen. Im Folgenden: wie Sie den Fehler in einer Minute auslesen, was Sie in WP Rocket, LiteSpeed Cache, Autoptimize, SiteGround Optimizer und Cloudflare genau ausschließen müssen und wie Sie verhindern, dass der Seiten-Cache das AJAX-Filtern mit einem nonce error bricht.

Warum der Filter für Admins funktioniert und bei Besuchern ausfällt

Das Frontend des Filters ist keine einzelne Skriptdatei, sondern eine Kette, die in fester Reihenfolge ablaufen muss:

  1. jQuery, von dem jedes Filter-Skript abhängt.
  2. Ein Inline-Einstellungsblock, der in die Seite geschrieben wird (im Quelltext ist es <script id="woof_front-js-before">). Er definiert die Variablen, die der Filter braucht: woof_current_values, woof_is_ajax, swoof_search_slug, woof_ext_init_functions, das Sicherheits-Token woof_front_nonce und weitere.
  3. Die Plugin-Dateien aus /wp-content/plugins/woocommerce-products-filter/: js/front.js, das diese Variablen liest, die Skripte der Filterelemente und Erweiterungen sowie jQuery-Add-ons wie iCheck (Checkbox-Designs), ion.rangeSlider (Regler) und plainOverlay (das Lade-Overlay).

Optimierung und Caching brechen diese Kette auf drei Arten. Die Optimierung ändert die Reihenfolge, etwa indem sie die Dateien verzögert, den Inline-Block aber nicht, oder umgekehrt. Sie verschiebt oder verändert den Inline-Block beim Zusammenfassen oder Minifizieren. Und ein Seiten-Cache speichert HTML, das Daten mit Ablaufdatum enthält: das Sicherheits-Token. Die meisten Caching- und Optimierungs-Plugins liefern angemeldeten Benutzern eine Seite aus, die weder gecacht noch optimiert ist; die Admin-Ansicht beweist also nur, dass der Filter selbst funktioniert.

Zuerst die Browser-Konsole lesen

Öffnen Sie den Shop in einem privaten Fenster, in dem Sie nicht angemeldet sind. Drücken Sie F12 (auf dem Mac Cmd+Option+I), öffnen Sie den Tab Konsole (Console), laden Sie die Seite neu und klicken Sie auf einen Filter. Der erste rote Fehler zeigt Ihnen, wo Sie suchen müssen.

Meldung in der KonsoleBedeutung
woof_current_values is not defined, ebenso für woof_is_ajax, swoof_search_slug, woof_ext_init_functions (Firefox: assignment to undeclared variable, Safari: Can't find variable)Der Inline-Einstellungsblock wurde nicht vor front.js ausgeführt: Er wurde verzögert, verschoben, entfernt oder beschädigt
jQuery is not definedjQuery wird verzögert oder zurückgestellt (deferred), aber Code, der es braucht, lief früher
iCheck is not a function, plainOverlay is not a function, ionRangeSlider is not a functionDie Add-on-Datei wurde nicht geladen, oder eine zweite jQuery-Kopie wurde danach geladen und hat das jQuery-Objekt ersetzt
woof_husky_txt is not definedDer Datenblock der Textsuche wurde entfernt oder von seiner Datei getrennt
SyntaxError mit Verweis auf den Inline-BlockUngültiger Code im Inline-Block, oft aus dem eigenen Feld für benutzerdefiniertes JavaScript des Plugins (siehe unten)
Identifier 'woof_front_nonce' has already been declaredDer Einstellungsblock wurde zweimal ausgeführt: Ein Optimierer oder ein Theme mit AJAX-Seitenübergängen hat Inline-Skripte erneut ausgeführt
"nonce error" is not valid JSONDie Seite stammt aus einem Cache, und ihr Sicherheits-Token ist abgelaufen
Unexpected token '<' ... is not valid JSONDer Server hat die Filteranfrage mit HTML beantwortet: einer PHP-Notice, einer Firewall-Seite oder einer gecachten Seite
Bad escaped character in JSONEtwas hat die AJAX-Antwort auf dem Weg zum Browser umgeschrieben

Gar kein Fehler, aber der Regler ist ein einfaches Eingabefeld, die +-Symbole hierarchischer Listen fehlen und Klicks bewirken nichts: Die Skripte sind noch nicht gelaufen. So sehen Funktionen wie „JavaScript bis zur Benutzerinteraktion verzögern“ aus. Rufen Sie den Seitenquelltext auf und suchen Sie nach woof_front: Tragen die Script-Tags einen Typ wie rocketlazyloadscript oder litespeed/javascript, hält ein Optimierer sie zurück. Kommt woof_front im Quelltext überhaupt nicht vor, prüfen Sie das Feld Plugin nur auf den nächsten Seiten der Website initialisieren (Init plugin on the next site pages only) (Advanced → Code): Sind dort Seiten eingetragen, lädt das Plugin nur dort.

Was von der JavaScript-Optimierung auszuschließen ist

Die Regel ist in jedem Tool dieselbe: jQuery, die Inline-Blöcke und die Plugin-Dateien müssen zusammenbleiben und in ihrer ursprünglichen Reihenfolge laufen. Nur front.js auszuschließen ist eine verbreitete halbe Lösung, die nicht funktioniert, weil der Einstellungsblock und jQuery weiterhin verzögert werden. Diese drei Zeilen decken alles ab:

/wp-includes/js/jquery/
woocommerce-products-filter
woof_

Die erste Zeile erfasst jQuery und jQuery UI (der Preisregler im WooCommerce-Stil verwendet es). Die zweite erfasst jede Datei des Plugins und seiner Erweiterungen. Die dritte erfasst die Inline-Blöcke: Ihre IDs und die darin enthaltenen Variablen beginnen mit woof_. Ausschlussfelder von Optimierungs-Plugins gleichen ein Stichwort üblicherweise sowohl mit der Datei-URL als auch mit dem Inhalt von Inline-Skripten ab.

  • WP Rocket. Tragen Sie die Zeilen unter Dateioptimierung (File Optimization) bei den ausgeschlossenen Dateien von JavaScript-Ausführung verzögern (Delay JavaScript execution) ein; funktioniert der Filter weiterhin nicht, fügen Sie sie auch zu den Ausschlüssen von JavaScript verzögert laden (Load JavaScript deferred) hinzu oder schalten Sie diese Option aus. Ist CSS-Übermittlung optimieren (Optimize CSS delivery) auf das Entfernen ungenutzten CSS eingestellt, nehmen Sie die Styles des Plugins und die .woof-Klassen in die CSS-Safelist auf: Viele Filterklassen erscheinen erst, nachdem JavaScript gelaufen ist, daher stuft ein Scan der statischen Seite sie als ungenutzt ein.
  • LiteSpeed Cache. JS kombinieren (JS Combine) und JS verzögert laden (Load JS Deferred) (deferred oder delayed) sind die üblichen Ursachen; tragen Sie die Zeilen in die JS-Ausschlüsse und die Deferred-/Delayed-Ausschlüsse ein. Kommt die Filteranfrage zurück, die Produkte aktualisieren sich aber nicht und die Konsole zeigt Bad escaped character in JSON, schalten Sie CDN-Zuordnung (CDN Mapping) aus: In bestätigten Fällen hat sie die AJAX-Antwort umgeschrieben.
  • Autoptimize. Wird JavaScript zusammengefasst, wandert jQuery in die kombinierte Datei am Seitenende, während Inline-Code an seiner Stelle bleibt und zu früh ausgeführt wird. Behalten Sie js/jquery/jquery.min.js und woocommerce-products-filter unter Skripte von Autoptimize ausschließen (Exclude scripts from Autoptimize).
  • SiteGround Speed Optimizer, WP-Optimize und ähnliche. Die Optionen zum Kombinieren, Zurückstellen (Defer) und „Inline-Skripte verzögern“ brauchen alle dieselben Ausschlüsse oder müssen ausgeschaltet sein.
  • Cloudflare Rocket Loader. Er lädt alle Skripte asynchron, Inline-Blöcke eingeschlossen, und verhindert außerdem den Start der Erweiterung Front-Builder des Filters (Filter front builder). Schalten Sie ihn in den Geschwindigkeitseinstellungen von Cloudflare aus und leeren Sie anschließend den Cloudflare-Cache.
  • HTML-Minifizierung, die „unnötige Zeichen entfernt“, kann Inline-Skripte beschädigen. Schalten Sie deren Minifizierung von Inline-JavaScript aus.
  • Theme- oder Snippet-Code am Filter script_loader_tag. WordPress schickt den Inline-Block zusammen mit dem Script-Tag durch diesen Filter; Code, der dort Attribute entfernt oder Anführungszeichen ersetzt, kann ihn also beschädigen. Entfernen Sie solchen Code oder beschränken Sie ihn auf andere Handles.

Zwei Einstellungen im Filter

JavaScript-Code nach Abschluss von AJAX (JavaScript code after AJAX is done) (WooCommerce → Settings → Products Filter → Advanced → Code) wird als Funktionskörper in den Inline-Einstellungsblock eingefügt. Ein Tippfehler dort, etwa eine nicht geschlossene Klammer, zerstört den ganzen Block, und jede Filtervariable ist „not defined“. Leeren Sie das Feld zum Testen; um nach dem Filtern Code auszuführen, ist das woof_ajax_done-Event der sicherere Ort.

Laden der HUSKY-JavaScript-Dateien optimieren (Optimize loading of HUSKY JavaScript files) (Advanced → Options) schaltet zwischen zwei Lademethoden um: Nein (No) lädt front.js plus vier einzelne Skripte für Radiobuttons, Checkboxen und Dropdowns; Ja (Yes) lädt eine komprimierte Datei, js/front_comprssd.js, im Footer. Manche Optimierer-Konfigurationen funktionieren mit dem einen Wert und mit dem anderen nicht. Probieren Sie beide aus und leeren Sie nach jeder Änderung alle Caches.

Seiten-Cache und der „nonce error“

Im AJAX-Modus (Versuchen Sie AJAX im Shop (Try to ajaxify the shop) auf dem Tab Optionen oder eine Seite mit [woof_products is_ajax=1]) und mit dem Attribut ajax_redraw fragt der Filter beim Server neue Produkte ab und sendet dabei das Token woof_front_nonce, das er der Seite entnimmt. Der Server prüft es und antwortet, wenn es ungültig ist, mit dem Klartext nonce error. Das Skript erwartet JSON, kann diese Antwort nicht lesen, und der Ladeindikator bleibt auf dem Bildschirm.

Das Token wird erzeugt, wenn das HTML generiert wird. Für nicht angemeldete Besucher sind WordPress-Nonces mindestens 12 und höchstens 24 Stunden gültig. Eine Seite aus einem Cache, der älter ist, trägt ein totes Token. Deshalb tritt das Problem auf gecachten Seiten einen Tag nach dem Aufbau des Caches auf, und deshalb hilft ein Neuladen manchmal: Es trifft zufällig eine frische Kopie. Das Leeren des Caches behebt es nur für wenige Stunden. Dauerhafte Lösungen:

  • Halten Sie die Cache-Lebensdauer von HTML-Seiten unter 12 Stunden. Die Standard-Lebensdauer von 10 Stunden bei WP Rocket ist sicher; langlebiges HTML-Caching bei einem CDN ist der typische Übeltäter.
  • Cachen Sie HTML von Shop und Kategorien nicht im CDN. Fügen Sie bei Cloudflare eine Cache-Regel hinzu, die den Cache für den Shop, die /product-category/-URLs und jede andere Seite mit dem Filter umgeht, und behalten Sie Ihren WordPress-Seiten-Cache bei, der seine eigene Lebensdauer einhält. Nur gefilterte URLs zu umgehen genügt nicht: Das vom Besucher verwendete Token stammt von der Seite, auf der das Filtern beginnt.
  • Verlängern Sie die Lebensdauer genau dieses einen Tokens. Seit WordPress 6.1 erhält der Filter nonce_life den Namen der Aktion, sodass das Token des Filters länger gültig sein kann, ohne ein anderes Nonce der Website anzutasten. Das Token schützt nur die öffentliche Anfrage der Produktliste.
/*
 * HUSKY: keep the filter token valid longer than the page cache lifespan.
 * A token is valid for at least half of this time (here: 2 days).
 * Child theme functions.php or a code snippets plugin.
 */
add_filter('nonce_life', function ($life, $action = -1) {
    if ('woof_front_nonce' === $action) {
        return 4 * DAY_IN_SECONDS;
    }
    return $life;
}, 10, 2);

Der einfache Weiterleitungsmodus, ohne AJAX und ohne ajax_redraw, verwendet das Token gar nicht: Jede Filteränderung lädt eine neue URL, und der Seiten-Cache kann gefilterte URLs wie jede andere Seite ausliefern. Rufen Sie den Filter aus eigenem Code auf, zum Beispiel mit einer eigenen jQuery-Anfrage an woof_draw_products, muss die Anfrage die Daten nonce_filter: woof_front_nonce enthalten, sonst antwortet der Server auch ganz ohne Cache mit nonce error.

Veraltete Filter und andere Cache-Nebenwirkungen

  • Geänderte Filtereinstellungen erscheinen nicht. Die Einstellungen sind Teil des gecachten HTML und des Inline-Blocks. Leeren Sie nach dem Speichern jede Cache-Ebene: das Cache-Plugin, den Server-Cache (Varnish, Nginx, Host-Cache), das CDN, und laden Sie dann den Browser hart neu (Strg+F5, auf dem Mac Cmd+Shift+R).
  • Ein gefilterter Link öffnet sich ohne Auswahl, oder ein sauberer Shop öffnet sich mit alten Auswahlen. Der Cache behandelt URLs mit unterschiedlichen Query-Strings als eine Seite. Jede ?swoof=1&...-URL muss separat oder gar nicht gecacht werden; stellen Sie den Cache daher bei Shop-URLs nie so ein, dass er Query-Strings ignoriert.
  • Der mobile Filter erscheint auf dem Desktop oder umgekehrt. Der mobile Modus des Filters und einige Erweiterungen entscheiden auf dem Server anhand des User-Agents des Browsers, was ausgegeben wird. Eine für ein Smartphone gecachte Seite darf nicht an einen Desktop ausgeliefert werden: Aktivieren Sie separate Cache-Dateien für mobile Geräte.
  • Der erste Besuch einer neuen Filterkombination ist langsamer: Für diese URL gibt es noch keine gecachte Kopie. Zur allgemeinen Geschwindigkeit siehe Filterung in großen Katalogen beschleunigen.

Eine sichere Reihenfolge zum Testen

  1. Arbeiten Sie in einem privaten Fenster, abgemeldet, mit geöffneter Konsole.
  2. Schalten Sie jede JavaScript-Optimierung aus (Minify, Kombinieren, Defer, Delay, Rocket Loader) und leeren Sie jede Cache-Ebene. Funktioniert der Filter jetzt, ist die Optimierung die Ursache. Fällt er weiterhin aus, liegt die Ursache woanders: Lesen Sie den ersten Konsolenfehler und testen Sie mit einem Standard-Theme auf einer Staging-Kopie.
  3. Schalten Sie die Optionen nacheinander wieder ein, leeren Sie den Cache und testen Sie nach jeder. Bricht eine den Filter, fügen Sie dieser Option die drei Ausschlusszeilen hinzu oder lassen Sie sie ausgeschaltet.
  4. Prüfen Sie im AJAX-Modus den Filter erneut auf einer Seite, die seit einem Tag im Cache liegt. Kein nonce error bedeutet, dass Cache-Lebensdauer oder Token-Lebensdauer stimmen.
  5. Testen Sie auch auf einem Smartphone und nicht nur auf dem Desktop sowie auf der zweiten Ergebnisseite.

Funktioniert der Filter nach diesen Schritten weiterhin nur für angemeldete Benutzer, eröffnen Sie im HUSKY-Support-Forum ein Thema mit dem Link zur Seite, dem ersten Konsolenfehler und der Liste der aktivierten Optimierungsoptionen, und wir sehen es uns an.