Dans Shopware 6, vous placez l’emplacement réservé dans la mise en page de la fiche produit via les « Erlebniswelten » (Shopping Experiences). Vous chargez le script via le thème ou une extension pour scripts personnalisés, car depuis Shopware 6.5 l’éditeur supprime les scripts des éléments de texte.
Nouveau depuis Shopware 6.7.14 (et 6.6.10.24) : Shopware intègre lui-même le label GARAN. Vous saisissez la durée de garantie sur le produit ; la marque et la référence du modèle proviennent du fabricant et du numéro de produit du fabricant. Le widget ajoute la notice sur la garantie légale sur la fiche produit. Omettez alors data-garan-* dans le widget pour que le label GARAN n’apparaisse pas deux fois. Détails plus bas, sous « Variantes et référence du modèle ».
Le code pour Shopware 6
<div data-garantielabel></div>
<script src="https://www.garantielabel.app/widget.js" async></script>Vous réglez les autres options, comme l’affichage et la langue, dans le générateur de code.
Pas à pas dans Shopware 6
- Ouvrir la mise en page
Dans l’administration, sous « Inhalte → Erlebniswelten » (en anglais : Content → Shopping Experiences), ouvrez la mise en page de vos fiches produit ou créez-en une de type « Produktseite » (Product page). - Insérer l’emplacement
Sous la zone d’achat, insérez un bloc avec un élément de texte, passez en vue code source et collez<div data-garantielabel></div>. - Charger le script
Intégrez la ligne contenantwidget.jsvia le thème (par exemple dansbase.html.twig) ou une extension pour scripts personnalisés, puis enregistrez la mise en page et attribuez-la aux produits. - Variante dans le thème
Les développeurs étendent dans leur propre thème le modèle de la zone d’achat (buy-widget.html.twig) avec l’emplacement et intègrent le script dans l’en-tête du modèle.
Particularités de Shopware 6
- À partir de la version 6.5, Shopware filtre les scripts dans l’élément de texte (HTML Sanitizer). On ne peut le désactiver que sur les boutiques auto-hébergées ; dans Shopware Cloud, il reste le thème ou une extension.
- Avec une Content Security Policy personnalisée,
www.garantielabel.appdoit être autorisé pour les scripts, les images et les connexions.
Où placer la notice dans Shopware 6
Dans Shopware, la fiche produit est une « Erlebniswelt » (Shopping Experience) de type « Produktseite » (Product page). Par défaut, elle contient la Buybox avec la galerie d’images et la description du produit. D’autres éléments existent, comme « Produktname & Hersteller-Logo » (nom du produit et logo du fabricant) et le Cross Selling. Vous attribuez une mise en page dans l’onglet « Layout » du produit. Pour en faire la mise en page par défaut des nouvelles fiches, utilisez « Layout-Zuweisung → Standardlayouts » (Layout assignment → Default layouts) dans la barre latérale.
Dans le thème, la Buybox provient du modèle buy-widget.html.twig, dans Shopware 6.7 sous storefront/component/buy-widget/. Vous créez vos propres modèles dans une extension ou un thème sous Resources/views, avec la même arborescence, et étendez l’original avec sw_extends.
Pour le pied de page, choisissez dans les réglages du canal de vente le « Einstiegspunkt für die Footer-Navigation » (Entry point footer navigation). Dans le thème standard, le niveau inférieur fournit les titres et le niveau encore en dessous les liens. Les développeurs étendent plutôt le modèle layout/footer/footer.html.twig et y placent le widget avec data-darstellung="link".
Variantes, référence fabricant et label GARAN
Vous créez les variantes dans l’onglet « Varianten » (Variants) du produit avec le générateur de variantes. Il faut d’abord des propriétés sous « Produkte → Eigenschaften » (Products → Properties). Les variantes héritent d’informations comme le nom et la description du produit principal. L’icône en forme de chaîne supprime l’héritage pour une variante.
Depuis Shopware 6.7.14 et 6.6.10.24, Shopware affiche lui-même le label GARAN. Le produit comporte la carte « Garantie (GARAN Label) » avec la durée de la garantie du producteur en mois (de 30 à 600, par pas de 6) et l’interrupteur « Label in der Storefront anzeigen » (Show label in Storefront). La marque provient du champ « Hersteller » (Manufacturer), la référence du modèle de la « Hersteller-Produktnummer » (Manufacturer product number) dans l’onglet « Allgemein » (General). S’il manque une donnée, Shopware n’affiche pas de label. Selon Shopware, les champs de garantie se renseignent sur le produit principal et peuvent être remplacés par variante. Si vos variantes ont leur propre référence du modèle, saisissez la référence fabricant pour chaque variante.
Le label GARAN apparaît alors sous la Buybox, dans le panier, sur la page de validation de commande et dans l’e-mail de confirmation. Shopware place le lien vers la notice sur la garantie légale sur la page de validation de commande, près du texte des CGV. Shopware ne décrit pas d’affichage sur la fiche produit : là et dans le pied de page, le widget ajoute la notice. Si votre boutique utilise le label GARAN intégré, n’ajoutez pas data-garan-voll et data-garan-klein au widget, sinon le label apparaît deux fois.
Pièges fréquents dans Shopware
- Cache : après une modification des modèles, videz le cache, par exemple avec
bin/console cache:clear. Le thème doit être attribué au bon canal de vente dans l’onglet « Theme ». - E-mail de commande personnalisé : la mise à jour n’a complété le modèle de confirmation de commande que s’il n’avait jamais été modifié. Selon Shopware, les modèles personnalisés ne reçoivent pas automatiquement le label GARAN et le lien vers la notice.
- Texte des CGV remplacé : le lien vers la notice est activé après la mise à jour (« Gewährleistungshinweis auf Bestellabschlussseite anzeigen »). Si votre thème remplace le texte des CGV de la page de validation, Shopware indique qu’il faut adapter ce remplacement.
- Plusieurs canaux de vente : le réglage de la notice peut être modifié par canal de vente. Vérifiez chaque canal.
Autres sources
- Shopware : GARAN label and EU guarantee requirements (en anglais)
- Changelog Shopware 6.6.10.24 : EU harmonised guarantee label (GitHub, en anglais)
- Version Shopware 6.7.14.0 (GitHub, en anglais)
- Modèle Shopware buy-widget.html.twig (GitHub)
- Documentation Shopware : Shopping Experiences (en anglais)
- Documentation Shopware : Products (en anglais)
- Documentation Shopware : Sales channels (en anglais)
- Documentation développeurs Shopware : Customize templates (en anglais)
La notice dans la confirmation de commande
Selon les lignes directrices de la Commission, la notice devrait aussi figurer dans l’e-mail de confirmation. Dans Shopware, vous modifiez les modèles d’e-mail sous « Einstellungen → E-Mail-Templates » (en anglais : Settings → Email templates). Vous pouvez ajouter le graphique officiel en image au modèle de la confirmation de commande. Un simple lien ne suffira probablement pas comme support durable (CJUE, affaire C-49/11) ; le plus sûr est de placer la notice directement dans l’e-mail, en image, en texte ou en pièce jointe. Les fichiers officiels se trouvent sur la page de téléchargement.
Garantie du producteur ? Ajoutez le label GARAN
Si le fabricant offre une garantie commerciale de durabilité sans frais, de plus de deux ans et sur l’ensemble du bien, le label GARAN doit en plus figurer sur la fiche produit. Avec le générateur de label GARAN, vous le créez en quelques secondes à partir de la durée, de la marque et du modèle, vos trois premiers labels gratuitement et sans inscription. Sous chaque label terminé, vous trouvez un code d’intégration avec des adresses d’image permanentes : rien à téléverser, il suffit de l’insérer dans Shopware 6 comme ci-dessus.
Vous préférez vos propres fichiers ? Téléversez alors la version complète et la version imbriquée dans la médiathèque de Shopware 6 et indiquez leurs adresses dans le code du widget :
<div data-garantielabel
data-garan-voll="https://…/GARAN-MX-500.svg"
data-garan-klein="https://…/GARAN-MX-500-imbrique.svg"></div>Le widget affiche alors la version imbriquée sous la notice sur la garantie légale ; un clic ouvre le label GARAN complet.
Questions fréquentes
Est-ce possible aussi avec Shopware 5 ?
Oui, via un élément de « Einkaufswelt » (monde d’achat) ou le fichier de modèle de la page de détail. Shopware 5 n’est toutefois plus pris en charge depuis juillet 2024.
Dois-je le faire pour chaque produit ?
Non. Dans la mise en page de la fiche produit, le code s’applique à tous les produits auxquels cette mise en page est attribuée.
Cela perturbe-t-il la zone d’achat ?
Non. Le widget dessine uniquement dans son emplacement et ne modifie rien en dehors.
Ai-je besoin du widget si Shopware affiche déjà le label GARAN ?
Pas pour le label GARAN : à partir de Shopware 6.7.14 ou 6.6.10.24, Shopware s’en charge. Shopware place le lien vers la notice sur la page de validation de commande. Pour la fiche produit et le pied de page, le widget reste utile, alors sans data-garan-….
Quel champ Shopware utilise-t-il comme référence du modèle ?
La « Hersteller-Produktnummer » (Manufacturer product number) dans l’onglet « Allgemein » (General). La marque provient du champ « Hersteller » (Manufacturer).
Pourquoi Shopware n’affiche-t-il pas de label GARAN ?
Shopware ne l’affiche que si « Label in der Storefront anzeigen » (Show label in Storefront) est activé et que la durée de garantie, le fabricant et la référence fabricant sont renseignés.