Aller au contenu
Nouveau : 3 labels GARAN gratuits, sans inscriptionCréer
Garantie légale UE
et label GARAN
GuideMis à jour le 9 octobre 20268 min de lecture

Ajouter la notice sur la garantie légale à Magento / Adobe Commerce

La notice officielle de l’UE sur la garantie légale de conformité dans votre boutique Magento / Adobe Commerce en quelques minutes, avec le widget gratuit.

Dans Magento 2 ou Adobe Commerce, vous créez un bloc CMS contenant le code du widget et le placez sur toutes les fiches produit au moyen d’une instance de widget. Un label GARAN propre à chaque produit se gère dans un attribut produit, que vous remplissez par import CSV.

Le code pour Magento / Adobe Commerce

<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 Magento / Adobe Commerce

  1. Créer un bloc CMS
    Sous Content → Blocks, créez un nouveau bloc et collez le code du widget. À partir de la version 2.4.3, le Page Builder s’ouvre : utilisez-y l’élément « HTML Code ».
  2. Créer le widget
    Sous Content → Elements → Widgets, créez un widget de type « CMS Static Block » pour votre thème.
  3. Placer
    Comme mise à jour de mise en page, choisissez « All Product Types » et indiquez le conteneur « Product View Extra Hint ». Il se trouve sous le bouton d’ajout au panier.
  4. Vider le cache
    Enregistrez, videz le cache et vérifiez sur une fiche produit.

Un label GARAN par produit : attribut et import CSV

Le bloc CMS affiche le même contenu sur toutes les fiches produit. Cela suffit pour la notice sur la garantie légale et pour un label GARAN valable pour tous les produits. Si chaque produit a besoin de son propre label GARAN, enregistrez l’adresse du label dans un attribut produit. Le thème affiche cet attribut une seule fois sur la fiche produit ; ensuite, vous ne gérez plus que des données.

  1. Créer l’attribut
    Sous Stores → Attributes → Product, cliquez sur « Add New Attribute » et créez un attribut de type « Text Field », avec l’Attribute Code garan_label_url et le Scope « Global ». Pour la version imbriquée, ajoutez si besoin un second attribut garan_label_nested_url. Laissez « Visible on Catalog Pages on Storefront » sur « No », sinon l’adresse apparaît aussi en texte dans les détails du produit. Faites ensuite glisser les deux attributs dans votre jeu d’attributs sous Stores → Attributes → Attribute Set et enregistrez.
  2. Créer les labels
    Dans l’espace client, sous « Import CSV », chargez un fichier avec la marque, le modèle et les années, ainsi qu’une colonne sku contenant la SKU de Magento. Le fichier de résultat contient les colonnes sku;brand;model;years;label_url;label_nested_url;embed_html, séparées par des points-virgules.
  3. Préparer le fichier d’import
    Dans le fichier de résultat, gardez sku, renommez label_url en garan_label_url et label_nested_url en garan_label_nested_url, supprimez toutes les autres colonnes ainsi que les lignes sans adresse. Enregistrez le fichier en UTF-8 sans BOM, par exemple avec LibreOffice ou un éditeur de texte. Le fichier de résultat contient un BOM pour Excel, et selon Adobe, Magento ne reconnaît pas toujours les fichiers avec BOM. Excel remet un BOM si vous enregistrez au format « CSV UTF-8 ».
  4. Importer
    Sous System → Data Transfer → Import, choisissez « Products » comme Entity Type et « Add/Update » comme Import Behavior, saisissez un point-virgule ; dans « Field separator », sélectionnez le fichier, cliquez sur « Check Data », puis sur « Import ». Magento associe chaque ligne au produit existant grâce à sa SKU.
  5. Une fois dans le thème
    Un développeur ou votre agence ajoute les deux fichiers ci-dessous à votre propre thème et vide le cache. C’est une modification unique. Ensuite, chaque produit reçoit son label uniquement par l’attribut, par import ou à la main dans le produit.

Le fichier de mise en page app/design/frontend/<Vendor>/<theme>/Magento_Catalog/layout/catalog_product_view.xml ajoute un bloc sous le bouton d’ajout au panier, dans le conteneur product.info.extrahint. Si votre thème contient déjà ce fichier, ajoutez-y seulement le referenceContainer :

<?xml version="1.0"?>
<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
    <body>
        <referenceContainer name="product.info.extrahint">
            <block class="Magento\Catalog\Block\Product\View" name="garan.label"
                   template="Magento_Catalog::product/view/garan-label.phtml" after="-"/>
        </referenceContainer>
    </body>
</page>

Le modèle app/design/frontend/<Vendor>/<theme>/Magento_Catalog/templates/product/view/garan-label.phtml n’affiche quelque chose que si une adresse est renseignée sur le produit. data-nur="garan" affiche uniquement le label GARAN, car le bloc CMS affiche déjà la notice sur la garantie légale. Si la version imbriquée est renseignée, elle apparaît, et un clic ouvre le label complet :

<?php
/** @var \Magento\Catalog\Block\Product\View $block */
/** @var \Magento\Framework\Escaper $escaper */
$full = trim((string) $block->getProduct()->getData('garan_label_url'));
$nested = trim((string) $block->getProduct()->getData('garan_label_nested_url'));
if ($full === '') {
    return;
}
?>
<div data-garantielabel data-nur="garan"
     data-garan-voll="<?= $escaper->escapeUrl($full) ?>"
     data-garan-klein="<?= $escaper->escapeUrl($nested) ?>"></div>
<script src="https://www.garantielabel.app/widget.js" async></script>

Si le bloc CMS contient déjà lui-même un label GARAN (data-garan-voll), retirez-le, sinon deux labels apparaissent. Le fichier de mise en page par SKU (catalog_product_view_sku_{sku}.xml, plus bas) ne vaut plus la peine que pour quelques produits, car chaque fichier est une modification du thème.

Produits configurables

Sur la page d’un produit configurable, le modèle affiche l’attribut du produit parent. Quand le client choisit une option, la page reste la même et le label ne change pas. Si toutes les variantes ont la même marque, la même référence du modèle et la même durée de garantie, renseignez simplement le label sur le produit parent, c’est-à-dire dans la ligne de sa SKU. Un label propre à chaque variante demande du JavaScript supplémentaire qui insère les adresses de la variante choisie. Il est souvent plus simple de gérer ces modèles comme produits distincts.

Particularités de Magento / Adobe Commerce

Où placer la notice dans Magento

Toutes les fiches produit utilisent le fichier de mise en page catalog_product_view.xml. S’y ajoutent des fichiers par type de produit, comme catalog_product_view_type_configurable.xml, et par produit, comme catalog_product_view_sku_{sku}.xml. La colonne avec le prix et la zone d’achat est le conteneur product.info.main. Il contient product.info.extrahint, appelé « Product View Extra Hint » dans le formulaire du widget.

Dans l’administration, vous créez les widgets sous Content → Elements → Widgets. « Display On » définit le type de page, « Container » la zone de la page. Pour les fiches produit, choisissez « All Product Types » ou un seul type de produit. Pour la notice dans le pied de page, ajoutez une seconde mise à jour de mise en page : « All Pages » avec le conteneur « Page Footer », de préférence avec data-darstellung="link".

Produits configurables et référence du modèle

Un produit configurable s’affiche comme un seul produit avec des listes de choix. Selon Adobe, chaque variante est un produit simple distinct avec sa propre SKU. Le produit configurable n’est que le cadre ; son prix vient des variantes.

La documentation d’Adobe ne cite pas de champ dédié à la référence du modèle. Vous créez pour cela un attribut produit sous Stores → Attributes → Product, puis vous l’ajoutez à votre jeu d’attributs sous Stores → Attributes → Attribute Set. Avec « Visible on Catalog Pages on Storefront » sur « Yes », il apparaît sur la fiche produit. Comme chaque variante est un produit à part entière, elle peut porter sa propre référence du modèle.

Le label GARAN indique la marque et la référence du modèle : il y a donc un label par référence du modèle. Le widget affiche un label GARAN par emplacement et ne change pas avec l’option choisie. Pour un label propre à un seul produit, les développeurs utilisent le fichier de mise en page de ce produit (catalog_product_view_sku_{sku}.xml). Si des variantes ont des références de modèle différentes, gérez plutôt ces modèles comme produits distincts. Pour de nombreux produits, voir plus haut la méthode avec attribut et import CSV.

Pièges fréquents dans Magento

Autres sources

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. Vous gérez les modèles d’e-mail sous Marketing → Email Templates. Vous pouvez ajouter le graphique officiel en image au modèle « New Order ». 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 Magento / Adobe Commerce 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 Magento / Adobe Commerce 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 via le XML de mise en page ?

Oui. Les développeurs intègrent le bloc par XML de mise en page dans catalog_product_view.xml.

Comment donner à de nombreux produits leur propre label GARAN ?

Avec un attribut produit comme garan_label_url, que vous remplissez sous System → Data Transfer → Import à partir du fichier de résultat de l’import CSV. Le thème affiche l’attribut une fois ; ensuite, tout se règle dans les données.

Cela fonctionne-t-il avec Hyvä ?

Oui. Le widget ne dépend ni de RequireJS ni de Knockout et fonctionne aussi dans les thèmes Hyvä.

Dois-je vider le cache ?

Oui, après avoir créé le widget ; sinon, le bloc n’apparaît que plus tard.

Puis-je ajouter un label GARAN pour un seul produit ?

Oui. Pour de nombreux produits, le plus simple est un attribut produit et l’import CSV, décrits plus haut dans la section attribut et import CSV. Pour quelques produits, le fichier de mise en page catalog_product_view_sku_{sku}.xml convient aussi ; il ne s’applique qu’au produit portant cette SKU.

Le widget apparaît-il dans toutes les store views ?

Seulement dans celles que vous sélectionnez dans les Storefront Properties de l’instance de widget.

Que faire après un changement de thème ?

Les instances de widget appartiennent à un Design Theme. Créez le widget pour le nouveau thème, rafraîchissez le cache et vérifiez une fiche produit.

Votre label GARAN, gratuitement.

Vos 3 premiers labels sont gratuits. Sur Shopify, notre app ajoute automatiquement les deux labels européens.