HUSKY - WooCommerce Product Filter Professional

Paginacja filtra WooCommerce nie działa: przyczyny i rozwiązania

Paginacja filtra WooCommerce niedziałająca poprawnie objawia się zwykle na jeden z kilku sposobów: linki stron prowadzące do /wp-admin/admin-ajax.php?paged=2, pusta strona z jednym znakiem 0, puste strony lub błąd 404 na końcu przefiltrowanych wyników, filtr zapomniany na stronie 2 albo infinite scroll, który zatrzymuje się po pierwszym filtrowaniu. Każdy objaw ma własną przyczynę, a większość wynika ze sposobu, w jaki motyw buduje paginację, a nie z samego filtra. Zacznij od tabeli, a potem przejdź do odpowiedniej sekcji.

Co widziszPrawdopodobna przyczyna
Linki do admin-ajax.php?paged=2, pusta strona z 0Tryb AJAX z niestandardowym kodem paginacji
Dwie paginacje lub dwa wiersze „Wyświetlanie 1–12 z 40” po filtrowaniuMotyw wypisuje własne elementy poza obszarem odświeżanym przez HUSKY
Więcej stron niż produktów, ostatnie strony zwracają 404 lub są pusteRóżne liczby „produktów na stronę” w HUSKY, motywie i builderze
Pusta siatka po zmianie filtra na stronie 3Stary numer strony przechodzi do nowego linku filtra
Filtr martwy lub bez stylów po przejściu na stronę 2Własna paginacja AJAX motywu, przycisk „załaduj więcej” lub infinite scroll
Brak filtra na stronie 2 albo strona 2 pokazuje nieprzefiltrowane produktyFiltr umieszczony w treści strony lub linki paginacji, które gubią filtr
Brak paginacji po filtrowaniuNiestandardowy szablon lub motyw, który wypisuje paginację poza hakami pętli

Linki do admin-ajax.php: tryb AJAX i kod motywu

Gdy Próbuj zajaxować sklep (Try to ajaxify the shop) jest ustawione na Tak (Yes) (lub na stronie użyto [woof_products is_ajax=1]), HUSKY nie przeładowuje strony. Prosi serwer o nowe produkty przez admin-ajax.php i podmienia blok produktów razem z paginacją. Ponieważ ta nowa paginacja jest generowana wewnątrz żądania AJAX, jej linki prowadzą do admin-ajax.php?paged=2. Nigdy nie mają być otwierane: HUSKY przechwytuje kliknięcia w .woocommerce-pagination a.page-numbers, odczytuje numer strony i ładuje ją przez AJAX.

Jeśli motyw zmienia kod paginacji (inna klasa na elemencie opakowującym, linki bez klasy page-numbers, własna funkcja paginacji), kliknięcie nie zostaje przechwycone, a przeglądarka otwiera surowy link. WordPress odpowiada na żądanie do admin-ajax.php bez akcji znakiem 0, co daje pustą stronę. Kod, którego oczekuje HUSKY, to standardowy kod WooCommerce:

<nav class="woocommerce-pagination">
  <ul class="page-numbers">
    <li><span aria-current="page" class="page-numbers current">1</span></li>
    <li><a class="page-numbers" href="https://example.com/shop/page/2/">2</a></li>
    <li><a class="next page-numbers" href="https://example.com/shop/page/2/">&rarr;</a></li>
  </ul>
</nav>

Sprawdź swoją paginację w inspektorze przeglądarki i porównaj. Motyw, który nadpisuje woocommerce/loop/pagination.php lub używa własnej paginacji, można naprawić w motywie potomnym (wystarczy nawet literówka, taka jak woocmmerce-pagination w klasie elementu opakowującego), ale niezawodne rozwiązanie nie wymaga kodu: przełącz się na tryb przekierowania. Otwórz ustawienia wtyczki, zakładkę Opcje (Options), ustaw Próbuj zajaxować sklep (Try to ajaxify the shop) na Nie (No) i zapisz; na stronach z shortcode'em użyj is_ajax=0. Każde filtrowanie przeładowuje wtedy stronę, a paginacja jest zwykłą paginacją motywu. AJAX nie może zostać wyłączony tylko dla paginacji. Zobacz także problemy z paginacją w trybie AJAX.

Jeśli opcja zapisuje się, ale wraca do Tak (Yes), włączony jest tryb Turbo. Tryb Turbo działa tylko z AJAX i przy każdym ładowaniu strony przełącza opcję z powrotem na włączoną; najpierw wyłącz tryb Turbo.

Zdublowana paginacja lub licznik wyników, który się nie aktualizuje

Niektóre motywy wypisują licznik wyników, sortowanie lub paginację poza blokiem, który podmienia HUSKY. Po filtrowaniu AJAX widać wtedy nieaktualny element motywu obok świeżego albo licznik, który nadal opisuje nieprzefiltrowany sklep. Dla licznika wpisz jego selektor, zwykle .woocommerce-result-count, w Zaawansowane → Opcje → Selektor CSS licznika wyników (Advanced → Options → Result count css selector); HUSKY odrysuje go wtedy po każdym filtrowaniu (Selektor CSS listy sortowania (Order dropdown css selector) robi to samo dla sortowania). Jeśli duplikaty pozostają, usuwa je tryb przekierowania.

Dodatkowe strony i błąd 404 na końcu wyników

WordPress ustala, czy /page/7/ istnieje, na podstawie głównego zapytania strony: jeśli główne zapytanie ma sześć stron, strona 7 to błąd 404, niezależnie od tego, co pokazuje siatka produktów na tej stronie. Problemy zaczynają się, gdy widoczna siatka i główne zapytanie liczą produkty na stronę inaczej, na przykład widżet buildera pokazuje 30 na stronę, a główne zapytanie używa 12 z motywu: paginacja i istniejące numery stron przestają się zgadzać, a strony bywają puste lub kończą się błędem 404 w połowie. Własne ustawienie HUSKY, Zaawansowane → Opcje → Produktów na stronę (Advanced → Options → Products per page), działa tylko wtedy, gdy filtr jest aktywny (jego wartość domyślna, -1, oznacza „nie zarządzaj”), więc niezgodność z nim pojawia się dopiero po filtrowaniu.

  1. Znajdź wszystkie miejsca, które ustawiają tę liczbę: ustawienia katalogu motywu lub WooCommerce, widżet produktów buildera oraz Produktów na stronę (Products per page) w HUSKY.
  2. Ustaw tę samą liczbę we wszystkich albo ustaw w HUSKY wartość -1, aby nie ingerował.
  3. Przetestuj bez filtra: na chwilę dezaktywuj HUSKY i otwórz bezpośrednio wysoką stronę, na przykład /shop/page/17/. Jeśli teraz jest to błąd 404, niezgodność występuje między motywem a builderem, a nie w filtrze.

Jeśli liczba stron jest nadal zbyt wysoka tylko podczas filtrowania, motyw prawdopodobnie oblicza paginację z innego zapytania; artykuł naprawa paginacji pokazującej zbyt wiele stron zawiera fragment kodu, który wymusza sumę z przefiltrowanego zapytania. Avada ma własny przypadek, opisany w artykule Avada: filtr gubiony przy paginacji.

Pusta strona po zmianie filtra na stronie 2 lub dalszej

Odwiedzający na stronie 3 zmienia filtr. Nowy wynik ma jedną stronę, więc jeśli nowy link nadal prosi o stronę 3, siatka jest pusta albo strona zwraca błąd 404. HUSKY zapobiega temu w standardowej paginacji: usuwa /page/N/ i parametr WooCommerce product-page z budowanego linku, a w trybie AJAX przy każdej zmianie wraca do strony 1. Inne parametry strony w ciągu zapytania są kopiowane do nowego linku razem z resztą adresu, na przykład ?paged=3 w witrynach ze zwykłymi bezpośrednimi odnośnikami lub własny parametr paginacji buildera. Używaj ładnych bezpośrednich odnośników (Ustawienia → Bezpośrednie odnośniki (Settings → Permalinks), dowolna struktura poza Zwykłe (Plain)) i standardowej paginacji WooCommerce oraz sprawdzaj adres po zmianie filtra: nie powinien zawierać numeru strony.

Paginacja AJAX motywu, „załaduj więcej” i infinite scroll

Wiele motywów ma własny sklep AJAX: paginację, przyciski „załaduj więcej”, infinite scroll, sortowanie AJAX lub przełącznik siatka/lista, które podmieniają produkty i pasek boczny bez przeładowania. HUSKY inicjalizuje swój formularz przy ładowaniu strony (i po własnym odświeżeniu AJAX). Gdy motyw podmienia kod HTML paska bocznego, nowe elementy filtra nigdy nie są inicjalizowane, więc filtr przestaje reagować, traci style lub wysyła błędne wartości. Żądanie „załaduj więcej” motywu buduje też własne zapytanie o „następną stronę” i nie wie o filtrze, dlatego może dodawać nieprzefiltrowane produkty do przefiltrowanej listy.

  • Wyłącz paginację AJAX motywu, sklep AJAX, infinite scroll i opcje „załaduj więcej” oraz przetestuj ze standardową paginacją. To naprawia większość przypadków.
  • Dla infinite scroll HUSKY ma wbudowaną obsługę darmowej wtyczki YITH Infinite Scrolling: po każdym filtrowaniu AJAX ponownie inicjalizuje przewijanie i poprawia link do następnej strony. Użyj selektorów podanych w artykule infinite scroll dla przefiltrowanych produktów.
  • Każdy inny skrypt, który musi wystartować ponownie po filtrowaniu AJAX, może nasłuchiwać zdarzenia woof_ajax_done, opisanego w artykule zdarzenie woof_ajax_done. To, jakie wywołanie go restartuje, zależy od tego skryptu; zapytaj jego autora.
/*
 * Runs after every HUSKY AJAX filtering.
 * Put it in a JavaScript file of your child theme.
 */
jQuery(document).on('woof_ajax_done', function () {
    // call the init function of your infinite scroll or load-more script here
});

Zamiast pliku motywu treść tej funkcji można wpisać w Zaawansowane → Kod → Kod JavaScript po zakończeniu AJAX (Advanced → Code → JavaScript code after AJAX is done).

Filtr zniknął lub został zapomniany na stronie 2

  • Filtr znika na stronie 2. Został umieszczony w treści strony sklepu lub w opisie kategorii. WooCommerce wypisuje oba tylko na pierwszej stronie archiwum. Umieść filtr w widżecie paska bocznego, w obszarze motywu pojawiającym się na każdej stronie albo w bloku buildera poza opisem.
  • Strona 2 pokazuje nieprzefiltrowane produkty. W trybie przekierowania standardowa paginacja WooCommerce zachowuje filtr w swoich linkach (/shop/page/2/?swoof=1&pa_color=red). Najedź na link strony: jeśli brakuje swoof=1 i wartości filtra, motyw buduje własne linki bez ciągu zapytania; przełącz się na standardową paginację albo napraw funkcję linków motywu.
  • Strona 2 przekierowuje do sklepu lub gubi kategorię. Wtyczki i własny kod, które przepisują adresy produktów lub slugi archiwów, mogą kolidować z linkami filtra. Przetestuj z wyłączonymi; jeden znany przypadek opisuje artykuł HUSKY i Permalinks Manager Pro.

Brak paginacji po filtrowaniu

W trybie AJAX odświeżony blok zawiera wszystko, co WooCommerce wypisuje na haku woocommerce_after_shop_loop, a właśnie tam znajduje się paginacja WooCommerce. Motyw, który usuwa paginację z tego haka i wypisuje własną gdzie indziej, traci ją po pierwszym filtrowaniu AJAX; tryb przekierowania omija ten problem. Jeśli masz własny szablon archiwum, wypisz paginację po pętli produktów samodzielnie:

<?php
// In your WooCommerce archive template (child theme), after the product loop:
woocommerce_pagination();
?>

Własny szablon potrzebuje też standardowych haków pętli sklepu, aby tryb AJAX w ogóle działał; które to haki, wyjaśnia artykuł adres filtra się zmienia, ale produkty nie.

Aby po zmianie strony przenieść odwiedzających z powrotem na górę produktów, zobacz automatyczne przewijanie po filtrowaniu AJAX albo, w trybie przekierowania, automatyczne przewijanie do produktów w trybie przekierowania.

Lista kontrolna, gdy paginacja filtra WooCommerce nie działa

  • Przetestowano w trybie przekierowania (Próbuj zajaxować sklep (Try to ajaxify the shop) = Nie (No), tryb Turbo wyłączony, is_ajax=0 w shortcode'ach) po wyczyszczeniu wszystkich pamięci podręcznych.
  • Kod paginacji to nav.woocommerce-pagination z linkami a.page-numbers.
  • Liczba produktów na stronę jest taka sama w motywie, builderze i HUSKY albo w HUSKY wynosi -1.
  • Paginacja AJAX motywu, „załaduj więcej” i infinite scroll są wyłączone albo inicjalizowane ponownie przy woof_ajax_done.
  • Linki paginacji na przefiltrowanej stronie zawierają swoof=1 i wartości filtra, a po zmianie filtra nie przetrwa żaden stary numer strony.
  • Filtr znajduje się na pasku bocznym lub w obszarze szablonu, a nie w opisie sklepu czy kategorii.

Jeśli paginacja nadal zawodzi w trybie przekierowania ze standardową paginacją motywu, załóż wątek na forum wsparcia HUSKY, podając link do strony i adres strony, która zawodzi.