# Zainstaluj wtyczkę WooCommerce

> Zainstaluj i skonfiguruj wtyczkę DataFirefly Server-Side w WooCommerce: klucz połączenia dfss\_, pełny lejek zakupowy, deduplikacja zamówień, obsługiwane CMP.

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

---

Pełny lejek zakupowy, od widoku produktu do zakupu, z automatyczną deduplikacją i kolejką ponownych wysyłek. Zgodna z HPOS.

## Wymagania

- WordPress 5.8+, WooCommerce 5.0+, PHP 7.4+. Zgodna z HPOS.
- Plik zip wtyczki, 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. Panel administracyjny WordPress: **Plugins > Add New > Upload Plugin**.
2. Wyślij plik zip, a następnie kliknij **Activate**.

## Konfiguracja

1. Otwórz **Settings > DataFirefly Server-Side**.
2. Wklej klucz połączenia `dfss_...` i kliknij **Connect**: przycisk włącza pełny tracking oraz opcję zgody i od razu wysyła zdarzenie testowe.

Wtyczka automatycznie wykrywa następujące narzędzia zgody, bez konfiguracji: WP Consent API, Complianz, DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, tarteaucitron. Moduły PrestaShop i Shopware używają tego samego wykrywania: narzędzie rozpoznane tutaj jest rozpoznane wszędzie.

## Co obejmuje wtyczka

- Cały lejek zakupowy: nawigacja, widok produktu, koszyk, checkout, zakup.
- Deduplikacja po identyfikatorze zamówienia: żadnego podwójnego zliczania między przeglądarką a serwerem.
- Automatyczna kolejka ponownych wysyłek: nieudane wysyłki są ponawiane, najpierw zakupy (szczegóły niżej).
- Panel **DataFirefly Activity** w panelu administracyjnym pokazuje ostatnio wysłane zdarzenia.

## Weryfikacja

1. Zdarzenie testowe musi pojawić się ze statusem **Delivered** w Monitoringu Twojego panelu klienta.
2. Złóż zamówienie testowe i odszukaj je w panelu DataFirefly Activity.

## Kolejka ponownych wysyłek

Dotyczy wersji 2.30.0 i nowszych.

- Nieudana wysyłka trafia do kolejki i jest ponawiana co 5 minut przez WP-Cron.
- 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

- Po każdej zmianie konfiguracji **wyczyść cache** swojej witryny: inaczej LiteSpeed Cache i podobne wtyczki nadal serwują stary JavaScript.
- Jeśli używasz wersji wtyczki starszej niż 2.8.0, zaktualizuj ją: 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
