HUSKY - WooCommerce Product Filter Professional

Tryb turbo HUSKY nie działa: wyszarzony filtr i brakujące produkty

Gdy tryb turbo HUSKY nie działa, objawy wyglądają na niezwiązane ze sobą: filtr pozostaje wyszarzony, kategoria nie zwraca żadnych produktów, nowe produkty się nie pojawiają, liczniki są błędne albo nie da się wyłączyć trybu AJAX. Prawie wszystkie biorą się z jednego założenia projektowego: w trybie turbo filtrowanie odbywa się w przeglądarce odwiedzającego, na podstawie wcześniej zbudowanego pliku z danymi produktów. Poniżej opisujemy, jak ten plik powstaje i jak jest używany, oraz podajemy rozwiązanie dla każdego objawu.

Jak działa tryb turbo i kiedy warto go używać

W trybie normalnym każde kliknięcie w filtr powoduje, że serwer wykonuje zapytanie WooCommerce i zlicza produkty dla każdego określenia. Tryb turbo przenosi tę pracę do przeglądarki. HUSKY zapisuje wszystkie opublikowane produkty i ich warianty w jednym pliku JSON (domyślnie w wp-content/uploads/uploads_woof_turbo_mode/), razem z ID, tytułem, SKU, cenami, statusem magazynowym, określeniami każdej taksonomii produktów i wartościami pól filtra Meta. Przeglądarka pobiera go na każdej stronie witryny, na której działa wtyczka (ogranicz te strony opcją Inicjuj wtyczkę tylko na kolejnych stronach witryny (Init plugin on the next site pages only) na karcie Zaawansowane (Advanced)), znajduje pasujące produkty i rysuje liczniki; serwer jedynie renderuje znalezione produkty na podstawie ich ID.

Wyniki są więc tak aktualne, jak plik, produkt, którego w nim brakuje, nie może zostać znaleziony, stosowane są tylko warunki zrozumiałe dla przeglądarki, a każdy odwiedzający pobiera cały katalog, co przy dziesiątkach tysięcy produktów i wariantów oznacza megabajty i wolny start na telefonach. Tryb turbo się opłaca na słabym serwerze z katalogiem średniej wielkości, który rzadko się zmienia. Jeśli serwer radzi sobie z zapytaniami, najpierw wypróbuj tryb normalny z pamięcią podręczną opisaną w artykule jak przyspieszyć filtrowanie produktów w dużych katalogach.

Włączaj go we właściwej kolejności

  1. WooCommerce → Ustawienia → Products Filter → Rozszerzenia (Extensions): zaznacz Tryb turbo (Turbo mode) i zapisz.
  2. Zaawansowane (Advanced) → Tryb turbo (Turbo mode): ustaw Włącz tryb turbo (Enable turbo mode) na Tak (Yes) i zapisz.
  3. Kliknij Aktualizuj teraz! (Update now!) pod Ponownie skompiluj dane produktów! (Reassemble products data now!) i nie zamykaj strony, dopóki nie pojawi się Plik zaktualizowany!!! (File updated!!!). Bez pliku filtr nie może wyszukiwać.
  4. Wybierz Okres crona WordPress (WordPress Cron period) i Gdzie przechowywać plik danych produktów (Where to keep products data file), a następnie zapisz.
  5. Na karcie Opcje (Options) ustaw Pokaż ilość (Show count), Dynamiczne przeliczanie (Dynamic recount) i Ukryj puste określenia (Hide empty terms), które w trybie turbo są osobnymi kopiami (wyjaśniamy to niżej), a potem wyczyść pamięć podręczną stron i ewentualną pamięć podręczną CDN.

Filtr jest wyszarzony i nigdy nie staje się klikalny

Szara warstwa to element z klasą woof_turbo_mode_overlay. Pokrywa filtr od pierwszej chwili, a skrypt trybu turbo usuwa ją po wczytaniu pliku i narysowaniu liczników. Jeśli warstwa zostaje, ten skrypt nie dokończył pracy:

  • Skrypty opóźnione, odroczone lub połączone. Funkcje optymalizacji w WP Rocket, LiteSpeed Cache i podobnych wtyczkach mogą uruchamiać skrypty późno, w złej kolejności lub wcale. Tryb turbo potrzebuje plików ext/turbo_mode/js/turbo_mode.js i ext/quick_search/js/alasql/alasql.min.js z katalogu wp-content/plugins/woocommerce-products-filter/, ładowanych po jQuery. Wyłącz folder wtyczki z opóźniania, odraczania i łączenia, a potem wyczyść każdą pamięć podręczną; wyjątki opisuje artykuł filtr z WP Rocket i pamięcią podręczną.
  • Błąd JavaScript. Otwórz konsolę przeglądarki (F12) i odśwież stronę. Pierwszy czerwony błąd wskazuje skrypt, który zatrzymał resztę.
  • Duży plik przy wolnym łączu. Na karcie Network sprawdź rozmiar i czas pobierania pliku data_0000_xxx.json. Jeśli pobieranie utrzymuje filtr wyszarzony przez kilka sekund, katalog jest za duży dla trybu turbo.

Ukrycie warstwy za pomocą CSS (.woof_turbo_mode_overlay{display:none;}) usuwa tylko objaw: filtr staje się klikalny, ale bez wczytanego pliku nie może wyszukiwać.

Gdy pliku nie da się wczytać, filtr zostaje zastąpiony komunikatem Ojej! Wygląda na to, że filtr nie może otworzyć pliku wyszukiwania. (Oh no! It looks like the filter can't open the search file.) Sprawdź, czy:

  • plik istnieje. Plik przechowywany w folderze wtyczki (plugins\woocommerce-products-filter\ext\turbo_mode\data) jest usuwany przy każdej aktualizacji wtyczki, więc po aktualizacjach zbuduj go ponownie albo trzymaj go w wp-uploads\uploads_woof_turbo_mode;
  • żadna reguła serwera ani wtyczka bezpieczeństwa nie blokuje plików .json w katalogu uploads: otwórz bezpośrednio adres pliku z karty Network;
  • adres jest poprawny. Wtyczka żąda wp-content/uploads/uploads_woof_turbo_mode/, więc w podwitrynie multisite albo przy przeniesionym gdzie indziej folderze uploads żądanie zwraca 404. W takim przypadku trzymaj plik w folderze wtyczki.

Nie znaleziono produktów albo produkty znikają po filtrowaniu

Tryb turbo zwraca tylko produkty, które są w pliku, dopasowane do zapisanych tam danych. Sprawdź oba aspekty w konsoli przeglądarki, na stronie z filtrem, po jego wczytaniu:

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

Porównaj pierwszą liczbę z liczbą opublikowanych produktów plus wariantów; w WP-CLI poda ją polecenie wp post list --post_type=product,product_variation --post_status=publish --format=count. Jeśli dla produktu wynikiem jest undefined, nie ma go w pliku. Jeśli jest, sprawdź jego taxonomies i stock.

Plik jest nieaktualny

Nowe produkty, zmienione kategorie, atrybuty, ceny i stany magazynowe trafiają do filtra dopiero przy następnej przebudowie. Typowe oznaki: nowy produkt jest widoczny na stronie sklepu, ale znika po pierwszym kliknięciu w filtr, nowe określenia mają licznik 0, ostatnie strony paginacji są puste albo element filtra Meta dodany po ostatniej przebudowie nic nie znajduje. Przebuduj plik po importach i po zmianie elementów filtra.

Limit 15 000

Aktualizuj teraz! (Update now!) zatrzymuje się po 15 000 rekordów, a warianty się liczą. Sklep z 2000 produktami wariantowymi po osiem wariantów każdy ma ich już 18 000. Przycisk przetwarza najpierw najnowsze produkty, więc pominięte zostają te najstarsze. Jeśli licznik obok przycisku zatrzymał się na Produkty i Warianty: 15000 (Products and Variants: 15000), trafiłeś na limit. Podnieś go za pomocą haka woof_turbo_mode_products_limit i przebuduj plik:

/*
 * 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;
});

Zaplanowana przebudowa nie jest ograniczana przez ten hak; przetwarza cały katalog.

Produkty w podkategoriach nie są znajdowane

Plik przechowuje tylko kategorie zaznaczone przy każdym produkcie, a przeglądarka porównuje je dosłownie; nie zna drzewa kategorii. WordPress pokazuje produkty podkategorii w kategorii nadrzędnej, ale tryb turbo tego nie robi: produkt zaznaczony wyłącznie w Running shoes jest widoczny na stronie Shoes do pierwszego kliknięcia w filtr, a potem znika, określenie Shoes w filtrze go nie znajduje, a licznik Shoes go pomija. Zaznacz na takich produktach każdy poziom łańcucha (Shoes i Running shoes), na przykład za pomocą edycji zbiorczej w Produkty → Wszystkie produkty, a następnie przebuduj plik.

Produkty ukryte i niedostępne

Produkty, których Widoczność w katalogu (Catalog visibility) ma wartość Tylko sklep (Shop only) lub Ukryty (Hidden), są traktowane jako ukryte przed wyszukiwaniem, a tryb turbo nigdy nie zwraca ich po filtrowaniu, niezależnie od ustawienia Nasłuchuj widoczności katalogu (Listen catalog visibility). Produkt z wartością Tylko sklep (Shop only) pojawia się więc na stronie sklepu i znika po pierwszym kliknięciu; jeśli ma być filtrowalny, ustaw Sklep i wyniki wyszukiwania (Shop and search results). Gdy w WooCommerce włączona jest opcja Ukrywaj produkty niedostępne w katalogu (Hide out of stock items from the catalog), produkty niedostępne nie trafiają do pliku, a produkt, który wraca na stan, pozostaje pominięty do następnej przebudowy.

Języki WPML

Przy WPML HUSKY zapisuje jeden plik na język (data_0000_en.json, data_0000_de.json) i wczytuje plik bieżącego języka. Produktu bez tłumaczenia brakuje w pliku tego języka, więc po przetłumaczeniu przebuduj plik.

Utrzymywanie aktualności pliku wyszukiwania

Aktualizuj teraz! (Update now!) buduje plik partiami po dziesięć produktów lub wariantów, najwyżej jedna partia na sekundę, z licznikiem Produkty i Warianty (Products and Variants). Każda partia przepisuje cały plik, więc 15 000 rekordów zajmuje co najmniej 25 minut. W odróżnieniu od zaplanowanej przebudowy przycisk najpierw usuwa bieżący plik, a do czasu zakończenia witryna filtruje na niepełnych danych: uruchamiaj go w spokojnej porze, nie zamykaj strony i nie wyłączaj trybu turbo w trakcie.

Okres crona WordPress (WordPress Cron period) określa automatyczną przebudowę: codziennie (daily), co tydzień (weekly) (domyślnie), dwa razy w miesiącu (twicemonthly), co miesiąc (monthly), min.1 (min1) lub bez aktualizacji (without update). Mimo nazwy nie jest to zdarzenie WP-Cron. HUSKY prowadzi własny harmonogram (opcja woof_turbo_init_wpcrone_): gdy przebudowa jest należna, każde żądanie ładujące WordPress z wtyczką, najwyżej jedno co pięć sekund, dopisuje kolejne dziesięć rekordów do pliku tymczasowego, który po ostatniej partii zastępuje plik aktywny. Do tego czasu odwiedzający dostają poprzednie dane. Co z tego wynika:

  • WP Crontrol i podobne narzędzia go nie wyświetlają, a DISABLE_WP_CRON go nie zatrzymuje.
  • Tempo zależy od żądań, które docierają do PHP; strony serwowane z pamięci podręcznej się nie liczą. 20 000 rekordów wymaga co najmniej 2000 żądań w odstępach pięciu sekund, czyli blisko trzech godzin stałego ruchu, a na mało odwiedzanej witrynie całych dni.
  • Pierwsza automatyczna przebudowa następuje po upływie pełnego okresu od zapisania harmonogramu, więc po włączeniu kliknij Aktualizuj teraz! (Update now!).
  • Okres liczy się od końca poprzedniej przebudowy. min.1 (min1) uruchamia kolejną minutę później, więc witryna przebudowuje się bez przerwy; używaj tego tylko przy małych katalogach.
  • Aktualizuj teraz! (Update now!) kliknięte podczas automatycznej przebudowy usuwa także jej plik tymczasowy; gdy przebudowa automatyczna się zakończy, zastępuje twój kompletny plik częścią, którą zbudowała później. Jeśli produkty znów znikają po kilku godzinach od ręcznej przebudowy, kliknij przycisk jeszcze raz.

Na mało odwiedzanej witrynie żądania może dostarczać zadanie cron serwera; FAQ dlaczego automatyczne aktualizacje cron zawodzą pokazuje konfigurację i limity PHP. Wywołuj je co minutę, nie raz dziennie, ponieważ każde wywołanie dodaje jedną partię. Jeśli ograniczyłeś wtyczkę opcją Inicjuj wtyczkę tylko na kolejnych stronach witryny (Init plugin on the next site pages only), niech wywołuje /wp-admin/admin-ajax.php, gdzie wtyczka zawsze się ładuje. Nawet wtedy dodaje tylko 600 rekordów na godzinę, więc przy katalogach zmienianych masowo klikaj Aktualizuj teraz! (Update now!) po każdym imporcie.

Inne okresy można dodać za pomocą haka woof_turbo_mode_schedules, bez edycji plików wtyczki; potem wybierz nowy okres i zapisz:

/*
 * 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;
});

Plik ma ten sam adres po każdej przebudowie. Jeśli CDN lub przeglądarka buforuje pliki .json, odwiedzający mogą nadal dostawać stare dane: wyłącz folder uploads_woof_turbo_mode z buforowania w CDN albo czyść go po przebudowach.

Tryb turbo wymaga AJAX i ma własne ustawienia liczników

Gdy tryb turbo jest włączony, HUSKY przy każdym wczytaniu strony resetuje cztery ustawienia: Próbuj zajaxować sklep (Try to ajaxify the shop) przyjmuje wartość Tak (Yes), a zwykłe Pokaż ilość (Show count), Dynamiczne przeliczanie (Dynamic recount) i Ukryj puste określenia (Hide empty terms) przyjmują wartość Nie (No). Karta Opcje (Options) pokazuje wtedy własne kopie tych trzech ustawień trybu turbo pod tymi samymi nazwami, a Dynamiczne przeliczanie (Dynamic recount) oferuje Tak, dla wszystkich urządzeń (Yes, for all devices) lub Tak, tylko dla PC (Yes, only for PC).

  • Nie można wyłączyć AJAX, gdy tryb turbo jest włączony. Ustaw Włącz tryb turbo (Enable turbo mode) na Nie (No), zapisz i dopiero potem zmień Próbuj zajaxować sklep (Try to ajaxify the shop).
  • Jeśli siatka produktów motywu psuje się po filtrowaniu AJAX (jeden produkt w wierszu, utracone kolumny, zepsuta paginacja), tryb turbo dziedziczy ten problem: zobacz ustawianie liczby kolumn w trybie AJAX i problemy z paginacją w trybie AJAX albo nie używaj trybu turbo z tym motywem.
  • Po wyłączeniu trybu turbo ustaw ponownie Pokaż ilość (Show count), Dynamiczne przeliczanie (Dynamic recount) i Ukryj puste określenia (Hide empty terms): nadal mają wartość Nie (No), dlatego w tym momencie liczniki znikają.
  • Ukryj puste określenia (Hide empty terms) działa tylko przy włączonych Pokaż ilość (Show count) i Dynamiczne przeliczanie (Dynamic recount); wyłączenie Pokaż ilość (Show count) wyłącza oba pozostałe.
  • Cache'uj dynamiczny numer ponownego liczenia dla każdego elementu w filtrze (Cache dynamic recount number for each item in filter), Określenia cache (Cache terms) i Optymalizuj filtr cen (Optimize price filter) znikają z Zaawansowane (Advanced) → Opcje (Options), gdy tryb turbo jest włączony; nie mają do niego zastosowania.

Czego tryb turbo nie potrafi

  • Element Hierarchiczna lista rozwijana (Hierarchy drop-down) z nim nie działa, co wymienia strona rozszerzenia Tryb turbo.
  • Liczniki i Ukryj puste określenia (Hide empty terms) działają dla elementów standardowych (pole wyboru, przycisk opcji, listy rozwijane, kolor, obraz, etykieta, suwak). Elementy zbudowane w Smart Designer nie mają liczników.
  • Na stanie (In stock) uwzględnia tylko własny status magazynowy każdego produktu; ustawienie sprawdzające warianty nie ma wpływu, więc filtr według rozmiaru nadal może pokazywać niedostępne warianty.
  • Wyszukiwanie tekstowe porównuje wpisane słowa wyłącznie z tytułami produktów, nawet jeśli element wyszukiwania tekstowego jest ustawiony tak, by szukać w opisach lub innych polach. Osobny element SKU działa.
  • Warunki dodane w PHP nie biorą udziału w wyszukiwaniu, ponieważ o dopasowaniu produktów decyduje przeglądarka. Własny kod na woof_products_query lub pre_get_posts, własne rozszerzenia i wtyczki ograniczające produkty według sprzedawcy lub grupy klientów mogą co najwyżej ukryć część znalezionych produktów po fakcie, co rozsynchronizuje liczniki i paginację.

Jeśli twój sklep potrzebuje któregoś z tych elementów albo jego ceny i stany zmieniają się co godzinę, wyłącz tryb turbo i przyspiesz tryb normalny za pomocą pamięci podręcznej.

Lista kontrolna

  • Brak czerwonych błędów w konsoli; skrypty wtyczki wyłączone z opóźniania, odraczania i łączenia.
  • woof_turbo_mode_file.length zgadza się z liczbą opublikowanych produktów plus wariantów; licznik nie zatrzymał się na limicie.
  • Plik przebudowany po ostatnim imporcie lub zmianie filtra; pamięć podręczna stron i CDN wyczyszczone.
  • Produkty zaznaczone w całym łańcuchu kategorii, z widocznością Sklep i wyniki wyszukiwania (Shop and search results).
  • Ustawienia liczników ustawione w kopiach trybu turbo i ponownie po jego wyłączeniu.

Jeśli filtr nadal działa nieprawidłowo, otwórz wątek na forum wsparcia HUSKY, podając link do strony, błędy z konsoli, wartość woof_turbo_mode_file.length oraz liczbę produktów i wariantów w sklepie.