HUSKY - WooCommerce Product Filter Professional

Filtr produktów WooCommerce nie działa z WP Rocket i cache

Gdy filtr produktów WooCommerce nie działa z WP Rocket lub inną wtyczką optymalizującą, schemat jest niemal zawsze taki sam: po zalogowaniu wszystko działa, a u odwiedzających kliknięcia nic nie robią, loader kręci się bez końca albo suwak ceny wyświetla się jako zwykłe pole tekstowe. HUSKY wysyła ten sam kod do obu grup. Różnica polega na tym, że cache i optymalizacja JavaScript zwykle pomijają zalogowanych administratorów, więc nigdy nie widzisz zoptymalizowanej strony, którą dostają odwiedzający. Poniżej: jak odczytać błąd w minutę, co dokładnie wykluczyć w WP Rocket, LiteSpeed Cache, Autoptimize, SiteGround Optimizer i Cloudflare oraz jak sprawić, by cache strony nie psuł filtrowania AJAX przez nonce error.

Dlaczego filtr działa dla administratorów, a u odwiedzających zawodzi

Front-end filtra to nie jeden plik skryptu, lecz łańcuch, który musi uruchamiać się w ściśle określonej kolejności:

  1. jQuery, od którego zależy każdy skrypt filtra.
  2. Wbudowany blok ustawień wypisany na stronie (w kodzie źródłowym to <script id="woof_front-js-before">). Definiuje zmienne potrzebne filtrowi: woof_current_values, woof_is_ajax, swoof_search_slug, woof_ext_init_functions, token bezpieczeństwa woof_front_nonce i inne.
  3. Pliki wtyczki z katalogu /wp-content/plugins/woocommerce-products-filter/: js/front.js, który odczytuje te zmienne, skrypty elementów filtra i rozszerzeń oraz dodatki jQuery, takie jak iCheck (style pól wyboru), ion.rangeSlider (suwaki) i plainOverlay (nakładka ładowania).

Optymalizacja i cache psują ten łańcuch na trzy sposoby. Optymalizacja zmienia kolejność, na przykład opóźniając pliki, ale nie blok wbudowany, albo odwrotnie. Przenosi lub przepisuje blok wbudowany podczas łączenia lub minifikacji. A cache strony zapisuje kod HTML zawierający dane z datą ważności: token bezpieczeństwa. Większość wtyczek cache i optymalizacji serwuje zalogowanym użytkownikom stronę, która nie jest ani buforowana, ani optymalizowana, więc widok administratora dowodzi tylko tego, że sam filtr działa.

Najpierw sprawdź konsolę przeglądarki

Otwórz sklep w oknie prywatnym, w którym nie jesteś zalogowany. Naciśnij F12 (Cmd+Option+I na Macu), otwórz kartę Konsola (Console), odśwież stronę i kliknij filtr. Pierwszy czerwony błąd wskazuje, gdzie szukać przyczyny.

Komunikat w konsoliCo oznacza
woof_current_values is not defined, to samo dla woof_is_ajax, swoof_search_slug, woof_ext_init_functions (Firefox: assignment to undeclared variable, Safari: Can't find variable)Blok wbudowany z ustawieniami nie uruchomił się przed front.js: został opóźniony, przeniesiony, usunięty lub uszkodzony
jQuery is not definedjQuery jest opóźnione lub odroczone, a kod, który go potrzebuje, uruchomił się wcześniej
iCheck is not a function, plainOverlay is not a function, ionRangeSlider is not a functionPlik dodatku się nie załadował albo druga kopia jQuery załadowała się po nim i zastąpiła obiekt jQuery
woof_husky_txt is not definedBlok danych wyszukiwania tekstowego został usunięty lub oddzielony od swojego pliku
SyntaxError wskazujący na blok wbudowanyNieprawidłowy kod w bloku wbudowanym, często pochodzący z pola własnego JavaScriptu we wtyczce (zob. niżej)
Identifier 'woof_front_nonce' has already been declaredBlok ustawień uruchomił się dwa razy: optymalizator lub motyw z przejściami stron AJAX ponownie wykonał skrypty wbudowane
"nonce error" is not valid JSONStrona pochodziła z cache, a jej token bezpieczeństwa wygasł
Unexpected token '<' ... is not valid JSONSerwer odpowiedział na żądanie filtra kodem HTML: komunikatem PHP, stroną zapory sieciowej lub stroną z cache
Bad escaped character in JSONCoś przepisało odpowiedź AJAX w drodze do przeglądarki

Brak jakiegokolwiek błędu, ale suwak jest zwykłym polem, brakuje otwieraczy + list hierarchicznych, a kliknięcia nic nie robią: skrypty jeszcze się nie uruchomiły. Tak wyglądają funkcje typu „opóźnij JavaScript do czasu interakcji użytkownika”. Wyświetl źródło strony i wyszukaj woof_front: jeśli znaczniki skryptów mają typ taki jak rocketlazyloadscript lub litespeed/javascript, optymalizator je wstrzymuje. Jeśli woof_front nie występuje w źródle w ogóle, sprawdź pole Inicjuj wtyczkę tylko na kolejnych stronach witryny (Init plugin on the next site pages only) (Zaawansowane → Kod): jeśli wymienia strony, wtyczka ładuje się tylko na nich.

Co wykluczyć z optymalizacji JavaScript

Zasada jest taka sama w każdym narzędziu: jQuery, bloki wbudowane i pliki wtyczki muszą pozostać razem i w pierwotnej kolejności. Wykluczenie samego front.js to częsta połowiczna poprawka, która nie działa, bo blok ustawień i jQuery nadal są opóźniane. Te trzy linie obejmują wszystko:

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

Pierwsza linia pasuje do jQuery i jQuery UI (korzysta z niego suwak ceny w stylu WooCommerce). Druga pasuje do każdego pliku wtyczki i jej rozszerzeń. Trzecia pasuje do bloków wbudowanych: ich identyfikatory i zmienne wewnątrz zaczynają się od woof_. Pola wykluczeń we wtyczkach optymalizujących zwykle dopasowują słowo kluczowe zarówno do adresu URL pliku, jak i do zawartości skryptów wbudowanych.

  • WP Rocket. W sekcji Optymalizacja plików (File Optimization) dodaj te linie do wykluczonych plików opcji Opóźnij wykonywanie JavaScript (Delay JavaScript execution); jeśli filtr nadal nie działa, dodaj je także do wykluczeń opcji Wczytaj JavaScript z odroczeniem (Load JavaScript deferred) albo wyłącz tę opcję. Jeśli Optymalizuj dostarczanie CSS (Optimize CSS delivery) jest ustawione na usuwanie nieużywanego CSS, dodaj style wtyczki i klasy .woof do jego listy dozwolonych: wiele klas filtra pojawia się dopiero po uruchomieniu JavaScriptu, więc skan statycznej strony uznaje je za nieużywane.
  • LiteSpeed Cache. Zwykłymi przyczynami są Łączenie JS (JS Combine) i Odroczone ładowanie JS (Load JS Deferred) (odroczone lub opóźnione); dodaj te linie do wykluczeń JS oraz do wykluczeń skryptów odroczonych/opóźnionych. Jeśli żądanie filtra wraca, ale produkty się nie odświeżają, a konsola pokazuje Bad escaped character in JSON, wyłącz Mapowanie CDN (CDN Mapping): w potwierdzonych przypadkach przepisywało ono odpowiedź AJAX.
  • Autoptimize. Gdy JavaScript jest agregowany, jQuery trafia do połączonego pliku na końcu strony, a kod wbudowany zostaje tam, gdzie był, i uruchamia się zbyt wcześnie. Zachowaj js/jquery/jquery.min.js i woocommerce-products-filter w polu Wyklucz skrypty z Autoptimize (Exclude scripts from Autoptimize).
  • SiteGround Speed Optimizer, WP-Optimize i podobne. Opcje łączenia, odraczania i „opóźniania skryptów wbudowanych” wymagają tych samych wykluczeń albo muszą być wyłączone.
  • Cloudflare Rocket Loader. Ładuje wszystkie skrypty asynchronicznie, także bloki wbudowane, i uniemożliwia też uruchomienie rozszerzenia Filter front builder. Wyłącz go w ustawieniach szybkości Cloudflare, a następnie wyczyść cache Cloudflare.
  • Minifikacja HTML, która „usuwa zbędne znaki”, może uszkodzić skrypty wbudowane. Wyłącz w niej minifikację wbudowanego JavaScriptu.
  • Kod motywu lub snippetu na filtrze script_loader_tag. WordPress przepuszcza blok wbudowany przez ten filtr razem ze znacznikiem skryptu, więc kod, który usuwa atrybuty lub zamienia cudzysłowy, może go uszkodzić. Usuń taki kod lub ogranicz go do innych uchwytów.

Dwa ustawienia wewnątrz filtra

Kod JavaScript po zakończeniu AJAX (JavaScript code after AJAX is done) (WooCommerce → Ustawienia → Products Filter → Zaawansowane → Kod) jest wstawiany do wbudowanego bloku ustawień jako treść funkcji. Literówka w tym miejscu, na przykład niezamknięty nawias, psuje cały blok, a każda zmienna filtra staje się „not defined”. Opróżnij pole, aby to sprawdzić; do uruchamiania kodu po filtrowaniu bezpieczniejszym miejscem jest zdarzenie woof_ajax_done.

Optymalizuj ładowanie plików JavaScript HUSKY (Optimize loading of HUSKY JavaScript files) (Zaawansowane → Opcje) przełącza między dwoma sposobami ładowania: Nie (No) ładuje front.js oraz cztery osobne skrypty dla przycisków radio, pól wyboru i list rozwijanych; Tak (Yes) ładuje jeden skompresowany plik, js/front_comprssd.js, w stopce. Niektóre konfiguracje optymalizatorów działają z jedną wartością, a z drugą nie. Wypróbuj obie, po każdej zmianie czyszcząc wszystkie cache.

Cache strony i „nonce error”

W trybie AJAX (Próbuj zajaxować sklep (Try to ajaxify the shop) na karcie Opcje lub strona z [woof_products is_ajax=1]) oraz z atrybutem ajax_redraw filtr prosi serwer o nowe produkty i wysyła token woof_front_nonce pobrany ze strony. Serwer go sprawdza, a jeśli token jest nieprawidłowy, odpowiada zwykłym tekstem nonce error. Skrypt oczekuje JSON-a, nie potrafi odczytać tej odpowiedzi i loader pozostaje na ekranie.

Token powstaje w chwili generowania kodu HTML. Dla niezalogowanych odwiedzających nonce WordPressa są ważne co najmniej 12 i co najwyżej 24 godziny. Strona serwowana z cache, starsza niż ten czas, niesie martwy token. Dlatego problem pojawia się na stronach z cache dobę po jego zbudowaniu i dlatego odświeżenie czasem pomaga: trafia akurat na świeżą kopię. Wyczyszczenie cache rozwiązuje sprawę tylko na kilka godzin. Trwałe rozwiązania:

  • Utrzymuj czas życia cache stron HTML poniżej 12 godzin. Domyślny czas życia 10 godzin w WP Rocket jest bezpieczny; typowym winowajcą jest długotrwałe buforowanie HTML w CDN.
  • Nie buforuj HTML sklepu i kategorii w CDN. W Cloudflare dodaj regułę cache, która omija cache dla sklepu, adresów /product-category/ i każdej innej strony z filtrem, a cache strony WordPressa zachowaj, bo respektuje własny czas życia. Pomijanie tylko przefiltrowanych adresów nie wystarcza: token, którego używa odwiedzający, pochodzi ze strony, na której zaczyna się filtrowanie.
  • Wydłuż czas życia tego jednego tokenu. Od WordPressa 6.1 filtr nonce_life otrzymuje nazwę akcji, więc token filtra może żyć dłużej bez naruszania jakiegokolwiek innego nonce w witrynie. Token chroni wyłącznie publiczne żądanie listy produktów.
/*
 * 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);

Zwykły tryb przekierowania, bez AJAX i bez ajax_redraw, w ogóle nie używa tokenu: każda zmiana filtra ładuje nowy adres URL, a cache strony może serwować przefiltrowane adresy jak każdą inną stronę. Jeśli wywołujesz filtr z własnego kodu, na przykład niestandardowym żądaniem jQuery do woof_draw_products, dane żądania muszą zawierać nonce_filter: woof_front_nonce, w przeciwnym razie serwer odpowie nonce error nawet bez żadnego cache.

Nieaktualne filtry i inne skutki uboczne cache

  • Zmienione ustawienia filtra się nie pojawiają. Ustawienia są częścią buforowanego HTML i bloku wbudowanego. Po ich zapisaniu wyczyść każdą warstwę cache: wtyczkę cache, cache serwera (Varnish, Nginx, cache hostingu), CDN, a następnie odśwież przeglądarkę z pominięciem cache (Ctrl+F5, Cmd+Shift+R na Macu).
  • Przefiltrowany link otwiera się bez żadnych zaznaczeń albo czysty sklep otwiera się ze starymi wyborami. Cache traktuje adresy URL z różnymi ciągami zapytania jak jedną stronę. Każdy adres ?swoof=1&... musi być buforowany osobno lub wcale, więc nigdy nie ustawiaj cache tak, by ignorował ciągi zapytania w adresach sklepu.
  • Filtr mobilny pojawia się na komputerze albo odwrotnie. Tryb mobilny filtra i niektóre rozszerzenia decydują na serwerze, na podstawie user agenta przeglądarki, co wypisać. Strona zbuforowana dla telefonu nie może być serwowana na komputerze: włącz osobne pliki cache dla urządzeń mobilnych.
  • Pierwsza wizyta z nową kombinacją filtrów jest wolniejsza: ten adres nie ma jeszcze zbuforowanej kopii. Ogólne wskazówki dotyczące szybkości znajdziesz w przyspieszaniu filtrowania w dużych katalogach.

Bezpieczna kolejność testowania

  1. Pracuj w oknie prywatnym, bez logowania, z otwartą konsolą.
  2. Wyłącz całą optymalizację JavaScript (minifikację, łączenie, odraczanie, opóźnianie, Rocket Loader) i wyczyść każdą warstwę cache. Jeśli filtr teraz działa, przyczyną jest optymalizacja. Jeśli nadal zawodzi, przyczyna leży gdzie indziej: odczytaj pierwszy błąd w konsoli i przetestuj z domyślnym motywem na kopii stagingowej.
  3. Włączaj opcje z powrotem pojedynczo, czyść cache i testuj po każdej. Gdy któraś psuje filtr, dodaj do niej trzy linie wykluczeń albo zostaw ją wyłączoną.
  4. W trybie AJAX sprawdź filtr ponownie na stronie, która leży w cache od doby. Brak nonce error oznacza, że czas życia cache lub czas życia tokenu jest dobrany prawidłowo.
  5. Przetestuj także na telefonie i na komputerze oraz na drugiej stronie wyników.

Jeśli po tych krokach filtr nadal działa tylko dla zalogowanych użytkowników, załóż wątek na forum wsparcia HUSKY, podając link do strony, pierwszy błąd z konsoli i listę włączonych opcji optymalizacji, a my przyjrzymy się sprawie.