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. Piszemy o PrestaShop na podstawie pracy z zapleczem prawdziwych sklepów i testów na własnym sklepie testowym.
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ł z Claude?
Dajesz Claude'owi bezpośredni link https do pliku ZIP, na przykład do wydania na GitHubie albo do pliku od autora. Claude 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.
Zaktualizuj moduł płatności do 2.4.1 z tego linku do wydania na GitHubie. Sprawdź sklep przed i po.
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.
było: wersja 2.3.0
będzie: wersja 2.4.1
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ć?
Tak.
Zaktualizowane do 2.4.1. Koszyk i strona zamówienia odpowiadają poprawnie, w dzienniku brak nowych błędów.
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. Claude 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 Claude 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. TellMyShop nie jest powiązany z żadną z tych firm.