Motyw nie ładuje się poprawnie najczęściej z powodu konfliktu wtyczki, błędu PHP, uszkodzonych plików motywu albo problemu z cache. Zacznij od kopii zapasowej, a następnie sprawdzaj przyczyny metodą eliminacji: najpierw wtyczki, potem motyw i konfigurację serwera.
Co może powodować niepoprawne ładowanie motywu?
„Motyw nie ładuje się poprawnie” może oznaczać różne problemy. Strona może wyglądać jak zwykły tekst, ponieważ nie wczytał się arkusz CSS, albo wyświetlać biały ekran po wystąpieniu błędu PHP. Czasem działa strona główna, ale podstrony zwracają błąd 404.
Najczęściej źródłem awarii jest konflikt wtyczki z motywem lub aktualizacją WordPressa. Możliwe są też przekroczone limity serwera, brak zapisu w katalogu wp-content/uploads, błędne linki bezpośrednie albo uszkodzenie pliku functions.php.
Objaw i prawdopodobna przyczyna
Poniższa tabela pozwala szybko zawęzić obszar poszukiwań:
| Objaw | Prawdopodobna przyczyna | Sugerowane działanie |
|---|---|---|
| Strona wygląda jak tekst bez układu | Brak pliku CSS, błędna ścieżka, cache lub CDN | Wyczyść cache i sprawdź wczytywanie plików CSS w narzędziach przeglądarki |
| Biały ekran | Błąd PHP w motywie albo wtyczce | Wyłącz wtyczki i przełącz motyw na domyślny |
| Błąd 500 | Przekroczony limit pamięci PHP lub błąd serwera | Sprawdź logi PHP i parametr memory_limit |
| Błąd 404 na podstronach | Nieprawidłowe reguły bezpośrednich odnośników | Zapisz ponownie ustawienia bezpośrednich odnośników |
Jak naprawić motyw krok po kroku?
Przed zmianą plików wykonaj kopię bazy danych i plików strony. Backup pozwoli wrócić do poprzedniego stanu, jeśli zmiana nazwy katalogu, edycja konfiguracji lub przywracanie motywu pogorszy sytuację.
Wstępna checklista bezpieczeństwa obejmuje:
- Utworzenie kopii plików WordPressa.
- Utworzenie kopii bazy danych.
- Sprawdzenie, czy hosting ma wolne miejsce.
- Zanotowanie ostatniej aktualizacji lub zmiany wykonanej przed awarią.
- Wyczyść cache. Usuń pamięć podręczną przeglądarki, wtyczki cache oraz ewentualnego CDN. Sprawdź stronę w trybie prywatnym. Jeśli problem dotyczy tylko wyglądu, a pliki motywu są poprawne, stara wersja CSS mogła zostać zapisana w pamięci podręcznej.
- Wyłącz wszystkie wtyczki. Gdy działa kokpit, zrób to w sekcji „Wtyczki”. Jeśli panel jest niedostępny, połącz się przez FTP lub Menedżer plików i zmień nazwę katalogu
wp-content/plugins, na przykład naplugins_old. Odśwież stronę. Jeżeli zacznie działać, przywróć pierwotną nazwę katalogu i włączaj wtyczki pojedynczo. Wtyczka, po której awaria powróci, jest prawdopodobnym źródłem konfliktu. - Przełącz motyw na domyślny. W kokpicie wybierz motyw zainstalowany bezpośrednio z oficjalnej serii WordPress. Bez dostępu do panelu można wykonać zmianę przez bazę danych lub FTP, ale ingerencja w bazę wymaga większej ostrożności. Jeśli strona działa na motywie domyślnym, problem dotyczy poprzedniego motywu, jego aktualizacji albo kodu w
functions.php. - Sprawdź pliki przez FTP. Upewnij się, że katalog motywu zawiera podstawowe pliki, między innymi arkusz stylów i pliki szablonów. Nie usuwaj ich bez kopii zapasowej. Sprawdź także, czy WordPress może zapisywać pliki w katalogach strony.
- Zweryfikuj uprawnienia. Brak praw zapisu może uniemożliwić odczyt lub utworzenie plików CSS, JavaScript i obrazów. Szczególną uwagę zwróć na
wp-content/uploads. Nie ustawiaj szerokich uprawnień bez konsultacji z hostingiem, ponieważ może to obniżyć bezpieczeństwo.
Jeśli nie masz dostępu do kokpitu, zacznij od tych działań poza WordPressem:
- Sprawdź status hostingu i dostęp do Menedżera plików.
- Zmień nazwę katalogu
plugins, aby wyłączyć wtyczki. - Przełącz motyw przez bazę danych lub przywróć motyw domyślny z poziomu serwera.
- Odczytaj najnowsze logi PHP i serwera.
Co sprawdzić, gdy podstawowe kroki nie pomogły?
Włącz tymczasowo logowanie błędów WordPressa za pomocą WP_DEBUG w pliku wp-config.php. Na stronie produkcyjnej nie wyświetlaj błędów odwiedzającym. Bezpieczniej zapisywać je do logu i wyłączyć debugowanie po zakończeniu diagnozy.
Sprawdź też następujące obszary:
- Logi PHP i serwera – szukaj nazw plików motywu, wtyczek oraz komunikatów o błędzie pamięci lub niezgodnej funkcji.
- Limity PHP – zbyt niski
memory_limitmoże przerwać wykonywanie skryptu, zwłaszcza przy rozbudowanym motywie lub kreatorze stron. - Biblioteki graficzne – GD Library lub Imagick są potrzebne do przetwarzania obrazów. Ich brak może powodować błędy miniaturek, choć nie zawsze wyjaśnia awarię całego motywu.
- Bezpośrednie odnośniki – w kokpicie otwórz ustawienia bezpośrednich odnośników i zapisz je ponownie bez zmiany opcji. To odświeża reguły adresów URL.
Jeśli problem dotyczy tylko obrazów, sprawdź, czy motyw korzysta z obsługi miniaturek, czyli funkcji add_theme_support('post-thumbnails'). Po naprawie przyczyny stare pliki mogą nadal nie mieć brakujących rozmiarów. Wtedy potrzebna będzie regeneracja miniaturek, na przykład przez Regenerate Thumbnails albo WP-CLI.
Kiedy potrzebna jest pomoc specjalisty?
Przerwij samodzielne zmiany, jeśli logi wskazują na uszkodzoną bazę danych, nieznany kod PHP lub problem z konfiguracją serwera. Szczególnej ostrożności wymaga sklep WooCommerce, ponieważ przywrócenie starego backupu może nadpisać zamówienia, dane klientów i stany magazynowe.
Pomoc techniczna będzie rozsądnym rozwiązaniem także wtedy, gdy nie masz aktualnej kopii zapasowej, nie masz dostępu do serwera albo strona regularnie wraca do stanu awarii. Najpierw zabezpiecz dane, a dopiero potem zlecaj dalszą diagnostykę.