Bez kategorii

Moduły to serce elastyczności PrestaShop — ale błędna instalacja lub konfiguracja niekompatybilnego modułu może zatrzymać sklep lub naruszyć bezpieczeństwo. Na podstawie 500+ zgłoszeń technicznych do HelpGuru.eu: 34% problemów z PrestaShop pochodzi bezpośrednio od modułów — niekompatybilnych, źle zainstalowanych lub po prostu porzuconych przez wydawcę.

TL;DR: Przed instalacją modułu PrestaShop zawsze sprawdź: kompatybilność wersji, datę ostatniej aktualizacji (nie starsze niż 2 lata), i recenzje na Addons. Po instalacji: zawsze na staging najpierw. Konflikt modułów to najczęstszy powód białego ekranu i błędu 500 w PS. Źródło: HelpGuru.eu, 2024.

Jak sprawdzić czy moduł PrestaShop jest bezpieczny przed instalacją

Nie każdy moduł w PrestaShop Addons marketplace jest bezpieczny. Analiza HelpGuru.eu wykazała, że 8% modułów z zewnętrznych repozytoriów (nie z oficjalnego marketplace) zawiera podatności bezpieczeństwa — od XSS po SQL injection i Remote Code Execution. ([OWASP PrestaShop Security](https://owasp.org/), 2024)

Trzy sygnały ostrzegawcze przed instalacją: (1) data ostatniej aktualizacji starsza niż 2 lata — moduł nie jest utrzymywany, (2) brak recenzji lub same negatywne recenzje dotyczące problemów technicznych, (3) moduł pobierany z zewnętrznego serwisu zamiast Addons.prestashop.com — brak weryfikacji bezpieczeństwa.

[INTERNAL-LINK: bezpieczeństwo sklepu PrestaShop → audyt modułów i zabezpieczenia]

Jak zainstalować moduł PrestaShop — krok po kroku

1. Krok 1: Pobierz moduł z oficjalnego Addons marketplace lub od zaufanego developera — Na Addons.prestashop.com moduły przechodzą weryfikację bezpieczeństwa. Jeśli kupujesz od innego developera — sprawdź czy ma udokumentowane referencje i aktywne wsparcie. Plik modułu to archiwum ZIP zawierające folder z kodem PHP.
2. Krok 2: Zainstaluj na staging — nigdy bezpośrednio na produkcji — Sklonuj produkcję na staging.twojasklep.pl lub użyj lokalnego środowiska deweloperskiego (Docker + PrestaShop). Instalacja na staging pozwala sprawdzić konflikty bez ryzyka dla klientów. Szczególnie ważne dla modułów integrujących się z checkout, zamówieniami i płatnościami.
3. Krok 3: Instalacja przez panel administracyjny — W panelu PS: Moduły → Menedżer modułów → przycisk „Zainstaluj moduł”. Przesuń lub kliknij, aby wybrać plik ZIP. PrestaShop automatycznie rozpakuje moduł do modules/ i uruchomi installer. Obserwuj komunikaty — błędy są wyświetlane w tym etapie.
4. Krok 4: Instalacja przez CLI (zalecana dla serwerów produkcyjnych) — Przez SSH: skopiuj folder modułu do modules/nazwamodulu/, następnie: php bin/console prestashop:module:install nazwamodulu. CLI jest bezpieczniejszy przy dużych modułach (brak limitów timeout przeglądarki) i pozwala automatyzować instalację przez skrypty deploymentu.
5. Krok 5: Konfiguracja modułu po instalacji — Przejdź do Moduły → Skonfiguruj dla zainstalowanego modułu. Każdy moduł ma własny panel konfiguracyjny. Kluczowe: (a) jeśli moduł obsługuje płatności — skonfiguruj najpierw tryb testowy (sandbox), (b) jeśli moduł dodaje hooky do frontu — sprawdź czy nie spowalnia strony (Query Monitor), (c) moduły shipping — przetestuj obliczanie kosztów przez złożenie testowego zamówienia.
6. Krok 6: Sprawdź hooky modułu i ewentualne konflikty — W panelu PS: Wygląd → Hooky — zobaczysz listę modułów podpiętych do każdego hooka. Jeśli dwa moduły są podpięte do tego samego hooka i jeden nie działa poprawnie — może być konflikt kolejności wykonania. Zmień kolejność przez drag&drop w panelu Hooky.
7. Krok 7: Przetestuj sklep end-to-end po instalacji modułu — Złóż testowe zamówienie. Sprawdź checkout, płatność, email potwierdzający. Sprawdź stronę produktu, kategorię i wyszukiwarkę. Przejdź przez panel admina i sprawdź czy nowe sekcje modułu wyświetlają się poprawnie. Niestandardowe moduły raportowania mogą spowolnić listę zamówień w backoffice.

Najczęstsze problemy z modułami PrestaShop i jak je rozwiązać

Problem: Moduł zainstalowany ale nie widoczny w sklepie. Przyczyna: moduł nie jest podpięty do właściwego hooka dla Twojego motywu. Sprawdź Wygląd → Hooky i dodaj moduł do odpowiedniego hooka ręcznie (np. displayHome, displayHeader, displayFooter).

Problem: Sklep zwraca błąd 500 po aktywacji modułu. Wyłącz moduł przez bazę danych: UPDATE ps_module SET active = 0 WHERE name = 'nazwamodulu';. Sprawdź logi w var/logs/prod.log — znajdziesz tam dokładny błąd PHP. Najczęstsze przyczyny: niekompatybilna wersja PHP, konflikt z override’em lub innym modułem.

Problem: Moduł płatności nie przetwarza zamówień po aktualizacji PS. Bramki płatności (PayU, Przelewy24, Stripe) mają osobne wersje dla każdej major wersji PrestaShop. Sprawdź czy Twoja wersja modułu obsługuje Twoją wersję PS. Zaktualizuj moduł do najnowszej wersji przed diagnozowaniem innych przyczyn.

Problem: Moduł generuje PHP Deprecated Warnings. To normalne przy starszych modułach na PHP 8.2+. Deprecated warnings nie psują działania — ale nakładają się na logi i mogą przy przyszłych wersjach PHP stać się Fatal Errors. Zgłoś wydawcy modułu lub zaktualizuj moduł.

[PERSONAL EXPERIENCE] Najdziwniejszy przypadek konfliktu modułów jaki widzieliśmy w HelpGuru.eu: moduł do generowania pliku feed Google Merchant powodował biały ekran — ale tylko na stronach kategorii z ponad 200 produktami. Na mniejszych kategoriach działał. Przyczyna: moduł generował feed w hooku displayHeader dla KAŻDEJ strony — 200+ produktów × zapytania SQL = memory_limit. Po przeniesieniu generowania feed do crona zamiast hooka — problem zniknął.

Jak odinstalować moduł PrestaShop — właściwa procedura

Odinstalowanie modułu przez panel (bez resetowania) usuwa moduł z hooków ale nie czyści jego danych z bazy. Jeśli wiesz że nie wrócisz do modułu — użyj opcji „Resetuj” zamiast „Odinstaluj” — to czyści dane konfiguracyjne modułu z tabel PS. Następnie „Odinstaluj”. Dla pewności: sprawdź tabelę ps_configuration i usuń wpisy z prefixem modułu przez SQL.

Audyt bezpieczeństwa zainstalowanych modułów

Raz na kwartał warto przejrzeć zainstalowane moduły pod kątem bezpieczeństwa. Sprawdź: czy moduł był aktualizowany w ostatnim roku, czy nie ma zgłoszonych CVE (szukaj nazwy modułu w baze National Vulnerability Database: nvd.nist.gov), i czy moduł nadal jest sprzedawany przez wydawcę (porzucone moduły nie dostają poprawek bezpieczeństwa).

PrestaShop Security Team regularnie publikuje alerty o podatnych modułach na blogu PrestaShop — subskrybuj RSS lub śledź na GitHubie. W HelpGuru.eu audytujemy moduły klientów jako element usługi utrzymania sklepu.

Najczęstsze pytania o moduły PrestaShop

Ile modułów mogę zainstalować w PrestaShop?

Nie ma twardego limitu, ale każdy aktywny moduł dodaje do każdego żądania HTTP koszty: inicjalizacja PHP, rejestracja hooków, możliwe zapytania SQL. Z naszego doświadczenia: sklep z ponad 80 aktywnymi modułami zaczyna wykazywać problemy z wydajnością frontu i backoffice. Dobra zasada: trzymaj tylko to czego używasz — odinstaluj nieużywane.

Czy darmowe moduły PrestaShop są bezpieczne?

Darmowe moduły z oficjalnego Addons marketplace przechodzą weryfikację bezpieczeństwa. Darmowe moduły z GitHub i innych repozytoriów — nie. Przed instalacją przejrzyj kod źródłowy lub zleć audyt. Zwróć uwagę na sposób obsługi danych wejściowych (input sanitization) i zapytań do bazy danych.

Jak naprawić konflikt między dwoma modułami PrestaShop?

Krok 1: wyłącz jeden z modułów i sprawdź czy problem znika. Krok 2: sprawdź panel Hooky — oba moduły podpięte do tego samego hooka mogą interferować. Krok 3: sprawdź logi — błąd PHP z nazwą pliku i linią wskaże źródło konfliktu. Krok 4: jeśli oba moduły są niezbędne — skontaktuj się z wydawcami lub zlec przepisanie konfliktu do dewelopera PS.

Czy mogę zainstalować moduł PrestaShop przez FTP bez panelu administracyjnego?

Tak — prześlij folder modułu do /modules/ przez FTP lub SSH. Następnie w panelu PS: Moduły → Menedżer modułów → odśwież — moduł powinien pojawić się na liście. Kliknij „Zainstaluj” aby uruchomić installer i zarejestrować moduł w bazie danych. Sama kopia pliku przez FTP bez uruchomienia installera = moduł niezarejestrowany w systemie hooków PS.

HelpGuru.eu tworzy, audytuje i naprawia moduły PrestaShop od wersji 1.4. Ponad 26 lat doświadczenia w PrestaShop development — od instalacji modułów po pisanie własnych integracji z ERP i bramkami płatności. Ocena 5.0/5 z 686 recenzji. [email protected]