# Instalace pluginu Shopware

> Instalace a konfigurace pluginu DataFirefly Server-Side na Shopware 6.5, 6.6 a 6.7: nahrání rozšíření, propojovací klíč, souhlasová cookie, test v CLI.

- Původní stránka: https://server-side.datafirefly.com/cs/docs/shopware.html
- Jazyk: cs
- Aktualizováno: 2026-09-05
- Vydavatel: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/cs/

---

Kompatibilní se Shopware 6.5, 6.6 a 6.7. Instalace přes administraci nebo příkazovou řádku. Neúspěšné odeslání se zařadí do fronty a každých pět minut se zopakuje vlastním plánovačem Shopware: krátký výpadek nic nestojí.

## Požadavky

- Shopware 6.5, 6.6 nebo 6.7.
- Zip pluginu, ke stažení na stránce [**Modules**](https://admin.datafirefly.com/app/connectors) vaší klientské sekce.
- [Propojovací klíč vašeho webu](https://server-side.datafirefly.com/cs/docs/connect-your-site.html).

## Instalace

1. Administrace Shopware: **Extensions > My extensions > Upload extension**, poté plugin nainstalujte a aktivujte.
2. Nebo v CLI: `bin/console plugin:install --activate DatafireflyServerSide`

## Konfigurace

1. Otevřete konfiguraci pluginu a vložte propojovací klíč `dfss_...`.
2. Zapněte **Enable tracking**.

Modul sám rozpozná běžné nástroje souhlasu (DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, tarteaucitron), v prohlížeči i na serveru, stejný seznam jako u modulů pro WooCommerce a PrestaShop. Nechte **Consent cookie name** prázdné pro toto automatické rozpoznání; vyplňte je jen tehdy, chcete-li vynutit konkrétní cookie (například `CookieConsent` a `marketing:true`), která pak má přednost.

## Ověření

1. Spusťte `bin/console datafirefly:serverside:test`.
2. Testovací událost se musí zobrazit jako **Delivered** v Monitoringu vaší klientské sekce.

## Fronta opakovaných odeslání

Platí od verze 1.23.0.

- Neúspěšné odeslání se zařadí do fronty a každých 5 minut se zopakuje naplánovanou úlohou Shopware.
- Nákupy a refundace mají přednost, po nich nejnovější události.
- Událost z fronty odejde, až když je starší než 7 dní **a** zároveň čeká déle než 7 dní. Pak se započítá jako prošlá: nic nezmizí bez povšimnutí.
- Když DataFirefly neodpovídá (chyba sítě, HTTP 429 nebo 5xx), obchod na 60 sekund přestane odesílat přímo a události rovnou řadí do fronty. Výpadek na naší straně tak nikdy nezpomalí váš obchod ani pokladnu. Opakování to dál zkouší, a jakmile uspěje, přímé odesílání se obnoví.
- Stránka vašeho webu v klientské sekci ukazuje stav této fronty. Jednotlivé stavy vysvětluje stránka [Řešení potíží](https://server-side.datafirefly.com/cs/docs/troubleshooting.html).

## Když něco nefunguje

- Logy ve `var/log/`, prefix `[DataFirefly SS]`.
- Pokud používáte verzi pluginu starší než 1.9.0, aktualizujte: novější verze opravují možné dvojí započítání nákupů v GA4.
- Další časté příčiny najdete v [průvodci řešením potíží](https://server-side.datafirefly.com/cs/docs/troubleshooting.html).

Aktualizováno: 1. září 2026
