SW Shopware 6 Shopware Débutant

DfGpsr SW — Guide complet

Installer, configurer et exploiter DfGpsr SW : informations de sécurité RGPS (fabricant, personne responsable UE, avertissements, documents) sur vos fiches produit, avec valeurs de repli par canal de vente, pour Shopware 6.5, 6.6 et 6.7.

Mis à jour Version du module 1.0.0

DfGpsr SW affiche sur vos fiches produit Shopware les informations de sécurité rendues obligatoires par le règlement (UE) 2023/988 — le règlement général sur la sécurité des produits (RGPS), applicable depuis le 13 décembre 2024. Shopware n’offre rien de natif solide sur ce point. DfGpsr SW comble ce vide avec des champs personnalisés par produit, des valeurs de repli globales configurables par canal de vente, et un affichage automatique sous la description du produit. Le plugin est volontairement construit sans composant d’administration sur mesure et sans JavaScript storefront : un seul et même ZIP s’installe à l’identique sur Shopware 6.5, 6.6 et 6.7, sans aucune compilation. Ce guide couvre l’installation, la configuration globale, la saisie par produit, la traduction, la personnalisation du template et le dépannage.

DfGpsr SW est un outil technique d’affichage. Il vous aide à présenter les informations exigées, mais l’exactitude et l’exhaustivité des données saisies restent de votre responsabilité, de même que l’évaluation de l’applicabilité du règlement à vos produits. Ce guide ne constitue pas un conseil juridique.

Ce qu’impose le RGPS

Pour la vente en ligne, le règlement (UE) 2023/988 impose que chaque offre affiche clairement, avant l’achat :

  • le fabricant : nom, adresse postale et adresse électronique ;
  • la personne responsable établie dans l’UE (article 16) lorsque le fabricant est établi hors de l’Union : nom, adresse postale et adresse électronique ;
  • les avertissements et informations de sécurité dans la langue du pays ciblé.

DfGpsr SW couvre ces trois exigences, plus une liste de documents de sécurité (notices, fiches de données de sécurité, certificats) et un interrupteur de masquage pour les références hors champ du règlement.

Installation

  1. Téléchargez l’archive DfGpsr-v1.0.0.zip depuis votre compte DataFirefly.
  2. Copiez le dossier décompressé DfGpsr dans custom/plugins/ de votre Shopware, ou installez le ZIP via Administration → Extensions → Mes extensions → Charger l’extension.
  3. Lancez l’installation et l’activation : 
    bin/console plugin:refresh
bin/console plugin:install --activate DfGpsr
bin/console cache:clear
  4. À l’installation, le plugin crée son jeu de champs personnalisés df_gpsr sur l’entité produit. À la désinstallation sans conservation des données, ce jeu de champs et toutes ses valeurs sont supprimés.

Compatible Shopware 6.5.x, 6.6.x et 6.7.x sur un seul codebase. Aucun build storefront ni administration n’est nécessaire, et le plugin n’ajoute aucune dépendance Composer. C’est ce qui garantit l’installation à l’identique sur les trois versions, y compris la nouvelle administration de la 6.7.

Configuration globale (valeurs de repli)

Ouvrez Extensions → Mes extensions → DataFirefly GPSR Compliance → ⋯ → Configurer. La configuration est organisée en cartes :

  • Général : activer l’affichage du bloc, afficher ou non le titre de section, et une option d’affichage forcé même sans données (réservée au theming/debug).
  • Fabricant par défaut : nom, adresse postale et e-mail utilisés lorsqu’un produit ne définit pas son propre fabricant.
  • Personne responsable UE par défaut : nom, adresse postale et e-mail.
  • Textes de sécurité par défaut : avertissements et informations de sécurité génériques.

Toutes ces valeurs sont configurables par canal de vente grâce au sélecteur natif de Shopware en haut de la configuration. Sélectionnez un canal pour lui attribuer des valeurs spécifiques, ou laissez « Tous les canaux de vente » pour des valeurs communes.

Si vous vendez votre propre marque, renseignez le fabricant une seule fois dans la configuration globale : tout le catalogue est couvert sans toucher aux produits. Les champs par produit ne servent alors que pour les exceptions.

Renseigner un produit

Ouvrez un produit dans Catalogues → Produits, puis l’onglet Spécifications → Champs personnalisés. Le groupe RGPS — Sécurité du produit regroupe les champs suivants :

  • Masquer les informations RGPS pour ce produit : interrupteur à activer pour les références hors champ du règlement.
  • Fabricant : nom, adresse postale, adresse e-mail.
  • Personne responsable UE : nom, adresse postale, adresse e-mail.
  • Avertissements et Informations de sécurité : éditeurs de texte enrichi.
  • Documents de sécurité : un par ligne, au format Libellé|URL ou simplement une URL.

La règle de résolution est simple : pour chaque champ, le plugin utilise la valeur du produit si elle est renseignée, sinon il retombe sur la valeur par défaut du canal de vente. Le champ « Documents » n’a pas de valeur de repli globale — il est propre à chaque produit.

Format des documents de sécurité

Saisissez un document par ligne. Deux formats sont acceptés :

Notice d'utilisation|https://exemple.com/notice.pdf
Fiche de données de sécurité|https://exemple.com/fds.pdf
https://exemple.com/certificat.pdf

Avec le format Libellé|URL, le libellé devient le texte cliquable ; une URL seule s’affiche telle quelle. Tous les liens s’ouvrent dans un nouvel onglet.

Traduction

Les champs sont des champs personnalisés Shopware standards : ils se traduisent produit par produit via le sélecteur de langue de l’administration, en haut de la fiche produit. Renseignez par exemple les avertissements en français pour la langue FR, puis basculez sur DE pour saisir la version allemande.

Les libellés du bloc storefront (titre « Sécurité du produit », « Fabricant », « Personne responsable dans l’UE », etc.) sont fournis nativement dans cinq langues : français, anglais, allemand, espagnol et italien. Ils s’affichent automatiquement selon la langue du canal de vente, sans configuration.

Pensez à fournir vos avertissements dans la langue de chaque pays ciblé : le RGPS exige que les informations de sécurité soient compréhensibles par le consommateur du marché visé.

Affichage storefront

Le bloc RGPS est injecté automatiquement sur la page de détail produit, juste après la description, dans le bloc Twig page_product_detail_description_content_text. Il présente le fabricant et la personne responsable côte à côte, puis les avertissements, les informations de sécurité et la liste des documents. Le bloc se masque automatiquement lorsqu’aucune donnée n’est disponible — ni sur le produit, ni dans la configuration globale.

Personnaliser le template

Le composant d’affichage est isolé dans views/storefront/component/df-gpsr/gpsr-info.html.twig et injecté via views/storefront/page/product-detail/description.html.twig. Pour déplacer le bloc ou en modifier le rendu, surchargez l’un de ces deux fichiers dans votre thème. Le style de base est inline et volontairement neutre, facile à remplacer par vos propres classes.

FAQ et dépannage

Le RGPS s’applique-t-il à ma boutique ? Si vous vendez des produits de consommation non alimentaires à des clients situés dans l’UE, très probablement oui. Le règlement s’applique depuis le 13 décembre 2024 à la plupart des produits, y compris ceux vendus en ligne et importés de pays tiers.

Le bloc ne s’affiche pas. Vérifiez que l’option « activer l’affichage » est bien cochée dans la configuration, que le produit ou la configuration globale contient au moins une donnée, et que l’interrupteur « Masquer » n’est pas activé sur le produit. Videz le cache après toute modification de configuration.

Le bloc s’affiche mais vide. C’est probablement l’option « afficher même sans données » laissée active : désactivez-la pour revenir au comportement normal (masquage automatique).

Mes champs personnalisés rendent en simple champ texte dans l’admin 6.7. Le mapping des composants de champs personnalisés a évolué avec l’administration Meteor. Si un champ adresse rend en input simple au lieu d’une zone de texte, ce n’est qu’un détail d’affichage admin sans impact sur le storefront ; signalez-le au support pour un ajustement.

Les valeurs par défaut ne s’appliquent pas. Vérifiez que vous avez renseigné la configuration pour le bon canal de vente. Une valeur définie sur « Tous les canaux de vente » est écrasée par une valeur spécifique au canal si celle-ci existe.

Que se passe-t-il à la désinstallation ? Avec l’option de suppression des données, le jeu de champs df_gpsr et toutes les valeurs saisies sur les produits sont supprimés. Sans cette option, les données sont conservées pour une réinstallation ultérieure.

Cette page vous a-t-elle été utile ?

Toujours bloqué ? Contactez le support