# Zainstaluj moduł PrestaShop

> Zainstaluj i skonfiguruj moduł DataFirefly Server-Side w PrestaShop 1.7.6 i nowszych: wgranie pliku zip, klucz połączenia, zgoda tarteaucitron, zdarzenie testowe.

- Strona oryginalna: https://server-side.datafirefly.com/pl/docs/prestashop.html
- Język: pl
- Zaktualizowano: 2026-09-05
- Wydawca: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/pl/

---

Zgodny z PrestaShop 1.7.6 i nowszymi wersjami. Instalacja w 5 minut z poziomu menedżera modułów. Nieudana wysyłka trafia do kolejki i jest ponawiana, zaczynając od zakupów: chwilowa awaria nic nie kosztuje.

## Wymagania

- PrestaShop 1.7.6 lub nowszy.
- Plik zip modułu, do pobrania ze strony [**Modules**](https://admin.datafirefly.com/app/connectors) Twojego panelu klienta.
- [Klucz połączenia Twojej witryny](https://server-side.datafirefly.com/pl/docs/connect-your-site.html).

## Instalacja

1. Back office PrestaShop: **Moduły > Menedżer modułów > Wgraj moduł**.
2. Wyślij plik zip w całości, bez rozpakowywania.
3. Kliknij **Konfiguruj**.

## Konfiguracja

1. Uzupełnij **Tenant ID**, **HMAC secret** i **Events endpoint**: trzy wartości ze strony Twojej witryny w DataFirefly.
2. Opcja **Require consent**: moduł przepuszcza zdarzenie dopiero wtedy, gdy odwiedzający zaakceptował reklamy. Rozpoznaje samodzielnie, bez konfiguracji: tarteaucitron, DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, w przeglądarce i na serwerze, ta sama lista co w modułach WooCommerce i Shopware. Zalecane, jeśli sklep ma baner zgody.
3. Przełącz **Enable tracking** na Yes: domyślnie jest wyłączony.
4. Zapisz, a następnie kliknij **Send test event**.

Nie masz jeszcze banera zgody w swoim sklepie? Moduł [Cookie Manager dla PrestaShop](https://www.datafirefly.com/product/cookie-manager-tarteaucitron-conformite-rgpd-cle-en-main-pour-prestashop/) instaluje gotowy do użycia tarteaucitron z Consent Mode v2.

## Weryfikacja

1. Zdarzenie testowe musi pojawić się ze statusem **Delivered** w Monitoringu Twojego panelu klienta.
2. Złóż zamówienie testowe: moduł wysyła zakupy przy zatwierdzeniu zamówienia.

## Kolejka ponownych wysyłek

Dotyczy wersji 1.29.0 i nowszych.

- Nieudana wysyłka trafia do kolejki i jest ponawiana przy kolejnych wizytach w sklepie: najwyżej co 30 sekund, nigdy dwa ponowienia naraz, w paczkach do 20 zdarzeń wysyłanych równolegle.
- Sklep z małym ruchem: opcjonalny adres URL crona, chroniony tokenem i dostępny wyłącznie przez https, uruchamia ponowienie bez czekania na wizytę.
- Najpierw idą zakupy i zwroty, potem najnowsze zdarzenia.
- Zdarzenie opuszcza kolejkę dopiero wtedy, gdy ma ponad 7 dni **i** czeka w niej dłużej niż 7 dni. Jest wtedy liczone jako wygasłe: nic nie znika bez śladu.
- Jeśli DataFirefly nie odpowiada (błąd sieci, HTTP 429 lub 5xx), sklep przez 60 sekund nie wysyła niczego bezpośrednio i od razu umieszcza zdarzenia w kolejce. Awaria po naszej stronie nigdy więc nie spowalnia sklepu ani procesu składania zamówienia. Ponawianie nadal próbuje, a gdy się powiedzie, wysyłka bezpośrednia zostaje wznowiona.
- Strona Twojej witryny w panelu klienta pokazuje stan tej kolejki. Stany opisuje strona [Rozwiązywanie problemów](https://server-side.datafirefly.com/pl/docs/troubleshooting.html).

## Gdy coś nie działa

- Logi: **Zaawansowane > Logi**, filtruj po prefiksie `[DataFirefly SS]`.
- Jeśli używasz wersji modułu starszej niż 1.8.0, zaktualizuj go: nowsze wersje naprawiają możliwe podwójne zliczanie zakupów w GA4.
- Pozostałe częste przyczyny znajdziesz w [przewodniku rozwiązywania problemów](https://server-side.datafirefly.com/pl/docs/troubleshooting.html).

Aktualizacja: 1 września 2026
