Dlaczego filtr w WooCommerce pokazuje pusto, mimo że produkty są w katalogu?
Pusty wynik filtra nie oznacza od razu, że sklep nie ma produktów. W WooCommerce częściej chodzi o niespójność między danymi produktu, logiką warunków filtrowania i sposobem, w jaki motyw lub wtyczka buduje zapytanie. Ten sam katalog może być widoczny w archiwum, a jednocześnie zwracać zero po zawężeniu po atrybucie, statusie magazynowym albo kombinacji warunków.
Najpierw warto odróżnić dwa scenariusze: produktów faktycznie nie ma w wynikach, albo są, ale filtr ich nie uwzględnia przez błąd konfiguracji. W praktyce najczęściej problem dotyczy globalnych atrybutów, widoczności produktu w katalogu, publikacji, wariantów lub zbyt restrykcyjnego łączenia warunków AND zamiast OR.
Typowy przypadek
Sklep sprzedaje odzież, a filtr rozmiaru zwraca pustą stronę. Po sprawdzeniu okazuje się, że część produktów ma rozmiar wpisany tylko w opisie albo jako własny atrybut produktu, a filtr opiera się na globalnej taksonomii pa_size. Dla WooCommerce to nie są te same dane, więc filtr nie widzi dopasowania.
Co sprawdzać w pierwszej kolejności
Jeśli filtr pokazuje zero, zacznij od odpowiedzi na proste pytanie: czy produkt ma właściwy atrybut zapisany w tej samej formie, której oczekuje filtr. Dopiero potem szukaj problemu w indeksie, cache albo konflikcie z wyszukiwarką sklepu.
Jak sprawdzić, czy atrybuty i terminy są spójnie przypisane do produktów?
Jeśli filtr zwraca puste wyniki, pierwszym podejrzeniem powinny być nie indeksy, lecz same dane produktu. W WooCommerce filtr opiera się na atrybutach, terminach taksonomii i sposobie ich przypisania, więc nawet drobna niespójność potrafi wyzerować wyniki dla całej kategorii.
Najważniejsze rozróżnienie dotyczy globalnych atrybutów i atrybutów wpisanych lokalnie do produktu. Filtr koloru, rozmiaru albo marki zwykle szuka wartości w taksonomii produktu, a nie w opisie, nazwie wariantu czy własnym polu tekstowym. Jeśli część katalogu ma dane zapisane w innej formie niż reszta, system filtrów uzna je za niepasujące.
- Czy atrybut jest globalny i ma własną taksonomię, na przykład pa_color lub pa_size.
- Czy produkt ma przypisany termin, a nie tylko nazwę wpisaną ręcznie w opisie.
- Czy produkty wariantowe mają atrybuty zsynchronizowane z wariantami, a nie tylko z kartą produktu.
- Czy ten sam atrybut jest używany konsekwentnie w całym katalogu, bez mieszania słów, synonimów i różnych zapisów.
Praktyczny przykład
W sklepie odzieżowym filtr rozmiaru zwracał zero, mimo że produkty były dostępne. Problemem okazało się to, że część towarów miała rozmiar wpisany jako zwykły tekst, a część jako globalny atrybut sklepu. Dla WooCommerce to dwa różne źródła danych, więc filtr widział tylko część katalogu.
Dlaczego to tak często umyka?
Przy ręcznym dodawaniu produktów łatwo stworzyć pozornie poprawny katalog: klient widzi rozmiar lub kolor na karcie produktu, ale filtr nie ma czego odczytać z taksonomii. Dlatego przy diagnostyce warto zawsze zacząć od jednego produktu testowego i sprawdzić go od strony atrybutów, wariantów oraz przypisanych terminów, zanim przejdzie się do indeksów i cache.
Czy indeks filtrów jest aktualny i co może go rozjechać?
W filtrowaniu WooCommerce sam fakt, że produkt istnieje w katalogu, nie gwarantuje jeszcze, że pojawi się w wynikach filtra. Jeśli używasz wtyczki faceted search albo mechanizmu opartego na indeksie, dane o atrybutach i terminach muszą być zsynchronizowane z tym, co zostało zapisane w bazie. Po masowej edycji produktów, imporcie lub zmianie atrybutów filtr może przez chwilę pracować na starym obrazie katalogu.
Kiedy to wygląda jak błąd danych, a kiedy jak błąd indeksu
Jeśli produkt ma poprawnie przypisany atrybut, ale filtr nadal go nie widzi, podejrzenie pada na indeks, cache albo transients. Jeśli z kolei część katalogu była zbudowana niespójnie od początku, przebudowa indeksu nic nie da, bo w indeksie po prostu nie ma właściwych terminów. To ważne rozróżnienie: naprawa danych i naprawa indeksu to dwa różne kroki.
Przykład po imporcie produktów
Po dużym imporcie nowych wariantów filtr koloru zaczął zwracać mniej wyników niż wcześniej. Produkty były widoczne w sklepie, ale nie pojawiały się po zawężeniu po atrybucie, dopóki nie odświeżono indeksu i nie wyczyszczono pamięci podręcznej. To typowy scenariusz, gdy warstwa wyszukiwania trzyma stare dane mimo aktualizacji katalogu.
- Czy wtyczka filtrowania ma własną opcję przebudowy indeksu i czy została uruchomiona po zmianach w katalogu.
- Czy po imporcie, masowej edycji lub zmianie atrybutów wyczyszczono cache strony i ewentualne transients.
- Czy zadania cykliczne i cron działają prawidłowo, jeśli indeks odświeża się automatycznie.
- Czy hosting lub warstwa optymalizacji nie blokuje aktualizacji danych filtrowania lub nie serwuje starych odpowiedzi.
Uwaga na zależność od wtyczki
Mechanizm indeksowania nie jest identyczny w każdej wtyczce. Inaczej działa filtr natywny, inaczej rozszerzenie AJAX, a jeszcze inaczej rozbudowany silnik faceted search. Zanim uznasz indeks za winny, sprawdź dokumentację konkretnego rozwiązania oraz to, czy jego indeks obejmuje wszystkie używane atrybuty i typy produktów.
Jak wyszukiwanie WooCommerce wpływa na wyniki filtrów i faset?
W WooCommerce filtr nie działa w próżni. Ostateczny wynik zależy od tego, jak zbudowane jest zapytanie, czy sklep korzysta z natywnego wyszukiwania, oraz czy motyw albo wtyczka nie nadpisują logiki query. Dlatego ten sam filtr może działać poprawnie na archiwum kategorii, a zwracać pusto w wynikach wyszukiwania lub na stronie z sortowaniem i paginacją.
Najczęściej problem zaczyna się wtedy, gdy wyszukiwarka sklepu i filtr fasetowy próbują naraz modyfikować to samo zapytanie WP_Query. Jeżeli jedna warstwa usuwa część warunków, a druga dopisuje własne ograniczenia, wynik końcowy może być zbyt wąski albo całkiem pusty. W praktyce dotyczy to zwłaszcza konfiguracji z AJAX, pre_get_posts, niestandardowym sortowaniem i szablonami, które ręcznie przebudowują archiwum produktów.
Praktyczny scenariusz
Sklep ma działający filtr kolorów na stronie kategorii, ale po wejściu w wyniki wyszukiwania ten sam filtr zwraca zero. Po analizie okazuje się, że motyw nadpisuje główne zapytanie i nie przekazuje części warunków taksonomii. Z perspektywy użytkownika wygląda to jak awaria filtra, ale technicznie problem leży w sposobie budowania query, a nie w samych atrybutach produktu.
Na co uważać
Wyszukiwanie, faceted search i paginacja potrafią reagować inaczej w zależności od motywu oraz wtyczek. Jeśli filtr działa na archiwum, ale nie działa w search results, nie zakładaj od razu błędu w danych produktu. Najpierw sprawdź, czy wyszukiwarka nie zmienia warunków zapytania albo nie ogranicza puli produktów jeszcze przed zastosowaniem filtrów.
Kiedy szukać w dokumentacji
Warto sięgnąć do dokumentacji WordPress i WooCommerce wtedy, gdy filtr zachowuje się inaczej w różnych kontekstach: na kategorii, w wyszukiwarce, po sortowaniu albo na stronie z parametrami w URL. Jeśli używasz wtyczki faceted search, sprawdź też jej własne zasady integracji z WP_Query, bo to właśnie tam zwykle ukrywają się konflikty z motywem lub zewnętrzną wyszukiwarką.
Które konflikty techniczne najczęściej powodują puste wyniki filtrowania?
Jeśli atrybuty są poprawnie przypisane, a filtr nadal zwraca pustą stronę, problem często leży poza samymi danymi produktu. W WooCommerce wyniki potrafią rozjechać się przez cache, nadpisane zapytanie, filtr AJAX, ograniczenia statusu magazynowego albo warstwę optymalizacji, która podmienia odpowiedzi jeszcze przed ich wyświetleniem.
Najpierw warto ustalić, na którym etapie wynik znika. Inaczej debuguje się sytuację, gdy filtr nie działa tylko w wynikach wyszukiwania, a inaczej tę, w której przestaje działać po włączeniu cache lub po przejściu przez AJAX. Taka mapa objawów zwykle szybciej prowadzi do źródła problemu niż przypadkowe zmiany ustawień.
Najczęstsze konflikty w praktyce
- cache strony lub serwera zwraca stare wyniki mimo zmian w katalogu
- CDN albo optymalizator JS zakłóca działanie filtrów AJAX
- motyw modyfikuje główne zapytanie i usuwa część warunków filtrowania
- błędy w query string powodują, że filtr nie przekazuje pełnych parametrów
- ograniczenia statusu magazynowego zawężają pulę produktów do zera
Przykład z cache
Filtr AJAX działa poprawnie po wyłączeniu cache, ale po jego ponownym włączeniu zaczyna zwracać pusto lub pokazuje nieaktualne wyniki. To zwykle oznacza, że warstwa cache przechowuje odpowiedź dla innego zestawu parametrów albo blokuje świeżą wersję zapytania. W takiej sytuacji samo poprawianie atrybutów nie pomoże, dopóki nie wyczyścisz cache i nie sprawdzisz, czy wyjątki dla stron filtrowania są skonfigurowane prawidłowo.
Na co uważać przy diagnostyce
Nie zakładaj od razu, że winne są dane produktu. Jeżeli filtr działa na archiwum kategorii, ale nie działa w wyszukiwarce albo tylko po stronie AJAX, problem najpewniej leży w konflikcie z query, cache lub integracją konkretnej wtyczki. Warto testować po kolei: najpierw bez cache, potem na domyślnym motywie, a dopiero później z aktywnymi rozszerzeniami.
Kiedy sięgnąć do dokumentacji i logów
Jeżeli zachowanie filtra zależy od kontekstu strony, najlepiej sprawdzić dokumentację WooCommerce, wtyczki filtrowania oraz motywu. Pomocne bywają też logi serwera i błędy JavaScript, bo to one pokazują, czy zapytanie jest źle budowane, czy odpowiedź zostaje po drodze nadpisana przez warstwę techniczną.
Jakie kroki naprawcze zwykle przywracają sensowne filtrowanie bez przebudowy sklepu?
Gdy filtr produktów w WooCommerce zwraca puste wyniki, najrozsądniej działać od najprostszych i najmniej inwazyjnych czynności. W praktyce chodzi o odróżnienie problemu z danymi, indeksami, cache oraz konfliktem z motywem lub wtyczką, zamiast od razu przebudowywać cały sklep.
- Sprawdź, czy problem dotyczy jednego atrybutu, jednej kategorii czy całego katalogu.
- Ujednolić przypisanie atrybutów: globalne taksonomie, terminy i warianty muszą wskazywać te same wartości.
- Przebuduj indeks filtrowania, jeśli korzystasz z wtyczki faceted search lub mechanizmu opartego na indeksie.
- Wyczyść cache strony, serwera i ewentualne transients, a potem przetestuj filtr ponownie.
- Uruchom test na domyślnym motywie i z wyłączonymi po kolei wtyczkami, które modyfikują query lub AJAX.
- Jeśli to możliwe, odtwórz problem na stagingu, zanim zmienisz konfigurację produkcyjną.
Praktyczna ścieżka naprawcza
W małych sklepach najczęściej wystarcza ponowne przypisanie atrybutów, odświeżenie indeksu i czyszczenie cache. W większych katalogach warto od razu sprawdzić, czy problem nie wynika z nadpisywania zapytania przez motyw albo z konfliktu z wtyczką AJAX, bo wtedy sama korekta danych nie przyniesie efektu.
- Potwierdź, że produkt ma globalny atrybut, a nie tylko tekst w opisie.
- Sprawdź, czy terminy atrybutów są spójne w całym katalogu.
- Odśwież indeks filtrowania po imporcie lub masowej edycji produktów.
- Wyczyść cache i przetestuj filtr w trybie prywatnym przeglądarki.
- Porównaj działanie filtra na archiwum kategorii, w wyszukiwarce i po AJAX.
- Wyłącz tymczasowo optymalizacje, które mogą nadpisywać odpowiedź lub skrypt filtra.
Kiedy nie warto iść dalej na ślepo
Jeśli po tych krokach filtr nadal zwraca zero tylko w jednym kontekście, na przykład wyłącznie w wynikach wyszukiwania albo wyłącznie po AJAX, problem zwykle leży w logice zapytania, nie w samych produktach. Wtedy lepiej wrócić do dokumentacji konkretnej wtyczki, motywu i WooCommerce niż wykonywać kolejne przypadkowe zmiany.
Kiedy problem leży w konfiguracji, a kiedy w samej architekturze sklepu?
Nie każdy pusty filtr w WooCommerce oznacza błąd konfiguracji. W małym sklepie problem zwykle da się zamknąć w atrybutach, indeksie albo konflikcie z motywem, ale przy rozbudowanym katalogu dochodzi jeszcze skala danych, liczba taksonomii i sposób, w jaki silnik wyszukiwania obsługuje fasety.
Jeśli filtry zaczynają zwracać pusto dopiero po rozbudowie katalogu, po wielu atrybutach lub przy dużej liczbie wariantów, warto zadać pytanie nie tylko o poprawność danych, lecz także o to, czy obecna architektura sklepu nadal daje radę. Prosty zestaw filtrów oparty na domyślnych mechanizmach WooCommerce bywa wystarczający dla niewielkiej oferty, ale przy bardziej złożonym asortymencie może już nie zapewniać stabilnych wyników.
| Sytuacja | Co zwykle wystarcza | Sygnał, że to za mało |
|---|---|---|
| Mały sklep, kilka atrybutów, proste kategorie | Poprawne przypisanie atrybutów, przebudowa indeksu, czyszczenie cache | Filtry działają tylko częściowo albo tylko na wybranych stronach |
| Rozbudowany katalog z wieloma wariantami i fasetami | Dopasowanie sposobu filtrowania do danych i test konfliktów z motywem | Wyniki stają się wolne, niestabilne lub zależne od kontekstu strony |
| Wiele źródeł ruchu i integracji, własne modyfikacje query | Analiza WP_Query, wyszukiwania i cache | Filtr działa w jednym miejscu, a w innym zwraca zero mimo tych samych danych |
| Duża liczba produktów i częste importy | Dedykowany silnik faceted search lub lepsza warstwa indeksowania | Każda większa aktualizacja wymaga ręcznego naprawiania wyników |
Próg, po którym warto myśleć o przebudowie
Jeśli naprawy powtarzają się po każdym imporcie, masowej edycji albo zmianie motywu, to nie jest już pojedynczy incydent, lecz sygnał, że filtracja została zbudowana zbyt blisko granic możliwości katalogu. W takiej sytuacji bardziej opłaca się uprościć model atrybutów, poprawić warstwę wyszukiwania albo przejść na rozwiązanie lepiej dopasowane do skali sklepu.
Nie myl objawu z przyczyną
Pusty filtr może wyglądać jak problem z produktami, ale czasem jest skutkiem architektury: zbyt ciężkich zapytań, nadpisywania query przez motyw, ograniczeń cache lub nieadekwatnego silnika filtrów. Jeśli problem wraca mimo poprawnych danych, dalsze ręczne poprawki katalogu mogą tylko maskować źródło kłopotu.
FAQ
Dlaczego filtr WooCommerce nie pokazuje żadnych produktów, choć produkty istnieją?
Najczęściej dlatego, że filtry są oparte na niespójnych atrybutach, nieaktualnym indeksie, konflikcie z cache lub nadpisaniu zapytania przez motyw albo wtyczkę. Trzeba sprawdzić dane produktu, logikę filtrowania i warstwę techniczną osobno.
Czy atrybut wpisany ręcznie w opisie produktu zadziała w filtrze?
Zwykle nie, jeśli filtr działa na globalnych atrybutach WooCommerce i terminach taksonomii. Wiele filtrów wymaga przypisania atrybutu jako właściwości produktu, a nie tylko tekstu w opisie.
Czy przebudowa indeksu może naprawić puste wyniki?
Tak, jeśli problem wynika z nieaktualnych danych indeksowych po masowej edycji produktów, zmianie atrybutów lub czyszczeniu cache. Jeśli błąd leży w konfiguracji atrybutów, sama przebudowa nie wystarczy.
Jak odróżnić problem filtra od problemu wyszukiwarki sklepu?
Jeśli filtr działa na stronie kategorii, ale nie działa w wynikach wyszukiwania, prawdopodobnie problem dotyczy zapytania wyszukiwania lub nadpisania query. Jeśli nigdzie nie działa, trzeba zacząć od atrybutów, indeksu i konfliktów wtyczek.
Czy wyłączenie cache może pomóc w diagnostyce?
Tak, bo cache potrafi ukryć zmiany lub zwracać stare wyniki zapytań. To dobry krok testowy, zwłaszcza przy filtrach AJAX i przy rozbudowanej optymalizacji frontendu.
Jeśli filtr w Twoim sklepie WooCommerce zwraca puste wyniki, sprawdź najpierw spójność atrybutów, potem indeks i dopiero na końcu konflikty z motywem lub wtyczkami. Uporządkowana diagnostyka zwykle szybciej prowadzi do przyczyny niż przypadkowe zmiany konfiguracji.
Rafał Jóśko
Lokalizacja: Lublin
Pomagam firmom przejść przez chaos świata online. Z ponad 15-letnim doświadczeniem i ponad 360 zrealizowanymi projektami oferuję kompleksowe prowadzenie działań digital: od strategii, przez hosting, SEO i automatyzacje, aż po skuteczne kampanie marketingowe. Tworzę spójne procesy, koordynuję zespoły i eliminuję niepotrzebne koszty – Ty skupiasz się na biznesie, ja dbam o resztę.
Wspieram zarówno startupy, jak i rozwinięte firmy B2B/B2C. Działam z Lublina, ale efekty mojej pracy sięgają daleko poza granice Polski.