1 click upgrade PrestaShop – aktualizacja PrestaShop w jednym kroku

Jeśli szukasz w panelu modułu „1-Click Upgrade” i go nie widzisz, nic nie zniknęło. Narzędzie zmieniło nazwę: w dokumentacji PrestaShop występuje dziś jako Update Assistant, a jego nazwa techniczna to Autoupgrade. Robi to samo – podmienia pliki systemowe i migruje bazę danych do nowszej wersji – tylko można je uruchomić na dwa sposoby: z panelu albo z linii poleceń. 

Ten wpis pokazuje, jak przeprowadzić upgrade tym modułem, na co zwrócić uwagę przy przejściu z 1.7 na 8 albo z 8 na 9 i co robić, gdy proces zatrzyma się w połowie. Piszemy z perspektywy zespołu, który aktualizuje sklepy klientów, więc znajdziesz tu też rzeczy, o których dokumentacja nie mówi: co najczęściej się psuje i czego nie warto próbować na sklepie produkcyjnym. 

Jedna uwaga na start. Automat aktualizuje rdzeń PrestaShop, a nie wasze moduły i motyw. Większość nieudanych aktualizacji, które trafiają do nas po fakcie, nie wynika z błędu modułu – wynika z tego, że nikt wcześniej nie sprawdził, czy dodatki działają w nowej wersji. 

Czym jest 1-Click Upgrade i pod jaką nazwą szukać go dziś 

Moduł jest darmowy i utrzymywany przez zespół PrestaShop w otwartym repozytorium. Nazwa „1-Click Upgrade” funkcjonuje dalej potocznie i w starszych instrukcjach, ale w panelu i w Addons szukaj Update Assistant. 

Co robi w praktyce: pobiera wskazaną wersję PrestaShop, tworzy kopię plików i bazy, podmienia rdzeń, uruchamia migracje bazy danych i pozwala cofnąć całość, jeśli coś pójdzie nie tak. Funkcja przywracania jest tu ważniejsza niż sama aktualizacja – to ona decyduje, czy nieudana próba kosztuje kwadrans, czy dwa dni. 

Ograniczenie, o którym trzeba wiedzieć zawczasu: przejścia między dużymi generacjami robi się etapami. Ze sklepu na 1.6 nie da się skoczyć wprost na 8 czy 9 – najpierw idziesz na 1.7, potem dalej. Każdy etap to osobna kopia zapasowa i osobne testy. 

Zanim klikniesz: przygotowanie sklepu 

Ten etap decyduje o wyniku i zajmuje więcej czasu niż sama aktualizacja. U nas wygląda tak: 

1. Kopia poza serwerem sklepu. Pliki i baza, pobrane lokalnie. Kopia leżąca na tym samym dysku co sklep nie jest kopią. 

2. Klon na środowisko testowe. Aktualizację przeprowadzamy najpierw na kopii sklepu, nigdy na wersji, do której wchodzą klienci. Jeśli hosting nie daje takiej możliwości, to pierwsza rzecz do zmiany – przed aktualizacją. 

3. Spis modułów i motywu z numerami wersji. Zwykła lista w arkuszu. Po aktualizacji będzie jedynym sposobem, by ustalić, co przestało działać. 

4. Sprawdzenie zgodności dodatków z wersją docelową. Przy modułach z Addons widać to na stronie produktu, przy dedykowanych trzeba zapytać autora. Jeśli jakiś dodatek jest niezbędny do sprzedaży i nie obsługuje nowej wersji, aktualizacja przesuwa się do czasu, gdy pojawi się zamiennik. 

5. Wersja PHP. Nowsze generacje PrestaShop wymagają nowszego PHP i to najczęstsza przyczyna zatrzymania procesu na etapie kontroli wstępnej. Kolejność jest ważna: najpierw PHP na hostingu, potem sklep. 

Warto też zajrzeć do noty wydawniczej wersji docelowej – gdzie szukać wydań i komunikatów o bezpieczeństwie, opisaliśmy w tekście o dokumentacji PrestaShop. 

Upgrade PrestaShop krok po kroku 

Przebieg w panelu jest liniowy i moduł prowadzi za rękę. Poniżej to, co dzieje się na każdym etapie, i moment, w którym najczęściej trzeba interweniować. 

Instalacja i kontrola wstępna. Po instalacji modułu zobaczysz listę warunków: wersja PHP, uprawnienia do katalogów, wyłączony tryb sklepu w budowie, wolne miejsce na dysku. Dopóki któryś punkt świeci się na czerwono, przycisk aktualizacji jest zablokowany. To dobra wiadomość – ta lista wyłapuje większość problemów, zanim cokolwiek się zmieni. 

Wybór wersji docelowej. Możesz wskazać najnowsze wydanie albo wgrać konkretną paczkę z dysku. Ta druga opcja bywa istotniejsza, niż wygląda: jeśli testowaliście upgrade na środowisku testowym do wersji X, a w tym czasie wyszła X+1, chcecie na produkcji dokładnie tę wersję, którą przetestowaliście. 

Kopia zapasowa i podmiana plików. Moduł archiwizuje pliki oraz bazę i zaczyna wymieniać rdzeń. Sklep przechodzi w tryb serwisowy. Tu proces jest najbardziej wrażliwy na limity serwera – nie zamykaj karty przeglądarki. 

Migracja bazy danych. Uruchamiają się skrypty dopisujące nowe tabele i kolumny. Najdłuższy etap przy dużych katalogach i ten, na którym najczęściej kończy się czas wykonania skryptu. 

Po zakończeniu. Wyczyść pamięć podręczną, przebuduj pliki motywu, przejdź przez panel i sprawdź, które moduły moduł wyłączył podczas aktualizacji. Lista wyłączonych dodatków to pierwsze miejsce, do którego zaglądamy. 

Wersja z linii poleceń. Przy sklepie z dużą bazą uruchomienie modułu z konsoli jest pewniejsze, bo proces nie zależy od limitu czasu żądania HTTP ani od otwartej karty przeglądarki. Jeśli macie dostęp SSH, to droga, którą sami wybieramy przy większych wdrożeniach.

Co robić, gdy PrestaShop update się zatrzyma 

Cztery sytuacje, które widzimy najczęściej, i pierwszy ruch w każdej z nich. 

Jeśli sklep jest niedostępny dla klientów, kolejność jest jedna: najpierw przywróć kopię i postaw sprzedaż na nogi, potem szukaj przyczyny na środowisku testowym. Diagnozowanie na żywym sklepie kosztuje więcej niż stracony dzień na aktualizację. W trudniejszych przypadkach zajmuje się tym nasze wsparcie techniczne PrestaShop. 

Kiedy automat nie wystarczy – dwie inne drogi 

Przy mocno przebudowanym sklepie sam moduł czasem nie domyka sprawy. Wtedy zostają dwa podejścia i oba stosujemy w praktyce. 

Aktualizacja ręczna 

Podmiana plików rdzenia i uruchomienie migracji bazy krok po kroku, z pełną kontrolą nad tym, co jest nadpisywane. Sensowna, gdy sklep ma nadpisania w rdzeniu i trzeba je rozstrzygać ręcznie, plik po pliku. Wymaga zaplecza technicznego, więc nie proponujemy jej osobie, która aktualizuje sklep sama. 

Nowa instalacja i przeniesienie danych 

Czysta instalacja najnowszej wersji, nowy motyw, aktualne moduły – a do tego import produktów, klientów i zamówień. Droższe od aktualizacji, ale przy sklepie zbudowanym na przestarzałej wersji często wychodzi taniej niż łatanie starego środowiska. Zaletą jest sklep bez odziedziczonych nadpisań; kosztem – konieczność odtworzenia ustawień, które nigdzie nie były opisane. 

Którą drogę wybrać, rozstrzyga się po przejrzeniu sklepu, nie z góry. Jak wygląda to u nas i co dostajecie w raporcie, opisujemy na stronie aktualizacja PrestaShop. 

Lista kontrolna po aktualizacji 

Sklep, który się otwiera, to jeszcze nie sklep, który sprzedaje. Zanim uznasz aktualizację za zakończoną, przejdź te osiem punktów – w tej kolejności. 

1. złóż zamówienie testowe i przejdź całą kasę do potwierdzenia 

2. sprawdź, czy przychodzą maile transakcyjne – do klienta i do sklepu 

3. przetestuj każdą metodę płatności osobno, także tę używaną najrzadziej 

4. sprawdź metody dostawy, koszty i progi darmowej wysyłki 

5. zweryfikuj ceny i stany kilku produktów, zwłaszcza jeśli macie integrację z ERP 

6. przejrzyj listę wyłączonych modułów i włączaj je pojedynczo 

7. sprawdź wystawianie dokumentów i eksport zamówień 

8. zajrzyj do logów błędów po pierwszym dniu ruchu – część problemów widać dopiero wtedy 

Pytania o upgrade PrestaShop, które dostajemy najczęściej 

Siedem pytań, do oznaczenia schematem FAQPage. 

Gdzie znajdę moduł 1-Click Upgrade w nowszym PrestaShopie? 

Szukaj nazwy Update Assistant – to ten sam moduł, o nazwie technicznej Autoupgrade. Pobierzesz go z Addons, z katalogu modułów w panelu albo z repozytorium projektu na GitHubie. Instaluje się jak każdy inny dodatek. 

Czy stracę dane podczas aktualizacji? 

Produkty, klienci i zamówienia zostają – migracja bazy je zachowuje. Ryzyko dotyczy ustawień modułów i motywu, które mogą się rozjechać, jeśli dodatek nie obsługuje nowej wersji. Dlatego kopia przed startem jest obowiązkowa, a nie zalecana. 

Ile trwa upgrade PrestaShop? 

Sam przebieg modułu to zwykle kwestia kilkudziesięciu minut, przy dużej bazie dłużej. Realny czas projektu wyznacza jednak co innego: przygotowanie, testy na środowisku testowym i doprowadzenie modułów do zgodności. Przy sklepie średniej wielkości liczymy 15 dni roboczych. 

Czy da się cofnąć nieudaną aktualizację? 

Tak, moduł umożliwia przywrócenie kopii wykonanej przed aktualizacją – plików i bazy. Warunek: kopia musiała się poprawnie wykonać, więc po jej utworzeniu warto sprawdzić rozmiar archiwum, zanim ruszy dalszy proces. 

Czy mogę przejść z 1.7 wprost na PrestaShop 9? 

Duże przejścia robi się etapami, a przy skoku o dwie generacje trzeba liczyć się z tym, że część modułów napisanych pod 1.7 nie będzie działać w dziewiątce – zmieniła się warstwa techniczna, nie tylko panel. W takich przypadkach porównujemy koszt aktualizacji z kosztem czystej instalacji, zanim cokolwiek ruszymy. 

Czy potrzebuję środowiska testowego? 

Przy sklepie, który zarabia – tak, bez wyjątku. Aktualizacja klikana od razu na produkcji zwykle kończy się dobrze, ale gdy skończy się źle, sprzedaż stoi, a wy szukacie przyczyny pod presją. Kopia sklepu na osobnej domenie kosztuje kilkadziesiąt złotych miesięcznie. 

Czy aktualizacja wpłynie na pozycje sklepu w Google? 

Sama zmiana wersji nie, o ile adresy zostają bez zmian. Problem pojawia się, gdy przy okazji zmienia się motyw i struktura adresów albo gdy sklep był długo niedostępny. Przy przebudowie z aktualizacją pilnujemy przekierowań i porównujemy widoczność przed i po. 

Upgrade przechodzi gładko, gdy moduły sprawdzisz przed nim, nie po 

Update Assistant robi swoją część dobrze i w większości sklepów wystarcza. Cała trudność aktualizacji leży poza modułem: w zgodności dodatków, w wersji PHP na hostingu i w tym, czy ktoś przeszedł przez kasę po zakończeniu procesu. Sklepy, przy których to sprawdzono zawczasu, aktualizują się bez historii do opowiadania. 

Aktualizujemy sklepy na PrestaShop od 2018, w wersjach od 1.6 do 9, także te z integracjami do systemów ERP i z dedykowanymi modułami. Jeśli twój sklep stoi na starszej wersji i nie wiesz, czy przejdzie aktualizację, napisz, jaką masz wersję PrestaShop i PHP oraz ile modułów jest w panelu. Odpowiemy, co da się zaktualizować automatem, co wymaga ręcznej pracy i ile to zajmie – w ciągu dwóch dni roboczych.