Konflikt wtyczek w WordPressie najczęściej naprawisz przez tymczasową dezaktywację wszystkich rozszerzeń i stopniowe włączanie ich pojedynczo. Jeśli nie możesz wejść do panelu, zmień nazwę folderu wp-content/plugins przez FTP lub menedżer plików hostingu. Zanim zaczniesz, wykonaj kopię zapasową.
Co może wskazywać na konflikt wtyczek?
Problem często pojawia się po aktualizacji WordPressa, instalacji nowej wtyczki albo zmianie motywu. Objawy mogą dotyczyć całej strony lub tylko jednej funkcji, na przykład formularza, koszyka albo panelu administracyjnego.
Najczęstsze symptomy to:
- Biały ekran strony lub komunikat o błędzie krytycznym.
- Błąd serwera, na przykład 500.
- Brak dostępu do panelu WordPress.
- Niedziałający formularz, koszyk, płatność albo inna funkcja.
- Nieprawidłowe wyświetlanie strony po aktualizacji.
Szybka diagnostyka może wyglądać tak:
| Objaw | Możliwa przyczyna | Pierwsze działanie |
|---|---|---|
| Biały ekran | Konflikt wtyczki, motywu lub błąd PHP | Dezaktywuj wtyczki przez FTP |
| Błąd 500 | Błąd w kodzie lub konfiguracji serwera | Sprawdź logi i ostatnio zmieniane elementy |
| Błąd w panelu | Konflikt funkcji administracyjnej | Wyłącz wtyczki i sprawdź panel ponownie |
| Brak części funkcji | Konflikt wtyczki, motywu albo pamięci cache | Przetestuj wtyczki pojedynczo i wyczyść cache |
Co sprawdzić przed rozpoczęciem naprawy?
Nie modyfikuj plików ani ustawień strony bez aktualnej kopii zapasowej. Backup powinien obejmować bazę danych oraz pliki WordPressa. Przydatny będzie także dostęp do panelu hostingu, FTP lub menedżera plików, ponieważ może być potrzebny wtedy, gdy panel WordPress przestanie działać.
Przed rozpoczęciem przygotuj:
- Aktualną kopię zapasową strony i bazy danych.
- Dane dostępu do panelu WordPress, FTP lub hostingu.
- Informację o ostatniej aktualizacji, instalacji lub zmianie konfiguracji.
- Opis funkcji, która przestała działać.
Dezaktywacja wtyczek może tymczasowo zmienić wygląd strony albo wyłączyć formularze, płatności i inne funkcje. Na stronie produkcyjnej wykonuj testy ostrożnie, a jeśli hosting udostępnia środowisko staging, użyj go w pierwszej kolejności.
Mam dostęp do panelu WordPress
W tej sytuacji najłatwiej zastosować metodę eliminacji. Polega ona na wyłączeniu wszystkich wtyczek, a następnie aktywowaniu ich pojedynczo. Dzięki temu można ustalić, po której aktywacji problem pojawia się ponownie.
- Przejdź do sekcji Wtyczki → Zainstalowane wtyczki.
- Zaznacz aktywne wtyczki i wybierz opcję ich dezaktywacji. Nie usuwaj ich.
- Otwórz stronę główną, panel administracyjny i funkcję, która wcześniej nie działała.
- Jeśli problem zniknął, włączaj wtyczki pojedynczo i po każdej aktywacji wykonaj test.
- Gdy błąd wróci, sprawdź ostatnio aktywowaną wtyczkę oraz jej zgodność z WordPressem, motywem i wersją PHP.
Dezaktywacja nie oznacza usunięcia danych wtyczki. Jej ustawienia zwykle pozostają w bazie danych, dlatego możesz później ponownie ją aktywować. Po znalezieniu przyczyny sprawdź dostępność aktualizacji i ustawienia rozszerzenia. Jeśli problem powtarza się po każdej aktualizacji, rozważ zastąpienie wtyczki innym rozwiązaniem.
Nie zawsze winna jest jedna wtyczka. Konflikt może pojawić się dopiero przy określonej kombinacji rozszerzeń, na przykład narzędzia cache z wtyczką optymalizującą pliki JavaScript. Po zmianach wyczyść pamięć podręczną wtyczki, serwera i przeglądarki.
Nie mam dostępu do panelu – użyj FTP
Przy białym ekranie, błędzie krytycznym lub zablokowanym logowaniu najszybszą metodą jest dezaktywacja wszystkich wtyczek przez FTP albo menedżer plików w panelu hostingu. Zmiana nazwy folderu nie kasuje rozszerzeń ani ich ustawień.
- Połącz się z serwerem przez FTP lub otwórz menedżer plików hostingu.
- Przejdź do katalogu
wp-content. - Znajdź folder
pluginsi zmień jego nazwę, na przykład naplugins_old. - Odśwież stronę oraz spróbuj otworzyć panel WordPress.
- Jeśli strona działa, przywróć nazwę folderu
pluginsi aktywuj rozszerzenia pojedynczo w panelu.
Jeżeli po zmianie nazwy folderu strona nadal nie działa, przyczyna może znajdować się w motywie, plikach WordPressa, konfiguracji PHP lub na serwerze. Warto wtedy sprawdzić logi hostingu i tymczasowo przetestować domyślny motyw WordPressa. Gdy błąd dotyczy sklepu WooCommerce, płatności lub zamówień, lepiej ograniczyć samodzielne zmiany i skontaktować się z administratorem.
Jak sprawdzić szczegóły błędu?
W trudniejszych przypadkach pomocny jest tryb debugowania WordPressa. W pliku wp-config.php możesz włączyć WP_DEBUG oraz zapisywanie błędów do logu. Wpisy dodaje się przed komentarzem kończącym konfigurację pliku:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
Po odtworzeniu problemu sprawdź plik wp-content/debug.log oraz logi błędów w panelu hostingu. Nazwa wtyczki, motywu lub pliku w komunikacie może wskazać kierunek dalszej diagnozy. Po zakończeniu testów wyłącz debugowanie, zmieniając wartości na false. Nie wyświetlaj szczegółowych błędów na stronie publicznej, ponieważ mogą ujawniać informacje o instalacji.
Jeśli dezaktywacja wtyczek, zmiana motywu i analiza logów nie przynoszą rezultatu, problem może dotyczyć serwera lub kodu niestandardowego. W przypadku sklepu internetowego, aktywnych płatności albo powtarzających się awarii po aktualizacjach bezpieczniej przekazać diagnostykę specjaliście lub hostingowi.
Najbezpieczniejsza kolejność działań to backup, dezaktywacja, test, pojedyncze aktywowanie rozszerzeń i sprawdzenie logów. Nie usuwaj wtyczki na etapie diagnozy – najpierw ustal, czy rzeczywiście powoduje konflikt.
