Konflikt modułów PrestaShop może powodować biały ekran, brak części funkcji, problemy z realizacją zamówienia, błędy w panelu administracyjnym lub nieoczekiwane zmiany wyglądu sklepu. Najbezpieczniej izolować moduły pojedynczo i uzupełnić sprawdzanie o analizę logów.
Spis treści
Przed rozpoczęciem diagnostyki
Przygotuj dostęp do panelu administracyjnego PrestaShop. Jeśli panel nie działa, potrzebny będzie dostęp FTP. Wyłączanie modułów przez FTP może być potrzebne właśnie wtedy, gdy nie można zalogować się do panelu administracyjnego. Takie rozwiązanie pozwala również uniknąć błędów podczas dezaktywacji modułu w panelu. Zobacz opis wyłączania modułów PrestaShop przez FTP.
- Zapisz moment wystąpienia problemu.
- Ustal, czy błąd pojawił się po instalacji, aktualizacji albo konfiguracji konkretnego modułu.
- Nie zmieniaj jednocześnie ustawień kilku modułów.
- Przed zmianami zapisz aktualny stan konfiguracji, aby można było cofnąć ostatnią zmianę.
Jak rozpoznać konflikt modułu
Zwróć uwagę na powtarzalność problemu. Jeśli błąd pojawia się po włączeniu konkretnego modułu i znika po jego wyłączeniu, moduł jest głównym podejrzanym. Sprawdź osobno następujące objawy:
- biały ekran po otwarciu sklepu lub panelu,
- brak funkcji, która wcześniej działała,
- nieudane przejście przez proces zakupowy,
- błąd wyświetlany w panelu administracyjnym,
- zmiana układu strony po instalacji lub aktualizacji modułu.
Nie zakładaj od razu, że przyczyną jest ostatni moduł. Potraktuj go jako pierwszy element do kontrolowanego testu, a następnie sprawdź wynik po jego wyłączeniu.
Lista kontrolna izolowania modułu
- Opisz problem. Zapisz adres strony, na której występuje błąd, wykonane działanie oraz dokładny komunikat. W przypadku białego ekranu zanotuj, czy problem dotyczy sklepu, panelu czy obu miejsc.
- Sprawdź ostatnią zmianę. Ustal, który moduł był ostatnio instalowany, aktualizowany lub konfigurowany. Zacznij od niego, ale nie wyłączaj pozostałych rozszerzeń.
- Sprawdź logi. Zapisz wpisy z czasu wystąpienia problemu. Szczególnie ważne są nazwy modułu, nazwy plików oraz komunikaty pojawiające się bezpośrednio po wykonanej zmianie.
- Przetestuj moduł w odizolowany sposób. Wyłącz tylko jeden podejrzany moduł, a następnie sprawdź tę samą funkcję, która wcześniej nie działała.
- Wyczyść cache. Po zmianie modułu usuń cache PrestaShop, a następnie ponów dokładnie ten sam test. Pozwala to odróżnić aktualny wynik od wcześniej zapisanej wersji strony.
- Porównaj wynik. Jeśli problem zniknął po wyłączeniu jednego modułu, włącz go ponownie tylko wtedy, gdy możesz bezpiecznie powtórzyć test. Jeśli błąd wróci, zapisz ten wynik jako dowód związku z modułem.
- Powtórz test na kopii testowej. Jeżeli masz środowisko testowe sklepu, wykonaj na nim tę samą zmianę. Nie używaj do testów kilku modyfikacji naraz, ponieważ wynik będzie trudniejszy do oceny.
Wyłączanie modułu z panelu administracyjnego
PrestaShop pozwala zarządzać modułami z poziomu panelu administracyjnego. Moduły rozszerzają funkcjonalność sklepu, dlatego wyłączenie jednego z nich może wpłynąć na funkcję, którą ten moduł obsługuje. Instrukcja wyłączania modułów PrestaShop przez panel administracyjny.
- Otwórz listę modułów w panelu administracyjnym.
- Znajdź moduł wskazany przez ostatnią zmianę lub wpis w logu.
- Wyłącz tylko ten moduł.
- Sprawdź funkcję, która była niedostępna albo wyświetlała błąd.
- Zapisz wynik testu przed zmianą kolejnego modułu.
Jeśli wyłączenie modułu nie zmieniło zachowania sklepu, przywróć jego poprzedni stan przed testem kolejnego rozszerzenia. Dzięki temu każda próba ma jasny punkt odniesienia.
Co zrobić, gdy panel administracyjny nie działa
Gdy błąd uniemożliwia dostęp do panelu, użyj FTP do wyłączenia pojedynczego modułu. To alternatywna metoda wskazana dla sytuacji, w której panel administracyjny jest niedostępny. Sprawdź procedurę wyłączania modułu PrestaShop przez FTP.
Po wyłączeniu modułu przez FTP ponownie otwórz sklep i sprawdź ten sam adres oraz tę samą funkcję. Nie usuwaj plików modułu podczas pierwszego testu. Najpierw wykonaj odwracalną zmianę i zapisz jej rezultat.
Jak sprawdzić błędy XML
Nie każdy problem po aktualizacji modułu wynika z konfliktu kodu. PrestaShop może także wyświetlać komunikaty związane z plikami XML. Przykładowe komunikaty to Extra content at the end of the document w pliku country_module_list.xml oraz Sequence '<<]]>' not allowed in content w pliku XML. Zobacz przykłady błędów XML w PrestaShop i sposób ich diagnozowania.
Jeśli log wskazuje konkretny plik XML, zapisz jego nazwę i pełny komunikat. Nie łącz tego testu z wyłączaniem kilku modułów. Najpierw ustal, czy błąd XML pojawia się po zmianie konkretnego modułu.
Co przygotować przed kontaktem z pomocą techniczną
Przekaż uporządkowane informacje, aby można było odtworzyć problem:
- opis objawu i adres strony, na którym występuje,
- datę oraz rodzaj ostatniej zmiany,
- nazwę podejrzanego modułu,
- dokładny komunikat błędu z logu,
- informację, czy moduł był testowany po wyłączeniu,
- wynik testu po wyczyszczeniu cache,
- informację, czy moduł wyłączono z panelu administracyjnego, czy przez FTP.
Najbardziej użyteczny jest opis jednej kontrolowanej zmiany i jej skutku. Dołącz pełny komunikat, a nie tylko krótkie streszczenie błędu.
Bezpieczny następny krok
Rozpocznij od modułu ostatnio zainstalowanego lub zaktualizowanego. Zapisz objaw, sprawdź logi, wyłącz tylko jeden moduł, wyczyść cache i powtórz ten sam test. Jeśli problem znika po jednej zmianie, zachowaj ten wynik i nie wprowadzaj kolejnych modyfikacji przed ustaleniem dalszego sposobu naprawy.