Instalacja modułu PrestaShop wygląda w teorii prosto. W praktyce, między modułami pobranymi ze sklepu addons, kupionymi na zewnętrznych marketplace’ach, tworzonymi wewnętrznie oraz specyficznymi ograniczeniami multisklepu, szybko trafiasz na przypadki brzegowe. Ten przewodnik omawia trzy prawidłowe metody instalacji w 2026 roku, najczęstsze błędy oraz dobre praktyki, dzięki którym nie zepsujesz sklepu działającego na produkcji.
Zanim zaczniesz: wykonaj kopię zapasową sklepu
Ten krok nie podlega negocjacjom. Przed dodaniem jakiegokolwiek modułu do sklepu produkcyjnego musisz dysponować świeżą kopią zapasową bazy danych oraz plików. Jeśli korzystasz z poważnego hostingu (o2switch, OVH, Cloudways), automatyczna kopia dobowa już istnieje. Sprawdź, czy jest aktualna i czy da się ją odtworzyć.
Idealne podejście to testowanie na środowisku przedprodukcyjnym identycznym z produkcją, a następnie powtórzenie instalacji. Jeśli nie masz stagingu, szybki eksport bazy przez wbudowane narzędzie PrestaShop jest lepszy niż nic.
Metoda 1: instalacja przez zaplecze
To metoda najczęstsza i najbezpieczniejsza. Działa dla każdego modułu dostarczanego w postaci pliku ZIP, niezależnie od tego, czy pochodzi z oficjalnego sklepu addons, z zewnętrznego marketplace’u czy od niezależnego dewelopera.
- Zaloguj się do zaplecza PrestaShop
- Przejdź do Moduły → Menedżer modułów
- Kliknij Wgraj moduł (prawy górny róg)
- Przeciągnij plik ZIP do pola zrzutu albo kliknij, aby go wybrać
- Poczekaj na komunikat potwierdzający
- Kliknij Konfiguruj, aby wejść w ustawienia modułu
Jeśli wysyłka kończy się błędem o rozmiarze pliku, Twoje dyrektywy PHP są zbyt restrykcyjne. Trzeba podnieść upload_max_filesize, post_max_size oraz memory_limit w pliku php.ini lub przez .htaccess w katalogu głównym PrestaShop. Rozsądne wartości: 64M dla dwóch pierwszych, 256M dla pamięci.
Przypadek szczególny: moduł zablokowany przez PrestaShop Marketplace
Jeśli kupiłeś moduł na addons.prestashop.com, plik ZIP bywa chroniony podpisem wymagającym zalogowania do konta PrestaShop. W takiej sytuacji instalacja musi przebiegać przez Moduły → Wybór i przycisk instalacji powiązany z Twoim zakupem. To działanie celowe: PrestaShop blokuje w ten sposób nieautoryzowaną redystrybucję.
Metoda 2: instalacja przez FTP
Ta metoda przydaje się w dwóch przypadkach: plik ZIP jest zbyt duży wobec limitów PHP Twojego hostingu albo instalujesz kilka modułów naraz i chcesz działać szybciej.
- Rozpakuj ZIP modułu na swoim komputerze
- Powinieneś otrzymać katalog o nazwie modułu (na przykład
mojmodul/) - Wgraj ten katalog do
/modules/w katalogu głównym PrestaShop przez FTP lub SFTP - Wróć do Moduły → Menedżer modułów
- Znajdź moduł na liście i kliknij Zainstaluj
Uwaga: nie rozpakowuj w katalogu głównym PrestaShop archiwum, które zawiera już ścieżkę /modules/mojmodul/. Ryzykujesz nadpisanie istniejących plików. Zawsze sprawdzaj strukturę archiwum przed wypakowaniem.
Alternatywa: Explorer FTP bezpośrednio w zapleczu
Jeśli korzystasz z modułu Explorer FTP, możesz wgrywać pliki modułów prosto z zaplecza, bez zewnętrznego klienta FTP. Wygodne, gdy pracujesz mobilnie albo nie masz dostępu do FileZilli.
Metoda 3: instalacja przez Composer (PrestaShop 9)
Ta metoda dotyczy wyłącznie nowoczesnych modułów budowanych zgodnie ze standardami Symfony, na razie głównie modułów oficjalnych i części modułów deweloperskich. Composer pobiera moduł i jego zależności PHP automatycznie.
cd /sciezka/do/prestashop
composer require prestashop/module-nameNastępnie aktywujesz go w zapleczu jak zwykły moduł. Oficjalna dokumentacja PrestaShop wymienia moduły zgodne z Composerem. Dla modułów zewnętrznych (marketplace’y, niezależni deweloperzy) normą pozostaje metoda 1.
Konfiguracja modułu po instalacji
Po instalacji moduł pozostaje nieaktywny, dopóki go nie skonfigurujesz. Kliknij Konfiguruj obok nazwy modułu, aby wejść w jego ustawienia.
Poważne moduły dostarczają czytelną stronę konfiguracji z kluczowymi parametrami. Moduły amatorskie zostawiają Cię sam na sam z plikiem config.xml do ręcznej edycji, co jest sygnałem ostrzegawczym.
Wiele modułów wymaga też aktywacji jednego lub kilku hooków. Hook to punkt zaczepienia na stronie, w który moduł wstrzykuje swoją treść. Na przykład moduł slidera musi podpiąć się pod hook displayHome, żeby pojawić się na stronie głównej. Sprawdź w Moduły → Pozycje, czy oczekiwane hooki są aktywne.
Testy na środowisku staging
W sklepie o dużym ruchu nigdy nie instaluj bezpośrednio na produkcji. Kolejność, której warto się trzymać:
- Zduplikuj sklep na środowisko przedprodukcyjne (te same wersje PrestaShop, PHP, MySQL)
- Zainstaluj moduł na stagingu
- Przez 24 do 48 godzin testuj ścieżki krytyczne: dodanie do koszyka, pełny checkout, płatność, multisklep jeśli dotyczy
- Sprawdź logi (Symfony, Apache, PHP). Moduł potrafi działać na powierzchni, a jednocześnie po cichu generować błędy w tle
- Jeśli wszystko jest na zielono, powtórz instalację na produkcji poza godzinami szczytu
Najczęstsze błędy i ich rozwiązania
„Moduł nie pojawia się na liście”
Trzy możliwe przyczyny: archiwum zostało rozpakowane do złego katalogu (sprawdź, czy jest w /modules/nazwamodulu/), uprawnienia plików są nieprawidłowe (pliki PHP powinny mieć 644, katalogi 755) albo cache zaplecza jest nieaktualny. Aby wyczyścić cache, przejdź do Parametry zaawansowane → Wydajność i kliknij Wyczyść cache.
„Błąd 500 po aktywacji”
Moduł jest prawdopodobnie niezgodny z Twoją wersją PrestaShop lub PHP. Wyłącz go, usuwając katalog modułu przez FTP, a następnie sprawdź wersje na jego karcie produktu. Zgodność PrestaShop 1.7 wobec 8 to źródło niezgodności numer jeden.
„Moduł działa, ale się nie wyświetla”
Hook nie został aktywowany. Przejdź do Moduły → Pozycje, znajdź moduł na liście i sprawdź podpięte hooki. Jeśli nic nie jest zaznaczone, podepnij go pod hooki zalecane w jego dokumentacji.
„Konflikt z innym modułem”
Typowy objaw: moduł działa samodzielnie, ale psuje się po włączeniu drugiego. Rozwiązanie prowadzi przez logi Symfony (w var/logs/) oraz naprzemienne wyłączanie w celu wskazania winowajcy. Najczęstsze konflikty dotyczą modułów modyfikujących te same hooki lub te same szablony.
Dobre praktyki po instalacji
Gdy moduł jest już zainstalowany i skonfigurowany, dwa odruchy:
- Dokumentuj: prowadź plik z listą zainstalowanych modułów, ich wersji i licencji. Przy migracji albo zgłoszeniu do wsparcia oszczędzisz godziny.
- Aktualizuj regularnie: większość udokumentowanych luk bezpieczeństwa PrestaShop pochodzi z przestarzałych modułów zewnętrznych. Włącz powiadomienia o aktualizacjach w Moduły → Powiadomienia.
A co dalej?
Aby pójść dalej, przejrzyj nasz katalog modułów PrestaShop 8 według kategorii: SEO, checkout, marketing i więcej. Każdy moduł DataFirefly dostarczamy ze szczegółową dokumentacją instalacji i wsparciem technicznym.
Gdy moduł jest już zainstalowany: wszystkie nasze zestawienia modułów PrestaShop według celu.
