Dans JTL-Shop 5, vous placez la notice sur la garantie légale pour tous les articles via le modèle enfant (child template) de la page de détail de l’article. Pour un article isolé, l’OnPage Composer avec un portlet de texte en vue code source convient aussi.
Nouveau depuis JTL-Shop 5.8 : JTL-Shop intègre les deux labels. Vous les activez sous « Darstellung → Einstellungen → Global » (Affichage → Paramètres → Global), section « Gewährleistungs- und Garantielabel ». JTL affiche la notice sur la garantie légale dans le récapitulatif de commande, sur la page « Gesetzliche Gewährleistung » dans le pied de page et en PDF joint à la confirmation de commande, mais selon JTL pas sur la fiche article. C’est à cela que sert le widget. JTL lit le label GARAN dans les attributs de fonction Wawi jtl_guarantee_manufacturer, jtl_guarantee_model_identifier et jtl_guarantee_years.
Le code pour JTL-Shop
<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 JTL-Shop
- Utiliser un modèle enfant
Les modifications vont dans un modèle enfant (pour NOVA : NOVAChild), afin que les mises à jour ne les écrasent pas. - Étendre le modèle
Dans le modèle enfant, étendez le modèle de la page de détail de l’article et placez le code du widget sous le bouton d’ajout au panier. Il s’applique alors à tous les articles. - Article isolé
Pour un seul article : dans l’OnPage Composer, faites glisser un portlet de texte sous le bouton d’ajout au panier et collez le code en vue code source. L’OnPage Composer modifie chaque page séparément. - Vérifier
Videz le cache ou publiez le brouillon, puis vérifiez sur un article.
Particularités de JTL-Shop
- Sans OnPage Composer (JTL-Shop 4), placez le code dans le modèle de la page de détail de l’article.
- Si la minification est active dans le modèle,
widget.jsne doit pas être traité : il se charge directement depuis garantielabel.app.
Où placer la notice dans JTL-Shop
Le modèle NOVA construit la page de détail de l’article à partir de productdetails/details.tpl. Le bloc productdetails-details-include-basket y intègre la zone d’achat. Le bouton d’ajout au panier se trouve dans productdetails/basket.tpl, dans le bloc productdetails-basket-add-to-cart. Dans le modèle enfant, vous créez le fichier avec le même chemin et complétez le bloc avec append ou prepend. Le contenu d’origine est conservé et la zone d’achat ne change pas.
Depuis JTL-Shop 5.8, la boutique intègre les deux labels. Vous les activez sous « Darstellung → Einstellungen → Global » (Apparence → Réglages → Global), dans la section « Gewährleistungs- und Garantielabel ». JTL affiche alors la notice sur la garantie légale dans le récapitulatif de commande et sur la page « Gesetzliche Gewährleistung » (garantie légale). JTL ajoute automatiquement cette page à la zone de pied de page « Gesetzliche Informationen » (informations légales), le groupe de liens dont le nom de modèle est « Fuss ». JTL ne mentionne pas la page de détail de l’article pour cette notice. C’est là que le widget l’ajoute.
Articles enfants, attributs de fonction et label GARAN
JTL-Wawi distingue les articles à variations et les articles enfants (anciennement combinaisons de variations). Les variations sans articles enfants ne sont pas des articles à part entière : beaucoup de réglages ne peuvent pas être faits par variation. Les articles enfants, eux, sont des articles distincts. Ils héritent de l’article parent, par exemple, les attributs et caractéristiques, mais se gèrent comme des articles ordinaires.
Le label de garantie intégré (label GARAN) lit trois attributs de fonction de JTL-Wawi : jtl_guarantee_manufacturer pour le producteur, jtl_guarantee_model_identifier pour la référence du modèle et jtl_guarantee_years pour la durée en années. Depuis JTL-Wawi 2.1, ils existent déjà, mais ils doivent être activés pour la boutique en ligne. S’il manque une des trois valeurs, la boutique n’affiche pas de label pour cet article. Si des articles enfants ont leur propre référence du modèle, saisissez jtl_guarantee_model_identifier sur chaque article enfant.
Vous choisissez séparément où le label apparaît : liste d’articles, page de détail, panier, récapitulatif de commande et confirmation de commande. Sur la page de détail, il se trouve sous le numéro d’article, le GTIN, la catégorie et le fabricant. Si vous utilisez le label 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 JTL-Shop
- Désactivé par défaut : selon JTL, les deux labels sont d’abord désactivés. Après la mise à jour vers 5.8, vous devez les activer vous-même.
- Synchronisation : les nouvelles données de garantie n’apparaissent dans la boutique qu’après une synchronisation de la boutique en ligne depuis JTL-Wawi.
- Durée de garantie : selon JTL,
jtl_guarantee_yearsdésigne la durée totale à compter de l’achat. Avec 3 ans, cela fait 3 ans au total, pas 5. - Modèle enfant : le nom du dossier doit correspondre au nom indiqué dans
template.xml, avecNOVAcomme modèle parent. Le modèle enfant ne contient que les fichiers modifiés. Après l’activation, videz le cache des modèles.
Autres sources
- JTL-Guide : configurer les labels de garantie dans JTL-Shop (en allemand)
- JTL-Guide : réglages globaux en détail (en allemand)
- JTL-Guide : glossaire des articles (en allemand)
- JTL-Guide : données de base, articles enfants (en allemand)
- Guide développeur JTL : créer un modèle enfant (en allemand)
- JTL-Shop 5.8.1 : modèle NOVA productdetails/details.tpl (GitLab)
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 dans le back-office de JTL-Shop, sous les « E-Mail-Vorlagen » (intitulé allemand). Vous pouvez ajouter le graphique officiel en image à 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 JTL-Shop 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 JTL-Shop 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 avec les données de JTL-Wawi ?
Oui. Si vous gérez les adresses des labels GARAN comme attribut d’article et les affichez dans le modèle dans data-garan-voll et data-garan-klein, chaque article montre le label qui lui correspond.
Ai-je besoin d’un plugin ?
Non. Le modèle enfant suffit. Un portlet HTML n’existe que sous forme de plugin dans l’Extension Store ; il n’est pas nécessaire.
Les mises à jour écrasent-elles la modification ?
Non, si la modification se trouve dans le modèle enfant. Les contenus de l’OnPage Composer sont également conservés.
JTL-Shop 5.8 affiche-t-il les labels tout seul ?
Oui, une fois activés sous « Darstellung → Einstellungen → Global ». Par défaut, les deux sont désactivés. La notice apparaît alors dans le récapitulatif de commande et sur la page « Gesetzliche Gewährleistung », le label de garantie aux endroits que vous choisissez.
Pourquoi le label de garantie manque-t-il pour un article ?
Le plus souvent, une des valeurs jtl_guarantee_manufacturer, jtl_guarantee_model_identifier ou jtl_guarantee_years manque, ou la synchronisation de la boutique n’a pas encore eu lieu. Vérifiez aussi que les attributs de fonction sont activés pour la boutique en ligne.
Dans quel bloc placer le widget ?
Par exemple avec append sur le bloc productdetails-details-include-basket de productdetails/details.tpl dans le modèle enfant. Il se place alors juste après la zone d’achat.