# Installer le plugin Shopware

> Installer et configurer le plugin DataFirefly Server-Side sur Shopware 6.5, 6.6 et 6.7 : upload de l'extension, clé de connexion, cookie de consentement.

- Page d'origine : https://server-side.datafirefly.com/docs/shopware.html
- Langue : fr
- Mis à jour le : 2026-09-05
- Éditeur : DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/

---

Compatible Shopware 6.5, 6.6 et 6.7. Installation via l'admin ou en ligne de commande. Une livraison échouée est mise en file et rejouée toutes les cinq minutes par le planificateur de Shopware : une panne passagère ne coûte rien.

## Prérequis

- Shopware 6.5, 6.6 ou 6.7.
- Le zip du plugin, à télécharger depuis la page [**Modules**](https://admin.datafirefly.com/app/connectors) de votre espace client.
- La [clé de connexion de votre site](https://server-side.datafirefly.com/docs/connect-your-site.html).

## Installation

1. Admin Shopware : **Extensions > My extensions > Upload extension**, puis installez et activez le plugin.
2. Ou en CLI : `bin/console plugin:install --activate DatafireflyServerSide`

## Configuration

1. Ouvrez la configuration du plugin et collez la clé de connexion `dfss_...`.
2. Activez **Enable tracking**.

Le module reconnaît seul les outils de consentement courants (DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, tarteaucitron), côté navigateur comme côté serveur, la même liste que les modules WooCommerce et PrestaShop. Laissez **Consent cookie name** vide pour cette détection automatique ; ne le remplissez que pour imposer un cookie précis (par exemple `CookieConsent` et `marketing:true`), qui devient alors prioritaire.

## Vérifier

1. Lancez `bin/console datafirefly:serverside:test`.
2. L'événement de test doit apparaître en **Delivered** dans le Monitoring de votre espace client.

## File de renvoi

Comportement des versions 1.23.0 et suivantes.

- Un envoi échoué est mis en file, puis rejoué toutes les 5 minutes par une tâche planifiée de Shopware.
- Les achats et les remboursements passent en premier, puis les événements les plus récents.
- Un événement ne sort de la file que s'il a plus de 7 jours **et** attend depuis plus de 7 jours. Il est alors compté comme expiré : rien ne disparaît en silence.
- Si DataFirefly ne répond pas (panne réseau, erreur HTTP 429 ou 5xx), la boutique cesse d'envoyer en direct pendant 60 secondes et met les événements directement en file. Une panne chez nous ne ralentit donc jamais votre boutique ni le checkout. Le rejeu continue d'essayer, et dès qu'il réussit, l'envoi direct reprend.
- La page de votre site, dans l'espace client, affiche l'état de cette file. Les états sont expliqués dans le [guide de dépannage](https://server-side.datafirefly.com/docs/troubleshooting.html).

## En cas de problème

- Journaux dans `var/log/`, préfixe `[DataFirefly SS]`.
- Si vous utilisez une version du plugin antérieure à 1.9.0, mettez à jour : les versions récentes corrigent un double comptage possible des achats dans GA4.
- Les autres causes fréquentes sont listées dans le [guide de dépannage](https://server-side.datafirefly.com/docs/troubleshooting.html).

Mise à jour : 1 septembre 2026
