Zmieniłeś motyw WordPressa i nagle WooCommerce przestał pokazywać produkty? To jeden z tych problemów, które potrafią sparaliżować sklep w kilka sekund. Niby wszystko jest w panelu administracyjnym: produkty istnieją, stany magazynowe się zgadzają, kategorie są przypisane, ale na froncie sklep wygląda jak pusty. Czasem nie widać całej listy produktów, czasem znikają tylko wybrane kategorie, a czasem archiwum sklepu działa, ale pojedyncze produkty wyświetlają się błędnie lub wcale.
W praktyce taki problem rzadko oznacza utratę danych. Zwykle jest to efekt konfliktu między WooCommerce a nowym motywem, błędnej konfiguracji szablonów, nadpisanych plików, ustawień widoczności lub problemów z cache. Dobra wiadomość jest taka, że w większości przypadków da się to naprawić bez reinstalacji sklepu i bez ryzyka utraty zamówień. Zła wiadomość? Jeśli zrobisz to chaotycznie, możesz przypadkiem pogłębić problem, ukryć kolejne produkty albo uszkodzić układ sklepu na stałe.
W tym artykule przeprowadzę Cię przez diagnozę i naprawę krok po kroku. Pokażę, co sprawdzić najpierw, jak odróżnić problem motywu od problemu wtyczek, kiedy trzeba przejrzeć ustawienia WooCommerce, a kiedy bezpieczniej od razu zlecić naprawę specjalistom.
Szybka odpowiedź
Jeśli WooCommerce nie pokazuje produktów po zmianie motywu, najczęściej przyczyną jest:
- brak pełnej zgodności motywu z WooCommerce,
- nadpisany lub uszkodzony szablon sklepu w motywie,
- wyłączone wyświetlanie produktów w ustawieniach widoczności,
- konflikt z wtyczką do cache, page builderem lub filtrami produktów,
- błędna konfiguracja strony sklepu lub archiwów kategorii,
- problem z miniaturami, zapytaniem do bazy lub stylem ukrywającym elementy frontu.
Najbezpieczniejsza procedura: wykonaj kopię zapasową, sprawdź, czy motyw ma wsparcie WooCommerce, przełącz na motyw domyślny, wyczyść cache, zweryfikuj ustawienia widoczności produktów i testowo wyłączaj wtyczki po jednej. Jeśli po powrocie do motywu domyślnego produkty wracają, problem leży w nowym motywie lub w jego konfiguracji.
Diagnoza problemu
Zanim zaczniesz cokolwiek naprawiać, ustal co dokładnie znika z widoku. To kluczowe, bo inaczej będziesz szukać błędu w złym miejscu. WooCommerce może nie pokazywać:
- całego sklepu lub strony kategorii,
- pojedynczych produktów,
- produktów tylko na urządzeniach mobilnych,
- produktów tylko po wejściu na określoną kategorię,
- produktów po filtracji lub wyszukiwaniu,
- produktów na stronie głównej lub w sekcji polecanych, ale nie w panelu administracyjnym.
Jeśli produkty są widoczne w kokpicie WordPressa, ale nie ma ich na froncie, problem zwykle dotyczy prezentacji, a nie samej zawartości bazy. Jeśli natomiast produkty zniknęły także z listy w panelu, trzeba sprawdzić uprawnienia, filtry listy produktów, import, status publikacji oraz ewentualne błędy w bazie danych.
Najważniejsza zasada diagnostyczna brzmi: nie zakładaj, że winny jest WooCommerce. Po zmianie motywu równie dobrze problem może powodować cache, skrypt motywu, nadpisany template, niekompatybilna wtyczka filtrów produktów albo błędny hook w pliku functions.php.
W pierwszej kolejności ustal:
- czy problem występuje na całym sklepie, czy tylko w wybranych miejscach,
- czy dotyczy wszystkich produktów, czy tylko części,
- czy widzisz komunikat o błędzie, czy po prostu pustą stronę,
- czy problem pojawia się po zalogowaniu i po wylogowaniu,
- czy działa motyw domyślny WordPressa, np. Storefront lub inny standardowy motyw testowy.
Te informacje pozwalają odróżnić błąd układu od błędu danych. To oszczędza czas i ogranicza ryzyko przypadkowego usunięcia czegoś ważnego.
Możliwe przyczyny
Poniżej znajdziesz najczęstsze powody, dla których po zmianie motywu WooCommerce przestaje pokazywać produkty. W praktyce często współwystępują dwie lub trzy przyczyny naraz.
1. Motyw nie jest w pełni zgodny z WooCommerce
Nie każdy motyw, który „obsługuje WooCommerce”, robi to dobrze. Część motywów ma jedynie podstawową kompatybilność i po zmianie układu sklepu produkty zaczynają znikać, bo motyw nie renderuje poprawnie archiwów, breadcrumbów, pętli produktów albo filtrów kategorii. Zdarza się też, że motyw ma własne szablony sklepu i ignoruje standardowe ustawienia WooCommerce.
2. Nadpisane pliki szablonów WooCommerce
Motyw może zawierać własne pliki w katalogu WooCommerce, które zastępują domyślne szablony wtyczki. Jeśli taki plik jest stary, niekompatybilny albo ma błędny kod, sklep może wyświetlać pustą stronę zamiast produktów. To bardzo częste po migracji ze starszego motywu na nowszy albo po aktualizacji WooCommerce przy nieaktualnym motywie.
3. Zmiana ustawień widoczności produktów
WooCommerce pozwala ukrywać produkty przed katalogiem, wyszukiwarką lub konkretnymi rolami użytkowników. Po zmianie motywu takie ustawienie może po prostu stać się bardziej widoczne, bo nowy szablon wyświetla tylko część danych. Zdarza się też, że produkty są ustawione jako „ukryte”, przypisane do prywatnych kategorii albo oznaczone niewłaściwym statusem publikacji.
4. Konflikt z wtyczkami do cache, optymalizacji lub filtrów
Jeżeli nowy motyw korzysta z bardziej agresywnego cache, lazy load, minifikacji JavaScript albo własnych filtrów Ajax, produkty mogą nie renderować się poprawnie. Wina może też leżeć po stronie wtyczek typu page builder, rozszerzeń AJAX filtrujących katalog, wtyczek do produktów polecanych czy modyfikacji układu sklepu.
5. Błędnie ustawiona strona sklepu
Po zmianie motywu czasem resetują się ustawienia przypisania strony sklepu, kategorii produktowych lub archiwum produktu. W efekcie WordPress może kierować ruch na niewłaściwy szablon albo pustą stronę. Użytkownik widzi wtedy „sklep”, ale nie widzi listy produktów, bo nie jest wyświetlana właściwa pętla WooCommerce.
6. CSS ukrywa produkty na froncie
Nowy motyw może dodawać style, które przypadkowo ustawiają produkty jako niewidoczne, np. przez display:none, złą wysokość kontenera, zły kolor tekstu, zasłonięcie przez overlay lub błędne gridy. W takiej sytuacji produkty formalnie są na stronie, ale użytkownik ich nie widzi.
7. Problem z obrazkami lub generowaniem miniaturek
Niektóre motywy wymagają konkretnych rozmiarów zdjęć produktowych. Jeżeli po zmianie motywu miniatury nie zostały przeliczone, sklep może wyglądać na pusty albo rozjechany. Czasem produkty są, ale układ jest tak uszkodzony, że wydaje się, jakby ich nie było.
8. Konflikt z motywem potomnym
Jeżeli używasz motywu potomnego, możliwe, że właśnie tam siedzi błąd: nadpisany plik archive-product.php, modyfikacje w functions.php albo własny kod ukrywający produkty w określonych warunkach. Po zmianie motywu rodzica child theme może zacząć działać nieprawidłowo.
9. Błędy w zapytaniach do bazy lub aktualizacji danych
Po większej zmianie motywu, migracji albo aktualizacji WooCommerce mogło dojść do problemów z transients, indeksami wyszukiwania lub metadanymi produktów. To rzadsze, ale realne, zwłaszcza przy większych sklepach.
Rozwiązanie krok po kroku
Poniższa procedura jest ułożona tak, by najpierw wykluczyć najprostsze i najmniej ryzykowne przyczyny. Nie pomijaj kroków, nawet jeśli wydają się oczywiste.
Krok 1. Wykonaj pełną kopię zapasową
Przed zmianami zrób backup plików i bazy danych. To absolutna podstawa, bo możesz trafić na problem z kodem motywu, cache lub bazą danych. Jeśli coś pójdzie nie tak, kopia pozwoli szybko wrócić do poprzedniego stanu.
Ostrzeżenie: nie pracuj na żywej stronie bez kopii, jeśli sklep przyjmuje zamówienia. W przeciwnym razie ryzykujesz nie tylko wygląd sklepu, ale też dane transakcyjne.
Krok 2. Sprawdź, czy motyw ma oficjalne wsparcie WooCommerce
Wejdź do dokumentacji motywu i upewnij się, że obsługuje WooCommerce w aktualnej wersji. Jeśli motyw jest stary lub porzucony, problem może nie wynikać z Twojej konfiguracji, tylko z braku kompatybilności. To ważna informacja przed dalszą diagnostyką.
Krok 3. Przełącz się testowo na motyw domyślny
Najprostszy test brzmi: aktywuj tymczasowo standardowy motyw WordPressa, najlepiej taki, który dobrze współpracuje z WooCommerce. Jeśli produkty pojawią się od razu, masz niemal pewność, że przyczyna leży w Twoim nowym motywie, jego szablonach albo dodatkach do niego.
Jeśli sklep nadal nie pokazuje produktów, problem nie jest wyłącznie po stronie motywu. Wtedy trzeba szukać dalej: wtyczki, cache, dane produktów, ustawienia sklepu.
Krok 4. Wyczyść cache na każdym poziomie
Wyczyść cache przeglądarki, cache wtyczki do cache’owania, cache serwera, a jeśli korzystasz z CDN, również jego pamięć podręczną. Po zmianie motywu stare wersje stron potrafią maskować prawdziwy stan sklepu. Czasem użytkownik widzi pustą stronę tylko dlatego, że serwer podaje starą wersję szablonu.
Po czyszczeniu cache sprawdź stronę w trybie incognito i na innym urządzeniu. Jeśli problem znika, winny był cache, nie sam WooCommerce.
Krok 5. Sprawdź ustawienia widoczności produktów
W panelu WooCommerce przejrzyj ustawienia pojedynczych produktów oraz kategorii. Sprawdź:
- status publikacji produktu,
- czy produkt nie jest prywatny,
- czy produkt jest widoczny w katalogu,
- czy nie przypisano mu ograniczeń według roli użytkownika,
- czy produkt ma przypisaną kategorię i widoczne atrybuty.
Jeżeli część produktów jest niewidoczna, ale inne działają, problem najpewniej leży właśnie tutaj lub w warunkach wyświetlania ustawionych przez wtyczkę.
Krok 6. Zweryfikuj przypisanie strony sklepu
Przejdź do ustawień WooCommerce i sprawdź, czy strona sklepu jest przypisana poprawnie. Po zmianie motywu czasem układ strony głównej zostaje przebudowany, a sklep kieruje do niewłaściwego szablonu. Upewnij się też, że archiwa produktów nie są nadpisane przez stronę statyczną albo własny szablon motywu.
Krok 7. Wyłącz po kolei wtyczki niezwiązane z WooCommerce
Jeżeli problem nie zniknął, wyłącz tymczasowo wtyczki, które mogą wpływać na sklep: cache, optymalizację JS/CSS, page builder, filtry Ajax, dodatki do produktów, wtyczki bezpieczeństwa i wtyczki zmieniające archiwa. Po każdej dezaktywacji odśwież sklep i sprawdź, czy produkty wróciły.
Ważne: wyłączaj po jednej wtyczce i zapisuj wynik. Jeśli wyłączysz wszystko naraz, nie ustalisz, co było przyczyną.
Krok 8. Sprawdź konsolę przeglądarki i logi błędów
Otwórz narzędzia deweloperskie w przeglądarce i poszukaj błędów JavaScript. Jeśli motyw lub wtyczka filtrów produktów generuje błąd, sklep może nie załadować listy produktów. W panelu WordPressa włącz też logowanie błędów i sprawdź, czy nie pojawiają się warningi lub fatal error związane z motywem.
Jeżeli widzisz błędy związane z nieistniejącymi funkcjami, to zwykle oznacza niezgodność kodu motywu z aktualną wersją WooCommerce.
Krok 9. Usuń lub popraw nadpisane szablony WooCommerce
Jeśli motyw nadpisuje pliki WooCommerce, sprawdź, które szablony są starsze od wersji wtyczki. Nieaktualne pliki często powodują błędy wyświetlania list produktów. W razie potrzeby należy je zaktualizować, usunąć nadpisanie lub zastąpić poprawną wersją z dokumentacji motywu.
Uwaga techniczna: nie edytuj plików szablonów na żywej stronie bez kontroli wersji albo kopii zapasowej. Nawet niewielka literówka może wywołać biały ekran albo całkowicie ukryć sklep.
Krok 10. Przebuduj miniatury i sprawdź rozmiary obrazów
Jeżeli produkty są, ale układ sklepu się „rozjechał”, użyj narzędzia do regeneracji miniaturek. Nowy motyw często wymaga innych wymiarów obrazów. Po przebudowie wyczyść cache i odśwież sklep. Ten krok szczególnie pomaga wtedy, gdy produkty niby istnieją, ale siatka sklepu wygląda na pustą przez błędne proporcje lub ucięte obrazy.
Krok 11. Sprawdź CSS i układ sekcji
Jeżeli produktów nadal nie widać, otwórz stronę sklepu i sprawdź, czy elementy produktu są obecne w kodzie strony. Jeśli tak, a mimo to nie są widoczne, problem jest wizualny: CSS, układ siatki lub skrypt ukrywający kontener. W takim wypadku trzeba odnaleźć regułę, która ukrywa elementy, a następnie ją wyłączyć lub poprawić.
Krok 12. Oczyść transients i przeindeksuj dane WooCommerce
W przypadku większych sklepów pomocne bywa odświeżenie transients oraz danych przeliczeniowych WooCommerce. Po zmianach w motywie i aktualizacjach wtyczki system może trzymać stare dane o produktach, kategoriach lub filtrach. Odświeżenie tych elementów może przywrócić poprawny widok katalogu.
Krok 13. Jeżeli trzeba, przywróć poprzedni motyw i porównaj
Jeśli nadal nie masz pewności, wróć na chwilę do poprzedniego motywu i porównaj zachowanie sklepu. To bardzo mocny test diagnostyczny. Jeśli wszystko wraca do normy, problem jest po stronie nowego motywu lub jego integracji. Jeśli nie, źródło problemu jest głębiej.
Najczęstsze błędy
Podczas naprawy tego problemu użytkownicy najczęściej popełniają kilka powtarzalnych błędów. Niektóre wydają się drobiazgami, ale potrafią skutecznie utrudnić diagnozę.
- Brak kopii zapasowej przed zmianami. To najgorszy możliwy start.
- Wyłączanie wszystkich wtyczek naraz. Potem nie wiadomo, co pomogło, a co zaszkodziło.
- Edytowanie plików motywu bez środowiska testowego. Jedna linia kodu może wyłączyć sklep.
- Zakładanie, że to „tylko problem wizualny”. Czasem problem siedzi w danych lub zapytaniach.
- Ignorowanie cache. Po zmianie motywu stara wersja strony potrafi długo maskować efekt naprawy.
- Brak sprawdzenia widoczności produktów. Wiele sklepów ma produkty ukryte przez ustawienia katalogu.
- Używanie nieaktualnego motywu lub wtyczek. Stare szablony są częstą przyczyną konfliktów.
- Mieszanie problemu motywu z problemem SEO lub UX. To, że sklep wygląda źle, nie zawsze znaczy, że dane są uszkodzone.
Kiedy nie robić tego samodzielnie
Są sytuacje, w których samodzielna naprawa ma większe ryzyko niż potencjalna oszczędność czasu. Zrezygnuj z samodzielnych działań, jeśli:
- sklep obsługuje duży ruch i generuje zamówienia w czasie rzeczywistym,
- problem dotyczy nie tylko wyglądu, ale też działania koszyka, zamówień lub płatności,
- widzisz fatal error, biały ekran lub poważne błędy PHP,
- motyw był mocno modyfikowany w kodzie,
- sklep ma wiele wtyczek integracyjnych, filtrów, builderów i modyfikacji katalogu,
- nie masz kopii zapasowej albo nie wiesz, jak ją przywrócić,
- pracujesz na środowisku produkcyjnym bez testów.
W takich przypadkach jeden błąd może spowodować utratę dostępności sklepu, a to oznacza realne straty finansowe. Jeśli nie masz pewności, lepiej zatrzymać się na etapie diagnozy i przekazać sprawę komuś, kto potrafi bezpiecznie przeanalizować warstwę motywu, wtyczek i serwera.
Kiedy zgłosić się do specjalisty
Skontaktuj się ze specjalistą, gdy problem:
- pojawia się po każdej zmianie motywu mimo prób naprawy,
- wraca po kilku godzinach lub po wyczyszczeniu cache,
- dotyczy tylko wybranych urządzeń, języków lub ról użytkowników,
- wiąże się z błędami JavaScript, PHP lub konfliktem z builderem,
- wymaga ingerencji w szablony WooCommerce,
- dotyczy sklepu z dużą bazą produktów i niestandardowymi filtrami,
- masz wrażenie, że problem leży w kodzie, a nie w ustawieniach.
Specjalista powinien sprawdzić nie tylko motyw, ale też kompatybilność z WooCommerce, transients, logi błędów, nadpisane szablony, ustawienia katalogu, wtyczki optymalizacyjne i wpływ CSS/JS na widok sklepu. To daje znacznie większą szansę na trwałe rozwiązanie zamiast doraźnej poprawki.
Podsumowanie i CTA do kontaktu
Jeżeli WooCommerce nie pokazuje produktów po zmianie motywu, nie panikuj i nie zaczynaj od losowych poprawek. W większości przypadków problem wynika z niezgodności motywu, błędnych szablonów, cache, ukrytych ustawień widoczności lub konfliktu z wtyczką. Najskuteczniejsza metoda to spokojna, uporządkowana diagnostyka: backup, test motywu domyślnego, czyszczenie cache, sprawdzenie ustawień produktu, wyłączenie podejrzanych wtyczek i analiza logów.
Jeśli jednak sklep jest krytyczny dla sprzedaży, pojawiają się błędy techniczne albo problem wraca mimo prób naprawy, nie ryzykuj dalszych zmian na produkcji. W takim przypadku warto przekazać diagnostykę i naprawę specjaliście, który szybko wskaże przyczynę i przywróci prawidłowe działanie sklepu bez zbędnych eksperymentów.
Masz ten problem w swoim sklepie? Jeśli WooCommerce po zmianie motywu przestał pokazywać produkty, najlepiej zająć się tym od razu, zanim problem zacznie wpływać na sprzedaż, SEO i konwersję.
