{"id":90204,"date":"2026-10-28T09:35:00","date_gmt":"2026-10-28T08:35:00","guid":{"rendered":"https:\/\/codescriptum.pl\/blog\/aktualizacja-prestashop-moduly-przestaly-dzialac\/"},"modified":"2026-10-28T09:35:00","modified_gmt":"2026-10-28T08:35:00","slug":"aktualizacja-prestashop-moduly-przestaly-dzialac","status":"publish","type":"post","link":"https:\/\/codescriptum.pl\/blog\/aktualizacja-prestashop-moduly-przestaly-dzialac\/","title":{"rendered":"Aktualizacja PrestaShop: modu\u0142y przesta\u0142y dzia\u0142a\u0107 - co zrobi\u0107 i jak aktualizowa\u0107 bezpiecznie"},"content":{"rendered":"<p>Po aktualizacji PrestaShop modu\u0142y przestaj\u0105 dzia\u0142a\u0107, bo nowa wersja zmienia fundamenty sklepu: wymagane wersje PHP, framework Symfony i spos\u00f3b dzia\u0142ania szablon\u00f3w, a modu\u0142y, nadpisania klas rdzenia (override) i szablon pisane pod starsz\u0105 wersj\u0119 korzystaj\u0105 z element\u00f3w, kt\u00f3re si\u0119 zmieni\u0142y. Je\u015bli sklep po aktualizacji nie dzia\u0142a, przywr\u00f3\u0107 kopi\u0119 zapasow\u0105, a aktualizacj\u0119 powt\u00f3rz na kopii testowej z list\u0105 zgodno\u015bci modu\u0142\u00f3w. PrestaShop 9.0 z czerwca 2025 r. to wydanie g\u0142\u00f3wne oparte na Symfony 6.4 i producent sam uprzedza, \u017ce cz\u0119\u015b\u0107 modu\u0142\u00f3w i szablon\u00f3w b\u0119dzie wymaga\u0142a aktualizacji.<\/p>\n<h2>Jak wygl\u0105da problem?<\/h2>\n<ul>\n<li>b\u0142\u0105d 500 albo bia\u0142y ekran na stronie sklepu lub w panelu,<\/li>\n<li>modu\u0142 p\u0142atno\u015bci albo przewo\u017anika znikn\u0105\u0142 z zam\u00f3wienia,<\/li>\n<li>szablon wy\u015bwietla si\u0119 bez styl\u00f3w albo z b\u0142\u0119dami na karcie produktu,<\/li>\n<li>komunikat o niezgodnym module albo brakuj\u0105cej klasie,<\/li>\n<li>integracja z hurtowni\u0105, BaseLinkerem lub programem ksi\u0119gowym przesta\u0142a wymienia\u0107 dane.<\/li>\n<\/ul>\n<h2>Dlaczego modu\u0142y przestaj\u0105 dzia\u0142a\u0107 po aktualizacji?<\/h2>\n<h3>Wydanie g\u0142\u00f3wne zmienia fundamenty<\/h3>\n<p>Przej\u015bcie mi\u0119dzy wydaniami g\u0142\u00f3wnymi (1.7, 8, 9) to nie drobna poprawka. PrestaShop 8 korzysta\u0142 z Symfony 4.4, a PrestaShop 9 z Symfony 6.4, co zmienia spos\u00f3b dzia\u0142ania panelu i cz\u0119\u015bci interfejs\u00f3w, z kt\u00f3rych korzystaj\u0105 modu\u0142y. Modu\u0142, kt\u00f3ry nie zosta\u0142 dostosowany przez autora, mo\u017ce przesta\u0107 dzia\u0142a\u0107 w ca\u0142o\u015bci albo tylko w jednym miejscu, np. na stronie konfiguracji.<\/p>\n<h3>Nowe wymagania PHP<\/h3>\n<p>Ga\u0142\u0105\u017a 8.x dzia\u0142a na PHP od 7.2 do 8.1, a PrestaShop 9.0 na PHP od 8.1 do 8.4. Zmiana PHP na serwerze przy okazji aktualizacji ujawnia b\u0142\u0119dy w starym kodzie modu\u0142\u00f3w, kt\u00f3ry dzia\u0142a\u0142 tylko na starszych wersjach j\u0119zyka.<\/p>\n<h3>Nadpisania klas rdzenia (override)<\/h3>\n<p>Cz\u0119\u015b\u0107 modu\u0142\u00f3w i zmian zamawianych u programist\u00f3w nadpisuje klasy rdzenia PrestaShop zamiast korzysta\u0107 z punkt\u00f3w zaczepienia (hook\u00f3w). Po aktualizacji rdze\u0144 si\u0119 zmienia, a nadpisanie zostaje w starej wersji i psuje dzia\u0142anie sklepu albo blokuje sam\u0105 aktualizacj\u0119. To najcz\u0119stsza przyczyna problem\u00f3w w sklepach rozwijanych latami.<\/p>\n<h3>Modu\u0142y bez wsparcia<\/h3>\n<p>Modu\u0142 kupiony lata temu m\u00f3g\u0142 przesta\u0107 by\u0107 rozwijany albo jego licencja na aktualizacje wygas\u0142a. Wtedy nie ma wersji zgodnej z now\u0105 PrestaShop i trzeba go zast\u0105pi\u0107 albo przepisa\u0107.<\/p>\n<h3>Szablon i cache<\/h3>\n<p>Szablon dostosowany do starszej wersji nie zna nowych element\u00f3w stron, a stare pliki w cache sklepu potrafi\u0105 po aktualizacji wy\u015bwietla\u0107 nieaktualne szablony lub b\u0142\u0119dy. W PrestaShop 9.1 domy\u015blnym szablonem jest Hummingbird 2.0, ale sklep z w\u0142asnym szablonem nie dostanie go automatycznie, wi\u0119c trzeba sprawdzi\u0107, czy obecny szablon jest zgodny.<\/p>\n<h2>Co zrobi\u0107, gdy sklep po aktualizacji nie dzia\u0142a?<\/h2>\n<ol>\n<li>W\u0142\u0105cz tryb konserwacji, \u017ceby klienci nie sk\u0142adali zam\u00f3wie\u0144 w niedzia\u0142aj\u0105cym sklepie.<\/li>\n<li>Je\u015bli masz kopi\u0119 sprzed aktualizacji, przywr\u00f3\u0107 j\u0105. Asystent aktualizacji PrestaShop (dawniej 1-Click Upgrade) robi kopi\u0119 i pozwala przywr\u00f3ci\u0107 sklep.<\/li>\n<li>Je\u015bli musisz naprawia\u0107 na miejscu, w\u0142\u0105cz na chwil\u0119 tryb debugowania albo sprawd\u017a log b\u0142\u0119d\u00f3w PHP, \u017ceby zobaczy\u0107, kt\u00f3ry modu\u0142 lub plik powoduje b\u0142\u0105d.<\/li>\n<li>Wy\u0142\u0105cz problematyczny modu\u0142 (w panelu albo przez zmian\u0119 nazwy jego folderu na serwerze) i wyczy\u015b\u0107 cache sklepu.<\/li>\n<li>Sprawd\u017a p\u0142atno\u015bci, dostaw\u0119 i maile z\u0142o\u017ceniem zam\u00f3wienia testowego, zanim wy\u0142\u0105czysz tryb konserwacji.<\/li>\n<\/ol>\n<h2>Jak bezpiecznie zaktualizowa\u0107 PrestaShop?<\/h2>\n<p>Na kopii testowej, z pe\u0142n\u0105 list\u0105 modu\u0142\u00f3w i nadpisa\u0144, po sprawdzeniu zgodno\u015bci u ich autor\u00f3w i z kopi\u0105 zapasow\u0105, kt\u00f3r\u0105 umiesz przywr\u00f3ci\u0107.<\/p>\n<table>\n<thead>\n<tr>\n<th>Wersja PrestaShop<\/th>\n<th>Obs\u0142ugiwane PHP<\/th>\n<th>Uwagi<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>8.0 - 8.2<\/td>\n<td>7.2 - 8.1 (zalecane 8.1)<\/td>\n<td>PHP 8.1 nie dostaje ju\u017c poprawek bezpiecze\u0144stwa<\/td>\n<\/tr>\n<tr>\n<td>9.0<\/td>\n<td>8.1 - 8.4<\/td>\n<td>Wydanie g\u0142\u00f3wne z czerwca 2025 r., Symfony 6.4<\/td>\n<\/tr>\n<tr>\n<td>9.1<\/td>\n<td>od 8.1, zalecane 8.5<\/td>\n<td>Nowy domy\u015blny szablon Hummingbird 2.0<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<ul>\n<li>spisz wszystkie modu\u0142y (z wersj\u0105 i autorem) oraz nadpisania w katalogu override,<\/li>\n<li>sprawd\u017a u autor\u00f3w, czy maj\u0105 wersje zgodne z docelow\u0105 PrestaShop, i odn\u00f3w licencje na aktualizacje,<\/li>\n<li>modu\u0142y bez wsparcia zast\u0105p innymi albo przepisz, a nadpisania przenie\u015b do hook\u00f3w,<\/li>\n<li>zr\u00f3b aktualizacj\u0119 na kopii testowej z docelow\u0105 wersj\u0105 PHP i przetestuj \u015bcie\u017ck\u0119 zakupu, panel i integracje,<\/li>\n<li>na dzia\u0142aj\u0105cym sklepie aktualizuj poza godzinami sprzeda\u017cy, z kopi\u0105 zapasow\u0105 i planem powrotu,<\/li>\n<li>wydania poprawkowe z poprawkami bezpiecze\u0144stwa instaluj bez zw\u0142oki, bo dotycz\u0105 znanych luk.<\/li>\n<\/ul>\n<h2>Aktualizowa\u0107 czy migrowa\u0107?<\/h2>\n<p>Je\u015bli sklep jest na ga\u0142\u0119zi 8.x i ma kilka modu\u0142\u00f3w od znanych autor\u00f3w, aktualizacja do 9 jest zwykle rozs\u0105dniejsza ni\u017c przenosiny. Je\u015bli sklep stoi na 1.7, ma wiele nadpisa\u0144, modu\u0142y bez wsparcia i szablon, kt\u00f3rego nikt nie rozwija, aktualizacja oznacza przepisanie du\u017cej cz\u0119\u015bci sklepu. Wtedy por\u00f3wnaj jej koszt z migracj\u0105 na inn\u0105 platform\u0119, na przyk\u0142ad WooCommerce, i uwzgl\u0119dnij, kto b\u0119dzie utrzymywa\u0142 sklep przez kolejne lata. Je\u015bli dodatkowo sklep dzia\u0142a wolno, zobacz wpis <a href=\"\/blog\/prestashop-dziala-wolno\/\">PrestaShop dzia\u0142a wolno<\/a>.<\/p>\n<div class=\"csb-note csb-note--warn\">\n<p>Nie aktualizuj dzia\u0142aj\u0105cego sklepu bez kopii zapasowej plik\u00f3w i bazy, kt\u00f3r\u0105 umiesz przywr\u00f3ci\u0107. Kopia, kt\u00f3rej nikt nigdy nie przywraca\u0142, to tylko nadzieja na kopi\u0119.<\/p>\n<\/div>\n<p>Je\u015bli zamiast kolejnej aktualizacji wolisz przenie\u015b\u0107 sklep na platform\u0119, kt\u00f3r\u0105 \u0142atwiej utrzyma\u0107, zobacz, jak przeprowadzamy <a href=\"https:\/\/codescriptum.pl\/migracja-sklepu-internetowego\/\">migracj\u0119 sklepu internetowego<\/a>. Ten problem jest jednym z naszej listy <a href=\"\/blog\/50-problemow-z-prestashop-i-shoperem\/\">50 problem\u00f3w z PrestaShop i Shoperem<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Po aktualizacji PrestaShop modu\u0142y przestaj\u0105 dzia\u0142a\u0107, bo nowa wersja zmienia fundamenty sklepu: wymagane wersje PHP, framework Symfony i spos\u00f3b dzia\u0142ania szablon\u00f3w, a modu\u0142y, nadpisania klas rdzenia (override) i szablon pisane\u2026<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[32],"tags":[],"class_list":["post-90204","post","type-post","status-publish","format-standard","hentry","category-sklepy-internetowe"],"_links":{"self":[{"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/posts\/90204","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/comments?post=90204"}],"version-history":[{"count":0,"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/posts\/90204\/revisions"}],"wp:attachment":[{"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/media?parent=90204"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/categories?post=90204"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/codescriptum.pl\/blog\/wp-json\/wp\/v2\/tags?post=90204"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}