Gdy motyw WordPress powoduje biały ekran, błąd krytyczny albo błąd 500, najbezpieczniej tymczasowo przełączyć witrynę na motyw domyślny. Jeśli nie działa kokpit, zmień nazwę folderu aktywnego motywu w katalogu /wp-content/themes/ przez FTP lub menedżer plików hostingu. Przed każdą zmianą wykonaj kopię zapasową plików i bazy danych.
Co zrobić przed rozpoczęciem naprawy?
Awaria motywu często pojawia się po aktualizacji, edycji pliku functions.php albo instalacji wtyczki. W wielu przypadkach można ją cofnąć bez utraty treści, ale nie należy od razu usuwać plików ani nadpisywać całej instalacji WordPressa.
Przygotuj:
- kopię zapasową plików WordPress i bazy danych
- dostęp do kokpitu WordPress, jeśli nadal działa
- dane do FTP albo dostęp do menedżera plików w panelu hostingu
- nazwę aktywnego motywu i dostęp do logów błędów serwera
Jeżeli strona jest sklepem lub witryną firmową, a nie masz aktualnego backupu, rozważ kontakt z administratorem hostingu przed edycją plików na serwerze.
Jak rozpoznać, że problem powoduje motyw?
Sam objaw nie zawsze wskazuje jednoznacznie na motyw. Podobne błędy wywołują wtyczki, limit pamięci PHP, konfiguracja serwera albo uszkodzone pliki. Poniższa tabela pomaga wybrać pierwszy krok diagnostyczny.
| Objaw | Prawdopodobna przyczyna | Sugerowany krok |
|---|---|---|
| Biały ekran śmierci | Błąd PHP w motywie lub konflikt z wtyczką | Przełącz motyw na domyślny, zmieniając nazwę jego folderu |
Błąd krytyczny po edycji functions.php |
Niepoprawny kod PHP albo błąd składni | Cofnij zmianę lub tymczasowo wyłącz motyw przez FTP |
| Błąd 500 | Konflikt kodu, motywu, wtyczki albo limitów serwera | Sprawdź logi i przełącz motyw |
| Brak stylów lub niepełny wygląd strony | Uszkodzone pliki CSS, problem z cache albo niepełna aktualizacja | Wyczyść cache i sprawdź pliki motywu |
Jak naprawić motyw przez kokpit WordPress?
Ta metoda działa tylko wtedy, gdy możesz zalogować się do panelu administracyjnego.
- Zaloguj się do kokpitu WordPress.
- Przejdź do sekcji Wygląd → Motywy.
- Wybierz zainstalowany motyw domyślny, na przykład jeden z serii Twenty.
- Aktywuj go i sprawdź stronę w nowej karcie przeglądarki.
Jeśli witryna zacznie działać, problem jest związany z poprzednim motywem, jego aktualizacją albo kodem dodanym do plików motywu. Nie usuwaj go od razu. Najpierw zachowaj kopię i ustal, która zmiana wywołała awarię.
Jak naprawić stronę przez FTP, gdy kokpit nie działa?
Gdy nie działa ani strona, ani panel administracyjny, potrzebujesz dostępu do plików. Możesz użyć klienta FTP albo menedżera plików dostępnego w panelu hostingu. Niektóre firmy hostingowe udostępniają tę funkcję pod nazwą File Manager.
Nie edytuj ani nie usuwaj plików na serwerze bez kopii zapasowej. Pomyłka w nazwie katalogu lub zawartości pliku może pogłębić awarię. Zmiana nazwy folderu jest bezpieczniejsza niż jego kasowanie, ponieważ pozwala później przywrócić pierwotny stan.
- Połącz się z serwerem przez FTP lub otwórz menedżer plików hostingu.
- Przejdź do katalogu instalacji WordPress, a następnie otwórz
/wp-content/themes/. - Znajdź folder aktywnego motywu, na przykład
moj-motyw. - Zmień jego nazwę na
moj-motyw-oldalbomoj-motyw-backup. - Odśwież stronę oraz spróbuj otworzyć adres panelu administracyjnego.
WordPress nie znajdzie poprzedniego motywu pod przypisaną nazwą. Jeżeli na serwerze jest zainstalowany motyw domyślny, system zwykle automatycznie przełączy witrynę na jeden z dostępnych motywów. Jeśli takiego motywu nie ma, trzeba wgrać go do katalogu /wp-content/themes/ przez kokpit, FTP albo menedżer plików.
Po odzyskaniu dostępu nie przywracaj od razu uszkodzonego motywu na stronie produkcyjnej. Sprawdź jego pliki na kopii testowej, cofnij ostatnie zmiany lub zainstaluj świeżą wersję motywu od autora.
Co sprawdzić po przywróceniu strony?
Najpierw otwórz stronę główną, kilka podstron, formularz kontaktowy i panel administracyjny. Jeżeli problem wraca, sprawdź logi hostingu oraz log WordPressa. Do diagnozy możesz tymczasowo włączyć tryb debugowania w pliku wp-config.php:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
Błędy powinny trafiać do pliku /wp-content/debug.log. Po zakończeniu diagnostyki wyłącz debugowanie na stronie publicznej, zmieniając wartości na false lub usuwając dodane linie. Log może zawierać ścieżki plików i informacje techniczne, których nie powinno się wyświetlać odwiedzającym.
Po ustaleniu przyczyny wykonaj następujące działania:
- zaktualizuj motyw i WordPress dopiero po wykonaniu kolejnej kopii zapasowej
- cofnij własne zmiany w plikach motywu albo przenieś je do motywu potomnego
- sprawdź zgodność motywu z używaną wersją PHP i aktywnymi wtyczkami
- skontaktuj się z autorem motywu lub hostingiem, jeśli log wskazuje błąd serwera
- testuj większe aktualizacje na kopii witryny przed wdrożeniem ich na stronie produkcyjnej
Jeżeli po zmianie nazwy folderu motywu strona nadal nie działa, przyczyna może leżeć w wtyczce, pliku .htaccess, limitach serwera albo samej instalacji WordPress. Przy sklepie internetowym, braku backupu lub niejasnych logach lepiej przerwać kolejne zmiany i zlecić diagnostykę specjaliście.
