Gdy Customizer, czyli Personalizator WordPressa, nie działa, najczęściej odpowiada za to konflikt wtyczki, błąd motywu albo zbyt niski limit pamięci PHP. Zacznij od kopii zapasowej, następnie wyłącz wtyczki i sprawdź motyw. Jeśli to nie pomoże, przeanalizuj logi błędów serwera.
Jak szybko rozpoznać przyczynę?
Objaw często wskazuje kierunek diagnostyki. Tabela poniżej pomoże zawęzić źródło problemu przed wprowadzaniem zmian w plikach.
| Objaw błędu | Potencjalna przyczyna |
|---|---|
| Biała lub pusta strona w Customizerze | Błąd PHP, konflikt wtyczki albo niekompatybilny motyw |
| Brak zapisu zmian | Konflikt wtyczki, brak uprawnień zapisu lub problem z żądaniem AJAX |
| Ładowanie w nieskończoność | Błąd skryptu JavaScript, konflikt wtyczki albo problem z połączeniem serwera |
| Customizer otwiera się, ale nie pokazuje podglądu | Błąd motywu, blokada iframe lub nieprawidłowa konfiguracja adresu strony |
Co zrobić najpierw?
Zanim wyłączysz dodatki lub zmienisz pliki, wykonaj kopię zapasową. Zapisz bazę danych oraz pliki strony, najlepiej korzystając z panelu hostingu. Dzięki temu możesz cofnąć zmianę, jeśli diagnostyka spowoduje dodatkowy problem.
Jeśli strona działa, ale nie działa wyłącznie Personalizator, zacznij od prostych czynności. Szybkie testy obejmują:
- Odświeżenie strony w trybie incognito i wyczyszczenie pamięci podręcznej przeglądarki.
- Sprawdzenie, czy problem występuje także po wyłączeniu wtyczki cache lub optymalizującej skrypty.
- Sprawdzenie, czy problem pojawił się po aktualizacji wtyczki, motywu, WordPressa albo wersji PHP.
- Otwarcie Customizera w innej przeglądarce, aby wykluczyć lokalny błąd JavaScript.
Jak sprawdzić, czy winna jest wtyczka?
Najskuteczniejsza metoda polega na czasowym wyłączeniu wszystkich wtyczek, a następnie włączaniu ich pojedynczo. Nie usuwasz w ten sposób konfiguracji dodatków, więc możesz bezpiecznie przeprowadzić test.
- W kokpicie WordPressa otwórz sekcję Wtyczki i wyłącz wszystkie aktywne dodatki.
- Otwórz Personalizator i sprawdź, czy podgląd oraz zapis zmian działają poprawnie.
- Jeśli problem zniknął, włączaj wtyczki pojedynczo, za każdym razem testując Customizer.
- Po znalezieniu konfliktu zaktualizuj problematyczną wtyczkę lub skontaktuj się z jej autorem.
Jeśli panel administracyjny nie działa albo nie pozwala wyłączyć dodatków, użyj FTP lub Menedżera plików w panelu hostingu. Przejdź do katalogu /wp-content/ i zmień nazwę folderu plugins, na przykład na plugins_old. WordPress potraktuje wtedy wszystkie wtyczki jako nieaktywne. Jeśli Customizer zacznie działać, przywróć nazwę folderu i aktywuj dodatki pojedynczo.
Nie edytuj plików strony bez aktualnej kopii zapasowej. Błędna zmiana w pliku PHP może wywołać błąd całej witryny, a nie tylko Personalizatora.
Czy problem powoduje motyw?
Wtyczki nie są jedynym możliwym źródłem awarii. Motyw może zawierać własne funkcje Customizera, nieaktualny kod albo integracje powodujące błąd w podglądzie.
W kokpicie przejdź do Wygląd → Motywy i tymczasowo aktywuj domyślny motyw WordPressa, na przykład jeden z motywów serii Twenty. Przed zmianą upewnij się, że masz backup, ponieważ aktywny motyw może kontrolować wygląd i część funkcji strony.
Jeśli po zmianie Personalizator działa, przyczyna leży najpewniej w poprzednim motywie, jego aktualizacji albo konflikcie motywu z wtyczką. Gdy nie masz dostępu do kokpitu, zmianę można wykonać przez FTP, ale wymaga to ostrożności i znajomości struktury plików.
Co sprawdzić, gdy podstawowe kroki nie pomogły?
Limit pamięci PHP
Customizer ładuje podgląd, ustawienia motywu i skrypty w jednym procesie. Przy rozbudowanym motywie lub wielu dodatkach niski limit pamięci PHP może powodować przerwanie działania.
Po wykonaniu kopii zapasowej otwórz plik wp-config.php w katalogu głównym WordPressa i przed linią kończącą edycję pliku dodaj:
define( 'WP_MEMORY_LIMIT', '256M' );Wartość może być ograniczona przez hosting, dlatego sama zmiana w wp-config.php nie zawsze wystarczy. Jeśli problem pozostanie, sprawdź w panelu hostingu limit pamięci PHP albo poproś support o jego weryfikację.
Tryb debugowania i logi
Log błędów pokaże, czy awarię wywołuje konkretny plik, wtyczka, motyw lub brak pamięci. W pliku wp-config.php możesz tymczasowo włączyć debugowanie:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );Po zapisaniu zmian odtwórz błąd w Customizerze. WordPress zapisze informacje w pliku wp-content/debug.log. Sprawdź nazwę pliku i ścieżkę wskazaną w komunikacie, ale nie publikuj logu na stronie, ponieważ może zawierać informacje techniczne o instalacji.
Przejrzyj też panel hostingu. Sekcje nazwane „Logi błędów”, „Error logs”, „Logi PHP” lub „Dzienniki serwera” mogą pokazać błędy, których WordPress nie zapisuje we własnym logu.
Kiedy potrzebna jest pomoc specjalisty?
Warto przekazać sprawę administratorowi WordPressa lub supportowi hostingu, gdy problem wykracza poza konflikt wtyczki albo motywu. Dotyczy to szczególnie sytuacji, w których:
- Nie masz dostępu do kopii zapasowej, FTP ani panelu hostingu.
- Logi wskazują na błędy bazy danych, konfiguracji serwera lub plików PHP.
- Nie działa nie tylko Customizer, lecz także publiczna strona albo kokpit.
- Awaria wraca po każdej aktualizacji lub występuje na stronie sklepu.
- Zmiany w plikach mogą zagrozić działaniu ważnych funkcji strony.
Najważniejszy jest ostatni komunikat z logu błędów z momentu awarii. Zamiast zgłaszać problem jako ogólne „Customizer nie działa”, przekaż specjaliście nazwę pliku, wtyczki lub motywu wskazaną w logu. To zwykle skraca diagnostykę i pozwala odróżnić konflikt kodu od problemu z uprawnieniami lub konfiguracją serwera.
