Nic tak nie psuje dnia jak nagła awaria po niewinnej aktualizacji. Sklep przestaje przyjmować zamówienia, edytor się nie ładuje albo strona pokazuje błąd krytyczny. Zwykle winny jest konflikt wtyczek, czyli sytuacja, w której dwa rozszerzenia próbują robić coś na raz i wchodzą sobie w drogę.
Da się to ogarnąć spokojnie i bez chaosu. Klucz to działanie w kontrolowanych warunkach, robienie jednego kroku naraz i zbieranie dowodów zamiast strzelania na oślep. Dzięki temu nie tylko przywrócisz stronę do życia, ale też wyciągniesz wnioski na przyszłość.
Po czym poznać że to konflikt wtyczek
Najczęstsze objawy to błąd krytyczny, biały ekran, brak możliwości zapisu wpisu, znikające pola w edytorze, rozsypany wygląd po aktualizacji lub komunikaty o błędach JavaScript w konsoli przeglądarki. Czasem problem widać tylko po zalogowaniu do kokpitu, a strona publiczna wygląda normalnie.
Warto zwrócić uwagę na moment wystąpienia problemu. Jeśli coś przestało działać zaraz po aktualizacji konkretnej wtyczki albo po instalacji nowej, to trop jest dość jasny. Konflikty lubią też wychodzić przy zmianie wersji PHP lub po włączeniu optymalizacji typu łączenie i minimalizacja skryptów.
Zabezpiecz dostęp i złap oddech
Jeśli awaria jest widoczna publicznie, ustaw prosty tryb konserwacji i poinformuj użytkowników, że trwają prace. Daje to czas na spokojne działania i ogranicza straty. Gdy problem dotyczy tylko kokpitu, nie rób gwałtownych ruchów na produkcji. Zanim cokolwiek zmienisz, przygotuj miejsce do testów.
Przygotuj bezpieczne środowisko do testów
Najwygodniej pracować na kopii testowej zwanej staging. To wierna kopia strony na osobnym adresie lub w subdomenie, gdzie można bez ryzyka wyłączać i włączać wtyczki oraz motywy. Dobra praktyka to utrzymywać stały staging, który da się szybko odświeżyć przed każdą większą zmianą.
Jeśli stagingu nie masz, sprawdź czy hosting udostępnia jego szybkie tworzenie. Alternatywą jest włączenie trybu rozwiązywania problemów dostępnego we wtyczce Health Check. Pozwala on wyłączać rozszerzenia tylko dla zalogowanego administratora, dzięki czemu odwiedzający widzą stronę normalnie. To bezpieczny sposób na testy bez dotykania wersji produkcyjnej.
Niezależnie od metody zrób świeżą kopię zapasową plików i bazy. Kopia to punkt powrotu na wypadek nieudanych testów lub przypadkowej zmiany. W kryzysie oszczędza godziny pracy.
Test przez wyłączanie wtyczek
Najprostszy i najskuteczniejszy test to tymczasowe wyłączenie wszystkich wtyczek i sprawdzenie czy problem znika. Jeśli znika, konflikt jest niemal pewny. Następnie włączaj rozszerzenia pojedynczo i po każdym włączeniu sprawdzaj działanie newralgicznych miejsc formularzy, edytora, koszyka, panelu zamówień.
Gdy liczba wtyczek jest duża, przyspieszysz test metodą pół na pół. Włącz najpierw połowę rozszerzeń i sprawdź czy błąd wrócił. Jeśli tak, wiesz że winny jest w tym pakiecie. Jeśli nie, winny jest wśród pozostałych. Zawężaj obszar do momentu znalezienia konkretnego duetu lub tria, które się gryzie.
Notuj co włączasz i jaki był rezultat. Po znalezieniu pary konfliktowej sprawdź czy błąd pojawia się tylko wtedy, gdy obie wtyczki są aktywne. To cenna informacja dla wsparcia technicznego i skraca drogę do poprawki.
Logi błędów i tryb debugowania
Logi to dzienniki, w których serwer zapisuje informacje o błędach. W WordPressie możesz włączyć tryb debugowania przez ustawienie stałych WP_DEBUG i WP_DEBUG_LOG w pliku konfiguracyjnym. Dzięki temu komunikaty trafią do pliku z logiem, który można otworzyć i przeczytać.
Szukaj w nich konkretnych wskazówek nazwy plików, nazwy wtyczek, treści błędów typu brak funkcji lub konflikt nazw. Często już pierwszy wpis mówi, który moduł wywołał problem. Jeśli nie masz dostępu do plików, sprawdź panel hostingu. Wielu dostawców udostępnia podgląd logów w przeglądarce.
Warto odtworzyć błąd tuż po włączeniu logowania. Wejdź w miejsce, gdzie problem się pojawia i wykonaj akcję która go wywołuje. Świeży wpis w logu to najpewniejszy trop. Po zakończeniu testów wyłącz debugowanie, aby nie zostawiać dodatkowych informacji na serwerze.
Zobacz więcej darmowej wiedzy na ProjektWordPress.pl
Konflikt z motywem czy z wtyczką
Nie wszystko co wygląda na błąd wtyczki faktycznie nią jest. Czasem problem wynika z motywu, który nadpisuje szablony lub ładuje własne skrypty. Szybki test to przełączenie na domyślny motyw WordPressa i sprawdzenie czy błąd znika. Jeśli tak, masz konflikt między motywem a wtyczką.
Pamiętaj że motyw potomny dziedziczy po motywie głównym, więc jeśli w dziecku są własne funkcje lub style, to one też mogą być źródłem problemu. W razie wątpliwości przełącz oba na wariant domyślny i porównaj zachowanie strony.
Cache i inne warstwy które mylą obraz
Pamięć podręczna zwana cache potrafi utrudnić diagnozę. Nawet jeśli naprawisz błąd, użytkownicy mogą jeszcze chwilę widzieć starą wersję. Czyść cache wtyczki, cache serwera oraz ewentualnej usługi CDN. Dobrze też odświeżyć przeglądarkę z pominięciem cache lub użyć trybu prywatnego.
Jeśli korzystasz z optymalizacji skryptów takich jak łączenie i minimalizacja, wyłącz je na czas testów. Te mechanizmy potrafią połączyć skrypty z dwóch wtyczek w jeden plik i wtedy błąd wygląda jakby pochodził z zupełnie innego miejsca. Czyste środowisko testowe daje jaśniejszy obraz.
Pamiętaj też o cache obiektów i zapytań bazodanowych. Przy dużych stronach to częsta warstwa pośrednia. Tu również warto na chwilę wyłączyć mechanizm i sprawdzić czy objawy się zmieniają.
Kiedy i jak pisać do wsparcia
Gdy znajdziesz kombinację rozszerzeń która wywołuje błąd, a problem nie znika po najnowszych aktualizacjach, napisz do wsparcia wtyczki. Załącz wersje WordPressa, PHP, nazwę motywu, listę aktywnych wtyczek oraz kroki które prowadzą do błędu. Dołącz fragment logu jeśli wskazuje konkretny plik lub funkcję.
Im precyzyjniejszy opis tym szybciej ktoś po drugiej stronie odtworzy problem i zaproponuje poprawkę lub obejście. W wielu przypadkach dostaniesz też informację czy to znany błąd i kiedy można spodziewać się aktualizacji.
Jak ograniczać ryzyko konfliktów w przyszłości
Aktualizuj rozszerzenia etapami i testuj na staging przed produkcją, unikaj dublowania funkcji kilkoma wtyczkami, regularnie porządkuj listę rozszerzeń i usuwaj te nieużywane, utrzymuj aktualną wersję PHP zgodną z wymaganiami, a większe zmiany planuj jak małe wdrożenia z kopią zapasową i krótkim oknem serwisowym. To prosty zestaw na spokojniejszą pracę i mniej nerwów przy kolejnych aktualizacjach.
