# De WooCommerce-plugin installeren

> De DataFirefly Server-Side plugin installeren en configureren op WooCommerce: verbindingssleutel dfss\_, volledige funnel, deduplicatie van bestellingen.

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

---

De volledige funnel, van productweergave tot aankoop, met automatische deduplicatie en een wachtrij voor opnieuw verzenden. Compatibel met HPOS.

## Vereisten

- WordPress 5.8+, WooCommerce 5.0+, PHP 7.4+. Compatibel met HPOS.
- 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. WordPress-admin: **Plugins > Add New > Upload Plugin**.
2. Upload de zip en klik daarna op **Activate**.

## Configuratie

1. Open **Settings > DataFirefly Server-Side**.
2. Plak de verbindingssleutel `dfss_...` en klik op **Connect**: de knop schakelt de volledige tracking en de toestemmingsoptie in, en verstuurt meteen een testevent.

De plugin herkent de volgende toestemmingstools automatisch, zonder instelling: WP Consent API, Complianz, DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, tarteaucitron. De PrestaShop- en Shopware-modules gebruiken dezelfde herkenning: wat hier wordt herkend, wordt overal herkend.

## Wat de plugin dekt

- De hele funnel: navigatie, productweergave, winkelwagen, checkout, aankoop.
- Deduplicatie op bestelnummer: geen dubbeltelling tussen browser en server.
- Automatische wachtrij voor opnieuw verzenden: mislukte verzendingen worden opnieuw verstuurd, aankopen eerst (details hieronder).
- Het paneel **DataFirefly Activity** in de admin toont de laatst verzonden events.

## Controleren

1. Het testevent moet als **Delivered** verschijnen in de Monitoring van uw klantomgeving.
2. Plaats een testbestelling en zoek deze terug in het paneel DataFirefly Activity.

## Wachtrij voor opnieuw verzenden

Geldt vanaf versie 2.30.0.

- Een mislukte verzending komt in de wachtrij en wordt elke 5 minuten opnieuw verstuurd door WP-Cron.
- 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

- Na een configuratiewijziging: **leeg de cache** van uw site, anders serveren LiteSpeed Cache en soortgenoten het oude JavaScript.
- Gebruikt u een pluginversie ouder dan 2.8.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
