Características
- Un elemento details Pasaporte de producto en el formulario de edición, visible solo para los roles con el permiso Administrar los pasaportes de producto
- Ajustes en Commerce › Configuración › Pasaporte de producto, guardados en el objeto de configuración ecom_addons_product_passport.settings
- Bloque de pasaporte añadido al modo de visualización completo de los productos, con etiquetas de caché que se invalidan al guardar cada pasaporte
- Rutas /product-passport/{commerce_product}, su qr.svg y /01/{GTIN}, servidas por el controlador del módulo y cacheadas según el idioma de la interfaz
- Construido con clases de hooks por atributo #[Hook] de Drupal 11; su única dependencia es commerce_product
- Se rechazan al guardar los dígitos de control de GTIN erróneos, los números CAS inválidos, las composiciones de más del 100 % y los enlaces mal formados, y ese pasaporte no se publica
- Traducciones de la interfaz al español y al francés incluidas como archivos .po
Drupal Commerce te deja modelar productos, variaciones y atributos como quieras, pero de serie no hay dónde anotar dónde se fabricó un artículo, sus materiales, las sustancias que contiene o cómo repararlo y reciclarlo, ni nada que convierta esos datos en una página que abra un código QR. Este módulo añade las dos cosas a tu tienda.
Cómo encaja en Drupal Commerce
- Formulario de producto
- Al editar un producto en Commerce › Productos aparece la sección Pasaporte de producto, abierta por defecto. Quien no tenga el permiso Administrar los pasaportes de producto no la ve. Con el pasaporte publicado, la sección muestra el QR, un enlace a la página pública y la descarga en SVG.
- Configuración
- Commerce › Configuración › Pasaporte de producto (
/admin/commerce/config/product-passport) reúne dos opciones: adónde apuntan los QR (página del pasaporte o GS1 Digital Link) y si la página del producto muestra un bloque Pasaporte de producto. Ambas se guardan como configuración simple. - Renderizado
- El bloque se añade cuando el producto se muestra en su modo de visualización completo. Guardar un pasaporte invalida la etiqueta de caché de ese producto, así que los cambios se ven al momento aunque la caché de páginas esté activa.
- Rutas públicas
- La página del pasaporte y su QR salen de rutas propias del módulo, con datos schema.org y sin JavaScript; la página sigue el idioma de la interfaz y el QR codifica siempre la URL del idioma por defecto.
- Almacenamiento
- Una fila por producto en la tabla
ecom_addons_product_passport; al desinstalar se eliminan la tabla y la configuración. - Requisitos
- Drupal 11.3, Commerce 3.x (Product) y PHP 8.3 o superior.
Con el ESPR, el Reglamento (UE) 2024/1781, la UE crea el pasaporte digital de producto; para cada grupo de productos, un acto delegado fija los datos obligatorios. El módulo guarda y publica lo que introduces, sin indicarte cuál de esos actos afecta a tu catálogo: esa comprobación sigue siendo tuya.
Instalación
- Paso 1
Descarga el archivo desde Mi cuenta › Descargas en ecom-addons.com.
- Paso 2
Descomprímelo en
modules/custom/, de forma que el módulo quede enmodules/custom/ecom_addons_product_passport. - Paso 3
Activa Product Passport & QR en Ampliar, o ejecuta
drush en ecom_addons_product_passport. - Paso 4
En Personas › Permisos, concede Administrar los pasaportes de producto a los roles que editan el catálogo.
Preguntas frecuentes
¿El pasaporte se guarda en el producto o en cada variación?
En el producto de Commerce: todas sus variaciones comparten una misma página de pasaporte y un mismo QR.
¿Se pueden traducir los campos de texto libre?
Todavía no. Las etiquetas de la página siguen el idioma de la interfaz, pero los valores que escribes son los mismos en todos los idiomas.
¿Quién puede editar los pasaportes?
Solo los roles con el permiso Administrar los pasaportes de producto; la página pública y el QR los ve cualquiera en cuanto el pasaporte está publicado.
Historial de versiones
- Cargando…
Opiniones
Cargando…
¿Lo has comprado? Deja tu opinión desde tu cuenta.


