# De Shopware-plugin installeren

> De DataFirefly Server-Side plugin installeren en configureren op Shopware 6.5, 6.6 en 6.7: extensie uploaden, verbindingssleutel, toestemmingscookie, test via CLI.

- Oorspronkelijke pagina: https://server-side.datafirefly.com/nl/docs/shopware.html
- Taal: nl
- Bijgewerkt op: 2026-09-05
- Uitgever: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/nl/

---

Compatibel met Shopware 6.5, 6.6 en 6.7. Installatie via de admin of via de command line. Een mislukte levering komt in een wachtrij en wordt elke vijf minuten opnieuw verstuurd door de scheduler van Shopware: een korte storing kost niets.

## Vereisten

- Shopware 6.5, 6.6 of 6.7.
- De zip van de plugin, te downloaden via de pagina [**Modules**](https://admin.datafirefly.com/app/connectors) van uw klantomgeving.
- De [verbindingssleutel van uw site](https://server-side.datafirefly.com/nl/docs/connect-your-site.html).

## Installatie

1. Shopware-admin: **Extensions > My extensions > Upload extension**, installeer en activeer daarna de plugin.
2. Of via CLI: `bin/console plugin:install --activate DatafireflyServerSide`

## Configuratie

1. Open de configuratie van de plugin en plak de verbindingssleutel `dfss_...`.
2. Schakel **Enable tracking** in.

De module herkent de gangbare toestemmingstools zelf (DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, tarteaucitron), in de browser en op de server, dezelfde lijst als de WooCommerce- en PrestaShop-modules. Laat **Consent cookie name** leeg voor die automatische herkenning; vul het alleen in om een bepaalde cookie af te dwingen (bijvoorbeeld `CookieConsent` en `marketing:true`), die dan voorrang krijgt.

## Controleren

1. Voer `bin/console datafirefly:serverside:test` uit.
2. Het testevent moet als **Delivered** verschijnen in de Monitoring van uw klantomgeving.

## Wachtrij voor opnieuw verzenden

Geldt vanaf versie 1.23.0.

- Een mislukte verzending komt in de wachtrij en wordt elke 5 minuten opnieuw verstuurd door een geplande taak van Shopware.
- Aankopen en terugbetalingen gaan voor, daarna de meest recente events.
- Een event verlaat de wachtrij pas als het ouder is dan 7 dagen **en** al meer dan 7 dagen wacht. Het wordt dan als verlopen geteld: er verdwijnt niets ongemerkt.
- Antwoordt DataFirefly niet (netwerkfout, HTTP 429 of 5xx), dan stopt de winkel 60 seconden met direct verzenden en zet de events meteen in de wachtrij. Een storing aan onze kant vertraagt uw winkel of de checkout dus nooit. Het opnieuw verzenden blijft proberen, en zodra dat lukt, wordt weer direct verzonden.
- De pagina van uw site in de klantenomgeving toont de status van deze wachtrij. De statussen worden uitgelegd op de pagina [Probleemoplossing](https://server-side.datafirefly.com/nl/docs/troubleshooting.html).

## Bij problemen

- Logboeken in `var/log/`, voorvoegsel `[DataFirefly SS]`.
- Gebruikt u een pluginversie ouder dan 1.9.0, werk dan bij: recente versies verhelpen een mogelijke dubbeltelling van aankopen in GA4.
- De andere veelvoorkomende oorzaken vindt u in de [gids probleemoplossing](https://server-side.datafirefly.com/nl/docs/troubleshooting.html).

Bijgewerkt: 1 september 2026
