Fonctionnalités
- Un élément details Passeport produit dans le formulaire d’édition, visible uniquement des rôles ayant la permission Administrer les passeports produit
- Des réglages dans Commerce › Configuration › Passeport produit, conservés dans l’objet de configuration ecom_addons_product_passport.settings
- Un bloc passeport ajouté au mode d’affichage complet des produits, avec des cache tags invalidés à chaque enregistrement d’un passeport
- Les routes /product-passport/{commerce_product}, son qr.svg et /01/{GTIN}, servies par le contrôleur du module et mises en cache selon la langue de l’interface
- Écrit avec les classes de hooks par attribut #[Hook] de Drupal 11 ; seule dépendance : commerce_product
- Une clé GTIN fausse, un numéro CAS invalide, une composition au-delà de 100 % ou un lien mal formé sont refusés à l’enregistrement, et le passeport reste non publié
- Traductions de l’interface en espagnol et en français livrées en fichiers .po
Drupal Commerce vous laisse modéliser produits, variations et attributs comme vous l’entendez, mais rien n’est prévu d’origine pour noter où un article a été fabriqué, ses matériaux, les substances qu’il contient ou comment le réparer et le recycler, ni pour en faire une page qu’un QR code peut ouvrir. Ce module ajoute les deux à votre boutique.
Comment il s’intègre à Drupal Commerce
- Formulaire produit
- En modifiant un produit dans Commerce › Produits, vous trouvez une section Passeport produit, ouverte par défaut. Les utilisateurs sans la permission Administrer les passeports produit ne la voient pas. Une fois le passeport publié, la section affiche le QR code, un lien vers la page publique et un téléchargement SVG.
- Configuration
- Commerce › Configuration › Passeport produit (
/admin/commerce/config/product-passport) regroupe deux choix : la cible des QR codes (page du passeport ou GS1 Digital Link) et l’affichage d’un bloc Passeport produit sur la page produit. Les deux sont stockés en configuration simple. - Rendu
- Le bloc est ajouté lorsque le produit s’affiche dans son mode d’affichage complet. Enregistrer un passeport invalide le cache tag de ce produit : les changements apparaissent tout de suite, même avec le cache de pages activé.
- Routes publiques
- La page du passeport et son QR code passent par des routes propres au module, avec des données schema.org et sans JavaScript ; la page suit la langue de l’interface et le QR code encode toujours l’URL de la langue par défaut.
- Stockage
- Une ligne par produit dans la table
ecom_addons_product_passport; la désinstallation supprime la table et la configuration. - Prérequis
- Drupal 11.3, Commerce 3.x (Product), PHP 8.3 ou plus récent.
Avec l’ESPR, le règlement (UE) 2024/1781, l’UE crée le passeport numérique des produits ; pour chaque groupe de produits, un acte délégué fixe les données obligatoires. Le module enregistre et publie ce que vous saisissez, sans vous dire lequel de ces actes vise votre catalogue : cette vérification vous revient.
Installation
- Étape 1
Téléchargez l’archive dans Mon compte › Téléchargements sur ecom-addons.com.
- Étape 2
Décompressez-la dans
modules/custom/, pour obtenir le dossiermodules/custom/ecom_addons_product_passport. - Étape 3
Activez Product Passport & QR dans Étendre, ou lancez
drush en ecom_addons_product_passport. - Étape 4
Dans Personnes › Droits, accordez Administrer les passeports produit aux rôles qui gèrent le catalogue.
Questions fréquentes
Le passeport est-il stocké sur le produit ou sur chaque variation ?
Sur le produit Commerce : toutes ses variations partagent une seule page de passeport et un seul QR code.
Peut-on traduire les champs de texte libre ?
Pas encore. Les libellés de la page suivent la langue de l’interface, mais les valeurs saisies sont identiques dans toutes les langues.
Qui peut modifier les passeports ?
Seuls les rôles ayant la permission Administrer les passeports produit ; la page publique et le QR code sont visibles de tous dès que le passeport est publié.
Historique des versions
- Chargement…
Avis
Chargement…
Vous l’avez acheté ? Laissez un avis depuis votre compte.


