# Zainstaluj wtyczkę Shopware

> Zainstaluj i skonfiguruj wtyczkę DataFirefly Server-Side w Shopware 6.5, 6.6 i 6.7: wgranie rozszerzenia, klucz połączenia, cookie zgody, test w CLI.

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

---

Zgodna z Shopware 6.5, 6.6 i 6.7. Instalacja przez panel administracyjny lub z linii poleceń. Nieudana wysyłka trafia do kolejki i jest ponawiana co pięć minut przez własny harmonogram Shopware: chwilowa awaria nic nie kosztuje.

## Wymagania

- Shopware 6.5, 6.6 lub 6.7.
- 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 Shopware: **Extensions > My extensions > Upload extension**, następnie zainstaluj i aktywuj wtyczkę.
2. Albo w CLI: `bin/console plugin:install --activate DatafireflyServerSide`

## Konfiguracja

1. Otwórz konfigurację wtyczki i wklej klucz połączenia `dfss_...`.
2. Włącz **Enable tracking**.

Moduł sam rozpoznaje popularne narzędzia zgody (DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, tarteaucitron), w przeglądarce i na serwerze, ta sama lista co w modułach WooCommerce i PrestaShop. Proszę zostawić **Consent cookie name** puste, aby użyć tego automatycznego wykrywania; wypełnić je tylko po to, by wymusić konkretne cookie (na przykład `CookieConsent` i `marketing:true`), które wtedy ma pierwszeństwo.

## Weryfikacja

1. Uruchom `bin/console datafirefly:serverside:test`.
2. Zdarzenie testowe musi pojawić się ze statusem **Delivered** w Monitoringu Twojego panelu klienta.

## Kolejka ponownych wysyłek

Dotyczy wersji 1.23.0 i nowszych.

- Nieudana wysyłka trafia do kolejki i jest ponawiana co 5 minut przez zaplanowane zadanie Shopware.
- 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 w `var/log/`, prefiks `[DataFirefly SS]`.
- Jeśli używasz wersji wtyczki starszej niż 1.9.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
