Filtr produktów WooCommerce nie wyświetla się na telefonie: przyczyny i naprawa
Filtr działa na komputerze, ale na telefonie nie ma paska bocznego, przycisk Otwórz filtr (Open filter) w ogóle się nie pojawia albo pojawia się i nic nie robi. Filtr produktów WooCommerce niewyświetlający się na telefonie rzadko jest zepsuty. Tryb mobilny HUSKY składa się z trzech elementów: serwer rozpoznaje, że odwiedzający korzysta z telefonu, skrypt przenosi przycisk na właściwe miejsce, a dotknięcie otwiera formularz jako panel na cały ekran. Każdy z tych elementów może zablokować motyw, page builder, pamięć podręczna lub optymalizator. Ten poradnik pokazuje, który element zawiódł i jak to naprawić.
Jak działa tryb mobilny HUSKY
Wiele motywów w ogóle nie wyświetla paska bocznego na telefonach. Jeśli filtr jest widżetem paska bocznego i nic więcej nie zostało skonfigurowane, samo to wyjaśnia, dlaczego go brakuje. Tryb mobilny to sposób wtyczki na to, by dać telefonom przycisk otwierający filtr. W ustawieniach nie ma globalnego przełącznika „mobilnego”; tryb mobilny włącza się osobno dla każdego formularza filtra:
- Widżet: ustaw Tryb mobilny (Mobile mode) na Tak (Yes) w widżecie HUSKY.
- Shortcode:
[woof sid="mobile" mobile_mode=1]. Atrybutsidjest wymagany; bez niegomobile_modejest ignorowany. - Front builder: włącz Tryb mobilny (Mobile mode) w opcjach formularza
[woof_front_builder].
Gdy strona jest generowana dla telefonu, wtyczka wypisuje ten formularz jako ukryty i dodaje do niego dwa przyciski, Otwórz filtr (Open filter) i Zamknij filtr (Close filter). Na komputerach ten sam formularz wyświetla się normalnie. Gdy strona ładuje się na telefonie, skrypt przenosi przycisk Otwórz filtr (Open filter) z ukrytego formularza w widoczne miejsce:
- do kontenera wypisanego przez shortcode [woof_mobile], jeśli strona go zawiera;
- w przeciwnym razie do elementu pasującego do
.woocommerce-products-header, czyli bloku z tytułem sklepu lub kategorii w standardowym szablonie archiwum WooCommerce.
Dotknięcie przycisku dodaje do formularza klasę woof_show_filter_for_mobile, która zamienia go w panel o stałym położeniu, rozciągnięty na cały ekran nad stroną. W trybie AJAX panel zamyka się sam po każdym filtrowaniu, dzięki czemu odwiedzający widzi nowe produkty.
Większość problemów wyjaśniają dwa fakty. Po pierwsze, „telefon” jest rozpoznawany po stronie serwera przez funkcję WordPressa wp_is_mobile() na podstawie nagłówków żądania, a nie szerokości ekranu. Po drugie, [woof_mobile] jedynie oznacza miejsce: nic nie wyświetla, jeśli na tej samej stronie nie ma formularza z włączonym trybem mobilnym.
Przycisk Otwórz filtr (Open filter) się nie pojawia
Szablon nie ma dla niego miejsca. W szablonach theme buildera Elementora i Divi, układach Avada, własnych stronach wyświetlających produkty shortcodem [products] oraz w wielu motywach niestandardowych często brakuje bloku .woocommerce-products-header. Przycisk zostaje wtedy wewnątrz ukrytego formularza. Umieść [woof_mobile] dokładnie tam, gdzie ma być przycisk, zwykle nad produktami, w widżecie lub bloku Shortcode. To najczęstsze rozwiązanie. Na komputerach nic nie wypisuje, więc może zostać na stronie.
Jeśli w tym szablonie nie możesz umieścić shortcode'u, wskaż przyciskowi własny element za pomocą haka woof_mobile_btn_place_container. Nadaj temu elementowi unikalny identyfikator (w Elementorze: Zaawansowane → ID CSS (Advanced → CSS ID)) i użyj go:
/*
* HUSKY: where to put the mobile "Open filter" button.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_mobile_btn_place_container', function ($selector) {
return '#filter-button-place';
});
Użyj selektora, który pasuje tylko do jednego elementu. Szeroka klasa, taka jak .elementor-widget-container, skopiuje przycisk do każdego pasującego elementu na stronie. Hak nie jest używany, gdy na stronie jest kontener [woof_mobile].
Inne powody braku przycisku:
- Motyw ukrywa to miejsce na telefonach (nagłówek lub pasek narzędzi widoczny tylko na komputerach). Wybierz miejsce widoczne na urządzeniach mobilnych.
- Przycisk początkowo się pokazuje, a po filtrowaniu znika: kontener
[woof_mobile]znajduje się wewnątrz listy produktów, którą AJAX podmienia. Przenieś go nad listę. - Optymalizacja JavaScriptu opóźnia skrypty do pierwszego dotknięcia lub przewinięcia („delay JavaScript execution” w WP Rocket i podobnych funkcjach). Przycisk jest przenoszony dopiero po uruchomieniu skryptu wtyczki. Wyklucz
/wp-content/plugins/woocommerce-products-filter/z opóźniania, odraczania (defer) i łączenia, a następnie wyczyść pamięci podręczne. Szczegóły znajdziesz w artykule filtr z WP Rocket i buforowaniem. - Optymalizacja CSS (łączenie plików lub „usuwanie nieużywanego CSS”) usunęła style wtyczki, więc przycisk istnieje na stronie, ale jest ukryty lub niestylowany. Wyklucz także CSS wtyczki.
- Testujesz na tablecie. Safari na iPadzie i Chrome na większych tabletach z Androidem domyślnie żądają wersji desktopowej witryn, więc te tablety dostają układ desktopowy. Jeśli motyw ukrywa pasek boczny przy szerokości tabletu, filtra tam nie ma; pokaż pasek boczny za pomocą CSS albo umieść formularz w obszarze treści.
Przycisk jest, ale nic się nie otwiera
Formularz znajduje się wewnątrz czegoś ukrytego. Przycisk został przeniesiony, ale panelem nadal jest sam formularz, w swoim pierwotnym miejscu. Jeśli motyw ukrywa pasek boczny na telefonach przez display: none, panel otwiera się wewnątrz ukrytego pudełka i pozostaje niewidoczny. Są trzy wyjścia:
- Pokaż pasek boczny na telefonach za pomocą CSS. Formularz HUSKY wewnątrz niego pozostaje ukryty do dotknięcia przycisku, ale pozostałe widżety tego paska bocznego też staną się widoczne, więc to rozwiązanie pasuje do paska zawierającego wyłącznie filtr.
- Przenieś formularz w trybie mobilnym z paska bocznego do obszaru treści, na przykład nad produkty.
- Zostaw widżet dla komputerów (jego Tryb mobilny (Mobile mode) ustawiony na Nie) i pozwól wtyczce umieścić filtr nad produktami tylko na telefonach: Opcje → Ustaw filtr automatycznie → Tak, ale tylko dla urządzeń mobilnych (Options → Set filter automatically → Yes, but only for mobile devices) oraz Wygląd → Ukryj automatyczny filtr domyślnie → Tak (Design → Hide auto filter by default → Yes) dla przycisku pokaż/ukryj. Wymaga to szablonu uruchamiającego standardową pętlę produktów WooCommerce.
Typowa reguła dla pierwszego sposobu, z selektorem dostosowanym do Twojego motywu:
/* Theme hides #secondary (sidebar) on phones: keep it for the HUSKY panel */
@media (max-width: 768px) {
body.woocommerce-page #secondary {
display: block;
}
}
To samo dzieje się, gdy filtr znajduje się w wysuwanym panelu motywu (off-canvas) lub w oknie popup Elementora: panel wysuwany lub popup ma własną widoczność i własne skrypty, a panel filtra nie może się z jego wnętrza otworzyć. Używaj albo wysuwanego panelu, albo trybu mobilnego HUSKY, nie obu naraz.
Parametr sid zawiera spację. Składnia skórek, na przykład sid="flat_grey woof_auto_3_columns", sprawdza się dla wyglądu formularza, ale w wersji 3.4.6 przycisk mobilny nie znajduje formularza, którego sid składa się z dwóch słów. Dla formularza w trybie mobilnym użyj sid jednowyrazowego.
Na stronie są dwie kopie filtra. Page buildery często zawierają jedną sekcję dla komputerów i duplikat dla urządzeń mobilnych, ukryte przez responsywną widoczność. Obie są w kodzie HTML, tylko ukryte przez CSS, więc dwa formularze o tych samych identyfikatorach przeszkadzają sobie nawzajem: sekcje przestają się otwierać, pojawiają się dwie ikony filtra albo przycisk otwiera kopię, której nie widzisz. Zostaw na stronie jeden filtr i pozwól trybowi mobilnemu obsłużyć telefony.
Błąd skryptu. Otwórz stronę na telefonie lub w emulacji urządzenia na komputerze po jej przeładowaniu i sprawdź konsolę przeglądarki. Błąd w dowolnym skrypcie ładowanym przed skryptem HUSKY zatrzymuje również jego.
Układ mobilny na komputerze, układ desktopowy na telefonie
Ponieważ decyzja zapada w chwili generowania strony, pamięć podręczna strony, która przechowuje jedną kopię dla wszystkich, serwuje to, co zobaczył pierwszy odwiedzający. Użytkownicy komputerów dostają wtedy przycisk Otwórz filtr (Open filter) i ukryty formularz albo użytkownicy telefonów dostają pełny pasek boczny bez przycisku, a po każdym wyczyszczeniu pamięci podręcznej to się zmienia. Rozwiązanie leży w pamięci podręcznej, a nie w filtrze:
- WP Rocket: włącz buforowanie dla urządzeń mobilnych oraz Osobne pliki pamięci podręcznej dla urządzeń mobilnych (Separate cache files for mobile devices).
- LiteSpeed Cache: włącz Cache Mobile.
- Buforowanie stron w Cloudflare, Varnish lub pamięć podręczna hostingu: buforuj według typu urządzenia albo wyklucz strony sklepu i kategorii.
Po zmianie wyczyść wszystkie pamięci podręczne. To samo dotyczy widoczności mobilnej rozszerzenia slideout oraz opcji Ustaw filtr automatycznie (Set filter automatically) z wartościami Tak, ale tylko dla urządzeń mobilnych (Yes, but only for mobile devices) i Tak, ale tylko dla PC (Yes, but only for desktop), które również korzystają z wp_is_mobile().
Z tego samego powodu zmiana rozmiaru okna przeglądarki na komputerze nigdy nie przełącza filtra w tryb mobilny. Testuj na prawdziwym telefonie, po wylogowaniu, albo w emulacji urządzenia w przeglądarce z przeładowaniem strony.
Problemy wewnątrz otwartego panelu
Listy rozwijane są zwinięte, puste albo otwierają klawiaturę. Listy rozwijane Chosen i SelectWoo obliczają swoją szerokość przy ładowaniu strony, gdy formularz jest jeszcze ukryty, a ponadto mają pole wyszukiwania, które wywołuje klawiaturę telefonu. Najczystszym rozwiązaniem jest Wygląd → Skórka listy rozwijanej → Native (Design → Drop-down skin → Native): telefony pokazują wtedy własną listę wyboru, bez pola wyszukiwania i bez problemów z szerokością. Aby zachować Chosen lub SelectWoo, nadaj im minimalną szerokość:
/* HUSKY: drop-downs collapsed in a hidden or narrow container */
.woof .chosen-container,
.woof .select2-container {
min-width: 200px;
}
Panel jest półprzezroczysty, ukryty pod przyklejonym nagłówkiem albo jego tekst jest niewidoczny. Panel jest domyślnie lekko przezroczysty i używa z-index: 9999, który niektóre przyklejone nagłówki przekraczają. Dostosuj go we własnym CSS:
/* HUSKY mobile panel: opaque, above the sticky header, readable text */
.woof_show_filter_for_mobile.woof {
opacity: 1;
z-index: 100000;
}
.woof_show_filter_for_mobile.woof h4,
.woof_show_filter_for_mobile.woof label {
color: #333;
}
Jeśli panel nadal otwiera się pod nagłówkiem (nagłówek znajduje się w kontekście warstw, nad który panel nie może się wznieść), dodaj padding-top: 90px; do pierwszej reguły, aby przycisk Zamknij filtr (Close filter) zaczynał się poniżej nagłówka.
Panel zamyka się po każdym dotknięciu. Przy autowysyłaniu i AJAX każdy wybór uruchamia filtrowanie, a panel zamyka się, by pokazać wyniki. Jeśli odwiedzający zwykle łączą kilka opcji, wyłącz autowysyłanie dla tego formularza, [woof sid="mobile" mobile_mode=1 autosubmit=0], aby najpierw dokonali wyboru, a potem dotknęli przycisku filtrowania.
Drobne usterki na iPhonie. Przesunięty tekst zastępczy w polu wyszukiwania tekstowego naprawia się regułą .woof_container .woof_container_inner input[type="search"] { line-height: normal !important; }. Liczniki produktów w filtrach typu etykieta, które odsuwają się od swoich etykiet, naprawia się regułą .woof_container_label .woof_list_label li { position: relative; }.
Zmiana wyglądu przycisku
Wygląd przycisku ustawia się w zakładce Wygląd (Design): Obrazek przycisku filtra mobilnego (Image for mobile filter button), Tekst przycisku filtra mobilnego (Text for mobile filter button), Obrazek zamykający filtr mobilny (Image to close mobile filter) i Tekst zamykający filtr mobilny (Text to close mobile filter). Wpisz -1 w polu obrazka, aby pokazać tylko tekst, lub w polu tekstu, aby pokazać tylko ikonę. Odstępy i kolor to zwykły CSS dla .woof_show_mobile_filter, na przykład .woof_show_mobile_filter { margin: 10px 0 20px; color: #796699; }.
Podstawowe kroki konfiguracji opisuje artykuł jak wyświetlić filtr na urządzeniach mobilnych, a wszystkie atrybuty głównego shortcode'u zawiera opis [woof].
Lista kontrolna
- Jeden formularz filtra na stronie, z włączonym trybem mobilnym (opcja widżetu, albo
mobile_mode=1z jednowyrazowymsid, albo opcja front buildera). [woof_mobile]umieszczony tam, gdzie ma być przycisk, poza listą produktów, w miejscu widocznym na telefonach.- Sam formularz nie znajduje się na pasku bocznym, w wysuwanym panelu ani w popupie ukrytym na telefonach.
- JavaScript i CSS wtyczki są wykluczone z opóźniania, odraczania, łączenia i usuwania nieużywanego CSS.
- Pamięć podręczna strony przechowuje osobne kopie dla urządzeń mobilnych, a wszystkie pamięci podręczne zostały wyczyszczone.
- Przetestowano na prawdziwym telefonie albo w emulacji urządzenia z przeładowaniem strony, po wylogowaniu.
Jeśli filtr nadal nie wyświetla się na telefonie, załóż wątek na forum wsparcia HUSKY, podając link do strony, używany shortcode lub ustawienia widżetu oraz błędy z konsoli przeglądarki.