Instalacja modułu PrestaShop z paczki ZIP: krok po kroku i co robić przy błędzie
Instalacja modułu PrestaShop z paczki ZIP to trzy kliknięcia w Moduły → Menedżer modułów: przycisk załadowania modułu, wybór pliku i konfiguracja. Gdy pojawia się błąd, zwykle winna jest budowa paczki, limit wielkości pliku na serwerze albo wersja modułu niezgodna ze sklepem. Przed instalacją zrób kopię sklepu i sprawdź źródło paczki.
Autor: Zespół TellMyShop. Poradnik dla właścicieli sklepów PrestaShop: przyczyna, ręczna naprawa i to samo w rozmowie z czatem.
Aktualizacja: · 5 min czytania
Co sprawdzić przed instalacją modułu?
Moduł to kod, który działa na twoim serwerze i ma dostęp do bazy sklepu. Pięć minut sprawdzania przed instalacją jest tańsze niż naprawa po niej.
- Źródło. Pobieraj moduł od autora, z Addons albo z oficjalnego wydania na GitHubie. Darmowe kopie płatnych modułów z przypadkowych stron to częsta droga złośliwego kodu do sklepu.
- Zgodność z wersją sklepu. Opis modułu podaje wersje PrestaShop i PHP, na których działa. Wersję swojego sklepu widzisz w Zaawansowane → Informacje.
- Czy nie masz już modułu, który robi to samo. Dwa moduły opinii albo dwa moduły dostawy to częsta przyczyna konfliktów.
- Kopia. Kopia plików i bazy u hostingu albo w module kopii. Bez niej każda pomyłka jest kosztowna.
- Pora. Instaluj, gdy w sklepie jest mały ruch. Moduły płatności i dostawy najpierw na kopii testowej.
Jak zainstalować moduł z paczki ZIP?
Panel PrestaShop 8 i 9 ma do tego formularz w Menedżerze modułów. Ogólny opis ekranu modułów jest w instrukcji PrestaShop o modułach.
- Wejdź w Moduły → Menedżer modułów.
- Kliknij przycisk załadowania modułu na górze strony.
- Przeciągnij plik ZIP do okienka albo wybierz go z dysku. Nie rozpakowuj go wcześniej.
- Poczekaj na komunikat o instalacji. Przy większych modułach trwa to kilkadziesiąt sekund.
- Kliknij Konfiguruj i ustaw moduł według instrukcji autora.
- Otwórz sklep w oknie prywatnym. Sprawdź stronę główną, kartę produktu i koszyk.
- Zajrzyj do Zaawansowane → Logi, czy po instalacji nie pojawiły się nowe błędy.
Aktualizacja z ZIP wygląda tak samo: wgrywasz nowszą wersję tego samego modułu. PrestaShop rozpozna, że moduł już jest, podmieni pliki i uruchomi skrypty aktualizacji.
Na co uważać przy aktualizacji modułu?
Aktualizacja to więcej niż podmiana plików. Nowa wersja może zmienić tabele w bazie, dodać nowe miejsca na stronie albo zmienić domyślne ustawienia.
- Przeczytaj listę zmian autora. Szukaj zdań o wymaganej wersji PHP, nowych ustawieniach i zmianach w szablonach.
- Sprawdź, czy motyw ma kopię szablonu modułu. Jeśli tak, nowa wersja modułu może wyglądać inaczej niż w opisie autora albo wcale nie pokazać nowych elementów.
- Moduły płatności i dostawy aktualizuj poza godzinami zakupów. Po aktualizacji złóż zamówienie testowe.
- Nie przeskakuj wielu wersji naraz bez kopii. Skrypty aktualizacji bywają pisane z myślą o wersji poprzedniej.
Najczęstsze błędy przy instalacji modułu
| Komunikat albo objaw | Przyczyna | Co zrobić |
|---|---|---|
| moduł jest nieprawidłowy albo paczka nie wygląda na moduł | w ZIP-ie nie ma folderu modułu z plikiem o tej samej nazwie | rozpakuj na komputerze; w środku ma być jeden folder, np. mojmodul/mojmodul.php |
| ten sam błąd przy paczce z Addons | pobrany ZIP zawiera moduł, dokumentację i licencję w jednym archiwum | rozpakuj i wgraj tylko wewnętrzny ZIP modułu |
| ładowanie kończy się błędem bez opisu | plik większy niż limit wysyłki na serwerze | podnieś limit u hostingu albo wgraj moduł przez FTP |
| moduł nie jest zgodny z wersją sklepu | autor ustawił w module zakres wersji PrestaShop | pobierz wersję modułu dla swojego PrestaShop |
| biała strona albo błąd 500 po instalacji | moduł wymaga innej wersji PHP albo koliduje z innym modułem | wyłącz moduł, przeczytaj dziennik błędów |
| brak uprawnień do zapisu | serwer nie pozwala zapisywać w katalogu modułów | poproś hosting o poprawne uprawnienia katalogu |
Budowę poprawnej paczki opisuje dokumentacja PrestaShop o strukturze modułu: folder modułu ma tę samą nazwę co moduł, a moduł w ZIP-ie musi być w podfolderze. Problem ze zbyt dużymi paczkami twórcy PrestaShop opisali w specyfikacji komunikatów Menedżera modułów, razem z ustawieniami PHP, które za niego odpowiadają.
Gdy po instalacji sklep się nie wyświetla, zacznij od tekstu o błędzie 500 w PrestaShop. Jeśli moduł działa, ale coś psuje, wyłącz go zamiast odinstalowywać, jak opisujemy w tekście o wyłączeniu modułu.
Jak zainstalować albo zaktualizować moduł przez czat?
Dajesz swojemu czatowi (Claude albo ChatGPT) bezpośredni link https do pliku ZIP, na przykład do wydania na GitHubie albo do pliku od autora. Czat najpierw pobiera paczkę do podglądu i sprawdza ją, zanim cokolwiek trafi do sklepu: nazwę i wersję modułu, źródło, sumę kontrolną SHA-256 i budowę paczki. Pliku z twojego dysku tą drogą nie wgrasz, potrzebny jest link.
Ty: Zaktualizuj moduł płatności do 2.4.1 z tego linku do wydania na GitHubie. Sprawdź sklep przed i po.
Twój czat: Podgląd paczki: moduł płatności, wersja zainstalowana 2.3.0, w paczce 2.4.1. Źródło: wydanie autora na GitHubie. Budowa poprawna, jeden folder modułu. Suma SHA-256 jest w podglądzie, możesz ją porównać z podaną przez autora.
Przed aktualizacją zrobię kopię plików modułu. Zmian w bazie, które zrobi skrypt aktualizacji, nie cofnę z historii; od tego jest dzisiejsza kopia bazy. Teraz dziennik nie ma błędów z tego modułu. Zaktualizować?
Ty: Tak.
Twój czat: Zaktualizowane do 2.4.1. Koszyk i strona zamówienia odpowiadają poprawnie, w dzienniku brak nowych błędów.
Stan kartki: czeka na twoje „tak”stara wersja: wersja 2.3.0
nowa wersja: wersja 2.4.1
Numery wersji w przykładzie są przykładowe. Przykład prośby jest w zastosowaniu instalacja albo aktualizacja modułu z paczki ZIP, a gdy po zmianie coś przestanie działać, w zastosowaniu wyłączenie modułu, który psuje koszyk.
Instalację i aktualizację robi TellMyShop Pro po włączeniu przełącznika Moduły w panelu modułu. Przełącznik działa 24 godziny i wymaga kopii bazy zrobionej tego samego dnia. Czat nie instaluje niczego bez podglądu i twojej zgody, a moduł z niepewnego źródła odradzi. Odinstalowania modułu nie da się cofnąć, dlatego czat najpierw proponuje wyłączenie. W darmowej wersji TellMyShop Free zobaczysz listę modułów z wersjami i miejscami, w których się wyświetlają. Porównanie wersji jest w cenniku, a porządki po starych modułach opisujemy w tekście o zbędnych modułach.
Pytania i odpowiedzi
Gdzie w PrestaShop zainstalować moduł z pliku ZIP?
W menu Moduły, w Menedżerze modułów. Na górze strony jest przycisk do załadowania modułu, w który przeciągasz plik ZIP albo wybierasz go z dysku. Po załadowaniu PrestaShop instaluje moduł i proponuje jego konfigurację.
Co znaczy komunikat, że moduł jest nieprawidłowy?
Najczęściej PrestaShop nie znalazł w paczce folderu modułu z plikiem o tej samej nazwie. Bywa, że pobrałeś paczkę z dokumentacją zamiast modułu, archiwum z kilkoma modułami w środku albo ZIP spakowany w kolejnym ZIP-ie. Rozpakuj paczkę na komputerze i sprawdź, co jest w środku.
Czy aktualizacja modułu z ZIP usuwa jego ustawienia?
Zwykle nie. Gdy wgrasz nowszą wersję tego samego modułu, PrestaShop podmienia pliki i uruchamia skrypty aktualizacji modułu. Ustawienia zostają, ale skrypty mogą zmienić bazę danych. Dlatego przed aktualizacją zrób kopię sklepu i najlepiej sprawdź ją na kopii testowej.
Czy można cofnąć instalację modułu?
Nowy moduł możesz wyłączyć albo odinstalować. Odinstalowanie zwykle usuwa jego dane i ustawienia, więc tego się nie cofa. Przy aktualizacji pliki da się przywrócić z kopii, ale zmian w bazie zrobionych przez skrypt aktualizacji nie cofniesz bez kopii bazy.
Czy TellMyShop Free zainstaluje moduł?
Nie. Darmowa wersja TellMyShop Free tylko czyta raporty sklepu, w tym listę modułów z wersjami. Instalację i aktualizację z paczki ZIP robi TellMyShop Pro po włączeniu przełącznika Moduły na 24 godziny.
PrestaShop jest zastrzeżonym znakiem towarowym PrestaShop SA. Claude jest znakiem towarowym Anthropic PBC. ChatGPT i OpenAI są znakami towarowymi OpenAI. TellMyShop nie jest powiązany z tymi firmami.