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
- Module ou thème enfant
L’extension va dans un petit module ou un thème enfant (danstheme.phpavec'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. - Étendre le bloc
Étendez le modèlepage/details/inc/productmain.html.twiget, dans le blocdetails_productmain_tobasket, placez le code du widget après{{ parent() }}. Avecparent(), le bouton d’ajout au panier reste inchangé. - 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 dansdata-garan-volletdata-garan-klein. - Vider le cache
Videz le cache des modèles avecvendor/bin/oe-console oe:cache:clearet 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
- L’éditeur des pages CMS supprime
<script>. À partir d’OXID 7.5 s’y ajoute un HTML Sanitizer qui, s’il est activé, supprime les scripts. Le code doit donc aller dans le modèle. - Par défaut, les attributs attribués apparaissent aussi dans la liste des caractéristiques produit de la page de détail. Masquez-y au besoin les deux attributs GARAN dans le modèle.
- OXID 6 avec les thèmes Smarty Flow et Wave : le bloc porte le même nom. Les modules s’y accrochent via
blocksdansmetadata.php; le modèle estpage/details/inc/productmain.tpl.
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
- Cache des modèles : Selon OXID, les modifications de modèles, de configuration ou de modules ne s’appliquent souvent correctement qu’après avoir vidé le cache. Outre la commande console ci-dessus, le module OXID Admin Tools vide le cache des modèles sous « Service → Tools ». Il contient les modèles Twig compilés.
- Varnish : Avec le reverse proxy Varnish, un serveur à part garde les pages en cache. OXID découpe pour cela les pages en sections, appelées widgets. Ne vérifiez votre modification qu’une fois que ce cache livre aussi la nouvelle version. C’est en général votre agence ou votre hébergeur qui le vide.
- Sous-boutiques : Selon la documentation développeur, vous activez un module pour une sous-boutique avec l’option
--shop-id, soitvendor/bin/oe-console oe:module:activate <id-du-module> --shop-id=<id-de-la-boutique>. Vérifiez ensuite chaque sous-boutique séparément. - Contenus CMS par langue : Selon le manuel, vous gérez les pages CMS séparément pour chaque langue, via la sélection « In Sprache » (intitulé allemand). Une extension de modèle, elle, ne se fait qu’une fois.
Autres sources
- Manuel OXID : article, onglet Varianten, en allemand
- Manuel OXID : article, onglet Stamm, en allemand
- OXID Admin Tools : vider le cache, en anglais
- Manuel OXID : reverse proxy Varnish, en anglais
- Documentation développeur OXID : activer un module, aussi pour une sous-boutique, en anglais
- Thème APEX sur GitHub : modèle du pied de page
- Thème APEX sur GitHub : script de sélection des déclinaisons
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
- Documentation développeur OXID : étendre un bloc d’un thème actif, en anglais
- Documentation développeur OXID : créer un thème enfant, en anglais
- Documentation développeur OXID : HTML Sanitizer (7.5), en anglais
- Manuel OXID : article, onglet Auswahl, en allemand
- Manuel OXID : pages CMS, en allemand
- Thème APEX sur GitHub (modèle de la page article)
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.