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

Ajouter la notice sur la garantie légale à OXID eShop

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

Dans OXID eShop 7, vous placez la notice sur la garantie légale sous le bouton d’ajout au panier par une extension de modèle : dans le bloc Twig details_productmain_tobasket du thème APEX, via un petit module ou un thème enfant. Une page CMS dans l’administration ne suffit pas, car l’éditeur supprime les scripts et la page article n’offre pas d’emplacement CMS libre.

Le code pour OXID eShop

<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 OXID eShop

  1. Module ou thème enfant
    L’extension va dans un petit module ou un thème enfant (dans theme.php avec 'parentTheme' => 'apex'), afin que les mises à jour du thème APEX ne l’écrasent pas. Vous l’activez sous « Erweiterungen → Module » ou « Erweiterungen → Themes » (intitulé allemand). Il faut pour cela un accès aux fichiers ; c’est souvent votre agence qui s’en charge.
  2. Étendre le bloc
    Étendez le modèle page/details/inc/productmain.html.twig et, dans le bloc details_productmain_tobasket, placez le code du widget après {{ parent() }}. Avec parent(), le bouton d’ajout au panier reste inchangé.
  3. Label GARAN par article
    Pour vos propres labels GARAN, créez deux attributs sous « Artikel verwalten → Attribute » (intitulé allemand), par exemple « GARAN complet » et « GARAN imbriqué », puis saisissez sur l’article, sous « Auswahl → Attribute zuordnen », les adresses des deux fichiers. Dans le modèle, affichez les valeurs dans data-garan-voll et data-garan-klein.
  4. Vider le cache
    Videz le cache des modèles avec vendor/bin/oe-console oe:cache:clear et vérifiez la page article, y compris avec des déclinaisons.

Dans un module, le fichier se trouve sous views/twig/extensions/themes/apex/page/details/inc/productmain.html.twig et ressemble à ceci :

{% extends 'page/details/inc/productmain.html.twig' %}

{% block details_productmain_tobasket %}
  {{ parent() }}
  <div data-garantielabel></div>
  <script src="https://www.garantielabel.app/widget.js" async></script>
{% endblock %}

Particularités de OXID eShop

Où placer exactement la notice dans OXID eShop

Sur la page article, la notice se trouve dans le bloc details_productmain_tobasket, comme décrit plus haut. Quand le client choisit une autre déclinaison, APEX recharge la zone details_container et la remplace par du HTML fraîchement généré. Le thème exécute alors à nouveau les scripts qu’elle contient. Votre extension de bloc revient donc aussi sur la page après le changement de déclinaison.

Pour une notice sur toutes les pages, étendez le modèle layout/footer.html.twig. Dans le thème APEX, il contient notamment le bloc dd_footer_copyright. Celui-ci affiche le contenu de la page CMS d’identifiant oxstdfooter. Dans un module, votre fichier se trouve sous views/twig/extensions/themes/apex/layout/footer.html.twig :

{% extends 'layout/footer.html.twig' %}

{% block dd_footer_copyright %}
  {{ parent() }}
  <div data-garantielabel></div>
  <script src="https://www.garantielabel.app/widget.js" async></script>
{% endblock %}

Le texte du pied de page lui-même reste dans la page CMS. L’emplacement, lui, va dans le modèle, pour la même raison que plus haut : l’éditeur supprime les scripts. Le modèle vaut pour toutes les langues de la boutique. Le widget choisit la langue de la notice d’après la langue indiquée par la page, qu’APEX définit à partir de la langue active de la boutique.

Déclinaisons et identifiant de modèle pour le label GARAN

Dans OXID, vous créez d’abord un article parent. Selon le manuel, il reçoit toutes les informations de base héritées par les déclinaisons. Vous gérez les déclinaisons dans l’onglet « Varianten » (intitulé allemand). Vous pouvez y saisir, entre autres, une référence, un prix et un stock différents de ceux de l’article parent. La description longue de l’article parent s’affiche pour toutes les déclinaisons, tant qu’une déclinaison n’a pas la sienne.

Le fabricant et la référence fabricant (MPN) se trouvent dans l’onglet « Stamm » (intitulé allemand). Vous choisissez le fabricant dans une liste que vous gérez dans les données de base. Selon le manuel, la vue d’édition d’une déclinaison est presque identique à celle d’un article normal.

Un label GARAN vaut pour un identifiant de modèle. Si toutes les déclinaisons partagent le même, le label sur l’article parent suffit. Si des déclinaisons sont des modèles distincts, chaque modèle a besoin de son propre label. Après la mise en place, vérifiez dans la boutique en ligne si votre modèle affiche, au changement de déclinaison, le label de la déclinaison choisie ou celui de l’article parent.

Pièges fréquents dans OXID eShop

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. La confirmation de commande utilise la page CMS d’identifiant oxuserorderemail, que vous modifiez sous « Kundeninformationen → CMS-Seiten » (intitulé allemand). Le JavaScript ne s’exécute pas dans les e-mails : ajoutez-y le graphique officiel en image. 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.

Sources

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 OXID eShop 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 OXID eShop 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

Puis-je simplement coller le code dans une page CMS ?

Pas de façon fiable. L’éditeur supprime le script, et la page article n’a pas d’emplacement standard où une page CMS apparaîtrait automatiquement. Une petite extension de modèle est la voie sûre.

Dois-je modifier le thème APEX lui-même ?

Non. Un module ou un thème enfant avec {{ parent() }} suffit. Le thème d’origine reste compatible avec les mises à jour, et le bouton d’achat reste tel quel.

Où saisir le label GARAN par article ?

Par exemple comme valeur d’attribut sur l’article, sous « Auswahl → Attribute zuordnen » (intitulé allemand). Le modèle lit alors les adresses et les transmet au widget.

Comment afficher la notice sur toutes les pages dans OXID eShop ?

Dans votre module ou thème enfant, étendez le modèle layout/footer.html.twig, dans le thème APEX par exemple le bloc dd_footer_copyright. Placez-y le code du widget après {{ parent() }}.

La notice reste-t-elle au changement de déclinaison ?

Oui, si elle se trouve dans le bloc details_productmain_tobasket. Au changement de déclinaison, APEX recharge toute la zone de détail, y compris votre extension de bloc, et exécute à nouveau les scripts qu’elle contient.

Dois-je activer le module dans chaque sous-boutique ?

Selon la documentation développeur, vous l’activez pour une sous-boutique avec l’option --shop-id. Vérifiez ensuite chaque sous-boutique dans la boutique en ligne.

Votre label GARAN, gratuitement.

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