Co stanie się z modułami po aktualizacji PrestaShop? Kompatybilność, integracje i ukryte problemy

Aktualizacja PrestaShop kojarzy się przede wszystkim ze zmianą wersji silnika sklepu. Właściciel oczekuje nowocześniejszego systemu, większego bezpieczeństwa i możliwości dalszego rozwoju sprzedaży. Jednak w przypadku rozbudowanego e-commerce samo zaktualizowanie PrestaShop często okazuje się najprostszą częścią całego przedsięwzięcia.

Prawdziwe wyzwania pojawiają się przy modułach.

Sklep korzystający z kilkudziesięciu rozszerzeń może być połączony z systemem ERP, platformami marketplace, bramkami płatności, firmami kurierskimi, hurtowniami oraz narzędziami marketingowymi. Wiele z tych połączeń powstawało przez lata, a niektóre moduły mogły zostać zmodyfikowane specjalnie na potrzeby konkretnego biznesu.

Czy po aktualizacji PrestaShop wszystkie moduły będą nadal działały? Czy konieczny będzie zakup nowych licencji? Co zrobić, jeśli producent rozszerzenia zakończył jego rozwój?

W tym artykule wyjaśniamy, od czego zależy kompatybilność modułów, jakie problemy mogą wystąpić podczas przechodzenia z PrestaShop 1.7 lub 8 na nowszą wersję oraz jak przygotować sklep, aby uniknąć nieplanowanych kosztów i przerw w sprzedaży.

Czy moduły będą działać po aktualizacji PrestaShop?

Nie każdy moduł działający w PrestaShop 1.7 lub 8 będzie poprawnie funkcjonował w PrestaShop 9. Zgodność zależy od konkretnej wersji rozszerzenia, zastosowanych technologii, sposobu integracji z systemem oraz zmian wprowadzonych przez jego producenta.

Nie oznacza to jednak, że wszystkie starsze moduły trzeba wymienić.

Część rozszerzeń działa poprawnie po aktualizacji. Inne wymagają instalacji nowszej wersji, dostosowania kodu lub zmiany konfiguracji. Zdarzają się również moduły, których dalsze utrzymywanie nie ma technicznego lub ekonomicznego uzasadnienia.

Istotne jest rozróżnienie trzech poziomów zgodności:

• Zgodność instalacyjna – moduł można zainstalować lub pozostawić aktywny w nowej wersji sklepu.
• Zgodność techniczna – moduł nie powoduje błędów PHP, konfliktów z systemem ani problemów z panelem administracyjnym.
• Zgodność funkcjonalna – wszystkie procesy obsługiwane przez moduł działają prawidłowo, również w nietypowych scenariuszach zakupowych.

Sam fakt, że moduł jest aktywny i nie wyświetla błędów, nie potwierdza jeszcze jego pełnej kompatybilności.

Przykładowo integracja ERP może poprawnie pobierać zamówienia, ale nie aktualizować ich statusów. Moduł płatności może wyświetlać dostępne metody, lecz błędnie obsługiwać powiadomienia o zakończonej transakcji.

Dlatego zgodność modułów należy oceniać na podstawie ich rzeczywistego działania, a nie tylko deklaracji kompatybilności.

Dlaczego moduły przestają działać po aktualizacji PrestaShop?

PrestaShop rozwija się nie tylko pod względem wyglądu panelu administracyjnego czy funkcji dostępnych dla klientów. Kolejne wersje wprowadzają również zmiany w architekturze aplikacji, bibliotekach, wymaganiach serwerowych i mechanizmach programistycznych.

Moduły współpracują bezpośrednio z tym środowiskiem. Jeżeli zostały napisane w oparciu o starsze rozwiązania, aktualizacja może ujawnić problemy, które wcześniej nie występowały.

1. Zmiana wersji PHP

Jednym z najczęstszych źródeł niezgodności są różnice między wersjami PHP.

PrestaShop 9.0 wymaga co najmniej PHP 8.1 i obsługuje również nowsze wersje przewidziane dla tego wydania. Konkretne zalecenia zależą od wersji PrestaShop, dlatego konfigurację należy każdorazowo sprawdzić w oficjalnej dokumentacji. Dobrym źródłem wiedzy jest też tabela zgodności wersji PHP z PrestaShop na naszym blogu.

Moduł napisany wiele lat temu może wykorzystywać konstrukcje, które w nowym PHP zostały usunięte, zmieniły sposób działania lub generują błędy.

Typowe problemy obejmują:

• wywoływanie nieistniejących lub usuniętych funkcji,
• niezgodność typów argumentów i wartości zwracanych,
• korzystanie ze starych bibliotek PHP,
• błędną obsługę wyjątków,
• niezgodność modułów szyfrowanych z dostępną wersją PHP lub loadera ionCube.

Ostatni przypadek jest szczególnie problematyczny. Jeżeli moduł został zabezpieczony przez producenta i nie udostępnia kodu źródłowego, samodzielne dostosowanie rozszerzenia może być niemożliwe. Konieczna jest współpraca z dostawcą lub znalezienie rozwiązania zastępczego.

2. Zmiany w Symfony i architekturze PrestaShop

PrestaShop stopniowo modernizuje swoją architekturę, wykorzystując framework Symfony.

W PrestaShop 9.0 zastosowano Symfony 6.4, podczas gdy PrestaShop 8 korzystał z Symfony 4.4. To istotna zmiana, szczególnie dla modułów rozbudowujących panel administracyjny, wykorzystujących usługi Symfony lub zależności dostarczane wcześniej przez sam silnik sklepu.

Problemy mogą dotyczyć między innymi kontrolerów, routingu, formularzy, serwisów, zależności Composer czy metod, które nie są już obsługiwane.

Warto przy tym podkreślić, że nie każdy moduł korzystający ze starszych mechanizmów automatycznie przestaje działać. Ryzyko zależy od tego, z jakich elementów systemu rzeczywiście korzysta rozszerzenie.

3. Konflikty z override i modyfikacjami sklepu

Wiele starszych sklepów posiada indywidualne modyfikacje klas lub kontrolerów PrestaShop, wykonywane za pomocą mechanizmu override.

Takie rozwiązania mogły działać bezproblemowo przez lata. Jednak po aktualizacji kod nadpisujący standardowe funkcje systemu może być niezgodny z ich nową implementacją.

Co więcej, dwa moduły mogą próbować ingerować w te same elementy sklepu.

Efektem bywają błędy 500, nieprawidłowe naliczanie cen, problemy z koszykiem, brak możliwości zapisania zmian w panelu administracyjnym lub awarie pojawiające się tylko w określonych sytuacjach.

4. Zmiany w szablonie i mechanizmach wyświetlania

Moduł może działać poprawnie od strony serwera, ale jego funkcje nie będą widoczne dla klientów.

Dotyczy to szczególnie rozszerzeń wykorzystujących hooki, własne szablony Smarty, JavaScript i CSS.

Przykładowo po zmianie motywu lub aktualizacji jego plików mogą zniknąć:

• gwiazdki opinii na kafelkach produktów,
• dodatkowe pola na karcie produktu,
• filtry na urządzeniach mobilnych,
• elementy koszyka i checkoutu,
• przyciski logowania zewnętrznego,
• sekcje rekomendowanych produktów.

Przyczyną nie zawsze jest błąd samego modułu. Czasami nowe pliki szablonu po prostu nie zawierają odpowiedniego miejsca do wyświetlenia jego zawartości.

Które moduły PrestaShop wymagają szczególnej uwagi?

Nie wszystkie rozszerzenia mają taki sam wpływ na działalność sklepu.

Awaria modułu wyświetlającego dodatkowy baner może oznaczać wyłącznie problem wizualny. Nieprawidłowe działanie integracji płatności, magazynu czy fakturowania może natomiast bezpośrednio zatrzymać sprzedaż lub spowodować błędy w obsłudze zamówień.

Dlatego przed aktualizacją warto podzielić moduły według znaczenia biznesowego.

Ocena ryzyka powinna uwzględniać konkretny model sprzedaży.

W sklepie B2B z dużym udziałem automatyzacji integracja z systemem ERP może być ważniejsza niż sam frontend. W sklepie detalicznym szczególnie istotne będą koszyk, metody dostawy i płatności.

Moduły płatności w PrestaShop – problemy, których nie widać od razu

Przed aktualizacją warto sprawdzić nie tylko to, czy metoda płatności pojawia się podczas składania zamówienia.

Należy także przetestować:

• utworzenie transakcji,
• prawidłowe przekierowanie do operatora płatności,
• otrzymanie powiadomienia zwrotnego,
• zmianę statusu zamówienia,
• obsługę płatności nieudanej lub przerwanej,
• ponowienie płatności, jeżeli moduł oferuje taką funkcję,
• zwroty i częściowe zwroty płatności.

Sklep może przyjmować zamówienia mimo błędów w komunikacji z operatorem. Problem ujawnia się dopiero wtedy, gdy pracownicy zaczynają ręcznie weryfikować opłacone transakcje.

Integracje ERP i marketplace – największe ryzyko ukrytych błędów

W rozbudowanych sklepach moduły integracyjne odpowiadają za wymianę danych z systemami zewnętrznymi.

Dotyczy to między innymi Comarch ERP Optima, Subiekta, Nexo, Symfonii, WAPRO czy systemów OMS, a także platform takich jak Allegro, Amazon, eMAG i innych marketplace’ów.

Po aktualizacji PrestaShop integracja może nadal uruchamiać zadania synchronizacji, ale wykonywać je nieprawidłowo.

Przykładowe problemy to brak pobierania nowych zamówień, niewłaściwe mapowanie statusów, nadpisywanie cen, błędna obsługa wariantów produktów lub nieprawidłowa synchronizacja stanów magazynowych.

Są to błędy szczególnie niebezpieczne, ponieważ nie zawsze powodują widoczną awarię sklepu.

Brak komunikatu o błędzie nie oznacza, że integracja działa poprawnie.

W przypadku systemów ERP i marketplace’ów konieczne są testy na rzeczywistych scenariuszach wymiany danych oraz porównanie wyników po obu stronach integracji.

Czy moduły z PrestaShop 1.7 zadziałają na PrestaShop 9?

Nie istnieje jedna odpowiedź dotycząca wszystkich modułów PrestaShop 1.7.

Rozszerzenie napisane zgodnie z dobrymi praktykami, korzystające ze stabilnych mechanizmów systemu i aktywnie rozwijane przez producenta może wymagać stosunkowo niewielkich zmian.

Inaczej wygląda sytuacja w przypadku modułu sprzed wielu lat, który korzysta z przestarzałych bibliotek, posiada liczne override’y i nie otrzymuje aktualizacji.

Przy przechodzeniu ze starszych wersji warto sprawdzić cztery elementy:

Wersję modułu i deklarowaną kompatybilność. Należy ustalić, czy producent udostępnia wydanie przeznaczone dla konkretnej wersji docelowej PrestaShop.

Zgodność z docelową wersją PHP. Samo oznaczenie kompatybilności z PrestaShop nie zawsze wystarcza, jeżeli środowisko serwerowe używa innej wersji PHP niż przewidziana przez dostawcę.

Zakres indywidualnych modyfikacji. Moduł kupiony kilka lat temu mógł zostać znacząco rozbudowany. Zastąpienie go najnowszą wersją producenta może usunąć wcześniej wykonane zmiany.

Możliwość zachowania konfiguracji i danych. Przy wymianie modułu konieczne może być przeniesienie ustawień, mapowań, identyfikatorów lub informacji zapisanych w dodatkowych tabelach bazy danych.

Jeżeli sklep korzysta z wielu starszych rozszerzeń, decyzja o sposobie modernizacji wymaga szerszej analizy.

Opisujemy to również w poradniku Aktualizacja czy przebudowa PrestaShop – co wybrać dla starszego sklepu?.

Co zrobić, gdy producent modułu nie wspiera nowej wersji PrestaShop?

To jeden z trudniejszych scenariuszy przy modernizacji wieloletniego sklepu.

Wyobraźmy sobie sklep korzystający z dedykowanego konfiguratora produktów. Moduł odpowiada za wybór parametrów, obliczenie ceny i zapisanie konfiguracji w zamówieniu.

Rozwiązanie działa na PrestaShop 1.7, ale jego producent zakończył działalność lub nie planuje wsparcia dla nowszych wersji.

Czy oznacza to konieczność rezygnacji z konfiguratora?

Niekoniecznie.

W zależności od konstrukcji modułu istnieją trzy główne możliwości.

Dostosowanie istniejącego modułu

Jeśli dostępny jest kod źródłowy, można przeanalizować zależności i dostosować moduł do nowego środowiska.

Takie rozwiązanie ma sens, gdy architektura rozszerzenia jest poprawna, zakres zmian pozostaje kontrolowany, a jego funkcje odpowiadają obecnym potrzebom biznesowym.

Trzeba jednak zweryfikować licencję, warunki modyfikacji oraz możliwość przyszłego utrzymania kodu.

Wymiana modułu na kompatybilny odpowiednik

W przypadku popularnych funkcji, takich jak filtrowanie produktów, opinie czy obsługa płatności, często dostępne są alternatywne rozwiązania.

Wymiana nie powinna jednak polegać wyłącznie na odinstalowaniu starego modułu i zainstalowaniu nowego.

Konieczne może być przeniesienie danych, konfiguracji, reguł cenowych, identyfikatorów oraz dostosowanie szablonu.

Przygotowanie dedykowanego rozwiązania

Jeśli moduł obsługuje proces specyficzny dla danego przedsiębiorstwa, przebudowa może być rozsądniejsza niż wieloletnie utrzymywanie przestarzałego kodu.

Dedykowane rozwiązanie pozwala zachować istotne funkcje biznesowe i dopasować integrację do aktualnej architektury PrestaShop.

Nie każda funkcja wymaga jednak nowego modułu. Czasami po analizie okazuje się, że część możliwości jest już dostępna natywnie lub można ją zrealizować prostszym rozwiązaniem.

Ukryte problemy po aktualizacji modułów PrestaShop

Najbardziej oczywistym problemem jest sytuacja, w której sklep przestaje się otwierać lub wyświetla błąd 500.

Jednak w praktyce znacznie trudniejsze do wykrycia mogą być błędy, które nie powodują całkowitej awarii.

Sklep działa, ale nie rejestruje wszystkich konwersji

Po aktualizacji może dojść do nieprawidłowego przekazywania zdarzeń zakupowych do GA4, Google Ads czy innych narzędzi analitycznych.

Zamówienia są składane, ale raporty nie pokazują pełnych danych o sprzedaży. Może to zaburzyć ocenę rentowności kampanii reklamowych.

Zamówienie powstaje, ale nie trafia do ERP

Integracja może przestać prawidłowo reagować na określony status zamówienia lub zmianę danych.

Problem ujawnia się dopiero podczas realizacji zamówień, gdy część sprzedaży nie pojawia się w systemie magazynowym.

Rabaty i ceny działają inaczej niż wcześniej

Nieprawidłowa współpraca modułów promocji, podatków i indywidualnych reguł cenowych może prowadzić do błędnych wartości w koszyku.

Dotyczy to szczególnie sklepów B2B, wielu walut, kilku grup klientów i indywidualnych cenników.

Moduł działa na komputerze, ale nie na telefonie

Wiele rozszerzeń wykorzystuje skrypty JavaScript i mechanizmy szablonu odpowiedzialne za interakcje użytkownika.

Po aktualizacji mogą pojawić się problemy z mobilnymi filtrami, menu, wyszukiwarką czy dodatkowymi elementami karty produktu.

Zadania CRON przestają wykonywać synchronizację

Niektóre integracje działają w tle, wykorzystując harmonogram zadań.

Jeśli skrypt uruchamiany przez CRON korzysta ze starego kodu lub niekompatybilnej wersji PHP, synchronizacja może zatrzymać się bez widocznego komunikatu dla klientów.

Z tego powodu testowanie sklepu powinno obejmować również procesy automatyczne, a nie tylko czynności wykonywane w przeglądarce.

Jak sprawdzić kompatybilność modułów przed aktualizacją PrestaShop?

Najbezpieczniejszym rozwiązaniem jest przeprowadzenie audytu technicznego przed rozpoczęciem właściwych prac.

Nie musi on od razu oznaczać szczegółowego przepisywania wszystkich rozszerzeń. Pierwszym krokiem jest ustalenie, z jakich modułów sklep korzysta i które z nich są rzeczywiście potrzebne.

Krok 1. Przygotuj listę wszystkich modułów

Należy zinwentaryzować zarówno moduły aktywne, jak i nieaktywne, a także rozwiązania dedykowane oraz dodatkowe modyfikacje szablonu.

Lista powinna zawierać nazwę modułu, aktualną wersję, producenta, pełnioną funkcję oraz informację o dostępności aktualizacji.

Krok 2. Ustal znaczenie biznesowe rozszerzeń

Każdy moduł warto przypisać do jednej z kategorii: krytyczny, istotny lub dodatkowy.

Priorytetem są rozwiązania obsługujące płatności, zamówienia, ceny, dostawy, integracje oraz procesy magazynowe.

Krok 3. Zweryfikuj zgodność z wersją docelową

Sprawdzenie powinno obejmować wersję PrestaShop, PHP i dostępne wydania modułu, a także jego zależności od szablonu i innych rozszerzeń.

Jeżeli producent deklaruje kompatybilność, należy ustalić, jakiej dokładnie wersji modułu i środowiska ta deklaracja dotyczy.

Krok 4. Wskaż rozszerzenia wymagające decyzji

Dla każdego problematycznego modułu należy określić, czy zostanie zaktualizowany, dostosowany, zastąpiony czy usunięty.

Warto również oszacować konsekwencje takiej zmiany dla dotychczasowych danych i konfiguracji.

Krok 5. Przygotuj środowisko testowe

Aktualizację oraz weryfikację kompatybilności najlepiej przeprowadzić na oddzielnej kopii sklepu.

Środowisko powinno możliwie wiernie odwzorowywać produkcję, ale nie może przypadkowo wysyłać rzeczywistych powiadomień do klientów, uruchamiać produkcyjnych płatności ani nadpisywać danych w ERP.

Krok 6. Wykonaj testy procesów biznesowych

Po aktualizacji trzeba przetestować nie tylko pojedyncze moduły, lecz również współpracę między nimi.

Przykładowy pełny scenariusz obejmuje dodanie produktu do koszyka, naliczenie rabatu, wybór dostawy, opłacenie zamówienia, aktualizację jego statusu, przekazanie do ERP i wygenerowanie dokumentu sprzedaży.

Dopiero poprawne przejście całego procesu pozwala ocenić gotowość sklepu do uruchomienia.

Checklista: 12 rzeczy do sprawdzenia przed aktualizacją modułów

Przed zmianą wersji PrestaShop warto odpowiedzieć na następujące pytania:

1. Czy posiadamy aktualną listę wszystkich modułów?
2. Czy znamy wersje rozszerzeń i ich producentów?
3. Czy moduły obsługują docelową wersję PrestaShop?
4. Czy są zgodne z planowaną wersją PHP?
5. Czy w sklepie występują dedykowane modyfikacje modułów?
6. Czy stosowane są override’y klas i kontrolerów?
7. Czy nowe wersje modułów zachowają dotychczasowe dane?
8. Czy integracje ERP i marketplace obsługują wszystkie wymagane operacje?
9. Czy moduły płatności i dostaw zostały sprawdzone na zamówieniach testowych?
10. Czy zadania CRON i komunikacja API działają poprawnie?
11. Czy przygotowano aktualną kopię zapasową i procedurę powrotu?
12. Czy określono kryteria odbioru oraz sposób monitorowania sklepu po uruchomieniu?

Jeśli na kilka z tych pytań nie ma jednoznacznej odpowiedzi, warto uzupełnić analizę przed rozpoczęciem aktualizacji.

Ile kosztuje dostosowanie modułów do nowej wersji PrestaShop?

Koszt zależy przede wszystkim od liczby i jakości rozszerzeń oraz od tego, jak głęboko ingerują one w działanie sklepu.

W niewielkim sklepie, korzystającym z popularnych i regularnie rozwijanych modułów, dostosowanie może ograniczać się do instalacji kompatybilnych wersji i przeprowadzenia testów.

W rozbudowanym sklepie B2B, połączonym z ERP, kilkoma marketplace’ami i dedykowanymi modułami, zakres prac może być znacznie większy.

Na całkowity koszt wpływają między innymi:

• liczba rozszerzeń wymagających zmian,
• dostępność aktualnych wersji i licencji,
• jakość istniejącego kodu,
• zakres indywidualnych modyfikacji,
• złożoność integracji zewnętrznych,
• konieczność migracji danych modułów,
• liczba scenariuszy testowych,
• potrzeba przebudowy przestarzałych funkcji.

W Astrabit oferujemy dwa modele rozliczenia prac związanych z dostosowaniem modułów PrestaShop: ryczałtowy oraz godzinowy. W przypadku jasno określonego zakresu prac możliwe jest ustalenie z góry stałej ceny realizacji. Przy bardziej złożonych projektach, w których zakres niezbędnych modyfikacji może ujawnić się dopiero podczas analizy kodu i testów, stosujemy rozliczenie godzinowe według stawki 200 zł netto za godzinę pracy specjalisty.

Nie należy więc zakładać, że koszt aktualizacji modułów jest zawsze proporcjonalny do ich liczby.

Jeden rozbudowany moduł dedykowany może wymagać więcej pracy niż kilkanaście standardowych rozszerzeń.

Najważniejsze jest oszacowanie nakładu prac jeszcze przed rozpoczęciem aktualizacji, a nie dopiero po wystąpieniu pierwszych błędów.

Czy warto aktualizować wszystkie moduły PrestaShop?

Nie zawsze.

Aktualizacja jest dobrą okazją do uporządkowania sklepu i usunięcia funkcji, które nie są już wykorzystywane.

Zdarza się, że sklep posiada kilka modułów realizujących podobne zadania, pozostałości po dawnych integracjach lub rozszerzenia zainstalowane wyłącznie do jednorazowych testów.

Każdy dodatkowy moduł zwiększa liczbę elementów wymagających utrzymania, choć wpływ na bezpieczeństwo i wydajność zależy od jego konstrukcji oraz sposobu działania.

Przed aktualizacją warto więc ustalić:

• które rozszerzenia rzeczywiście wspierają sprzedaż,
• które funkcje można zastąpić możliwościami nowej wersji systemu,
• które moduły dublują swoje działanie,
• czy niewspierane rozwiązania warto dalej utrzymywać,
• czy istnieją prostsze sposoby realizacji tego samego procesu.

Należy przy tym pamiętać, że samo odinstalowanie modułu nie zawsze usuwa wszystkie jego dane, pliki lub modyfikacje. Porządkowanie powinno być poprzedzone kopią zapasową i analizą zależności.

Celem nie jest maksymalne ograniczenie liczby modułów, ale stworzenie stabilnego środowiska, które będzie można bezpiecznie rozwijać.

Jak Astrabit podchodzi do kompatybilności modułów podczas aktualizacji?

W Astrabit zajmujemy się rozwojem i utrzymaniem sklepów PrestaShop od 2015 roku. Pracujemy zarówno ze standardowymi rozszerzeniami, jak i rozwiązaniami dedykowanymi, integracjami ERP, marketplace oraz indywidualnymi procesami sprzedażowymi.

W przypadku modernizacji rozbudowanego sklepu analizujemy nie tylko samą wersję systemu, ale również zależności między modułami, szablonem i infrastrukturą.

Naszym celem jest zachowanie prawidłowego działania procesów biznesowych, a nie wyłącznie uzyskanie nowszego numeru wersji PrestaShop.

W zależności od potrzeb projekt może obejmować:

• audyt kompatybilności modułów i integracji,
• aktualizację istniejących rozszerzeń,
• dostosowanie kodu modułów dedykowanych,
• wymianę przestarzałych rozwiązań,
• kontrolę kompatybilności z PHP i Symfony,
• testowanie checkoutu, płatności i dostaw,
• weryfikację wymiany danych z ERP i marketplace,
• przygotowanie środowiska testowego i planu uruchomienia.

Każdy sklep wymaga indywidualnej oceny. Niektóre projekty pozwalają na stosunkowo prostą aktualizację, podczas gdy inne wymagają uporządkowania architektury lub przebudowy części funkcji.

Najczęściej zadawane pytania o moduły po aktualizacji PrestaShop (FAQ)