En Shopware 6, colocas el marcador en el diseño de la página de producto mediante Shopping Experiences. El script lo cargas a través del tema o de un plugin para scripts propios, porque desde Shopware 6.5 el editor elimina los scripts de los elementos de texto.
Novedad desde Shopware 6.7.14 (y 6.6.10.24): Shopware trae integrada la etiqueta GARAN. Introduces la duración de la garantía en el producto; la marca y el identificador del modelo salen del fabricante y del número de producto del fabricante. El widget añade el aviso de garantía legal en la página de producto. No uses data-garan-* en el widget para que la etiqueta GARAN no aparezca dos veces. Detalles más abajo, en el apartado sobre variantes.
El código para Shopware 6
<div data-garantielabel></div>
<script src="https://www.garantielabel.app/widget.js" async></script>Más opciones, como la forma de mostrarlo y el idioma, las ajustas en el generador de código.
Paso a paso en Shopware 6
- Abre la Shopping Experience
En la Administración, ve a “Content” → “Shopping Experiences” (Contenido → Experiencias de compra) y abre el diseño de tus páginas de producto, o crea uno nuevo del tipo “Product page” (página de producto). - Inserta el marcador
Debajo de la caja de compra, añade un bloque con un elemento de texto, cambia a la vista de código fuente e inserta<div data-garantielabel></div>. - Carga el script
Añade la línea conwidget.jsa través del tema (por ejemplo, enbase.html.twig) o de un plugin para scripts propios; después guarda el diseño y asígnalo a los productos. - Alternativa en el tema
Los desarrolladores amplían en su propio tema la plantilla de la caja de compra (buy-widget.html.twig) con el marcador y cargan el script en la cabecera de la plantilla.
Los nombres de menú entre comillas son los de la interfaz en inglés; entre paréntesis va nuestra traducción.
Lo que conviene saber de Shopware 6
- A partir de la versión 6.5, Shopware filtra los scripts en el elemento de texto (HTML sanitizer). Esto solo se puede desactivar en tiendas autoalojadas; en Shopware Cloud, el camino sigue siendo el tema o un plugin.
- Si usas tu propia Content Security Policy,
www.garantielabel.appdebe estar permitido para scripts, imágenes y conexiones.
Dónde colocar el aviso en Shopware 6
En Shopware, la página de producto es una Shopping Experience del tipo “Product page”. De forma predeterminada contiene la Buybox con la galería de imágenes del producto y la descripción del producto. También están disponibles elementos como “Product name & manufacturer logo” y Cross Selling. El layout se asigna en la pestaña “Layout” del producto. Para que sea el predeterminado de las nuevas páginas de producto, usa “Layout assignment → Default layouts” en la barra lateral.
En el tema, la Buybox procede de la plantilla buy-widget.html.twig, en Shopware 6.7 en storefront/component/buy-widget/. Tus propias plantillas las creas en un plugin o tema en Resources/views con la misma estructura de carpetas y amplías la original con sw_extends.
Para el pie de página, selecciona en los ajustes del canal de venta el “Entry point footer navigation”. En el tema estándar, el nivel inferior aporta los títulos y el nivel siguiente, los enlaces. Los desarrolladores, en cambio, amplían la plantilla layout/footer/footer.html.twig y añaden ahí el widget con data-darstellung="link".
Variantes, número de producto del fabricante y etiqueta GARAN
Las variantes se crean en la pestaña “Variants” del producto con el generador de variantes. Antes necesitas propiedades en “Products → Properties”. Las variantes heredan del producto principal datos como el nombre y la descripción. El icono de la cadena elimina la herencia para una variante.
Desde Shopware 6.7.14 y 6.6.10.24, Shopware muestra la etiqueta GARAN por sí mismo. El producto tiene una tarjeta “Guarantee (GARAN Label)” con “Producer guarantee duration in months” (de 30 a 600, en pasos de 6) y el interruptor “Show label in Storefront”. La marca procede del campo “Manufacturer” y el identificador del modelo, del “Manufacturer product number” de la pestaña “General”. Si falta uno de los dos, Shopware no muestra ninguna etiqueta. Según Shopware, los campos de garantía se pueden definir en el producto principal y sobrescribir por variante. Si tus variantes tienen identificadores del modelo propios, introduce el número de producto del fabricante en cada variante.
La etiqueta GARAN aparece entonces debajo de la Buybox, en el carrito, en la página de confirmación del pedido y en el correo electrónico de confirmación de pedido. Shopware enlaza el aviso de garantía legal en la página de confirmación del pedido, junto al texto de las condiciones generales. Shopware no describe que se muestre en la página de producto: ahí y en el pie de página, el widget añade el aviso. Si tu tienda usa la etiqueta GARAN integrada, omite data-garan-voll y data-garan-klein en el widget, porque de lo contrario la etiqueta aparece dos veces.
Errores habituales en Shopware
- Caché: después de cambiar plantillas, vacía la caché, por ejemplo con
bin/console cache:clear. El tema debe estar asignado al canal de venta correcto en la pestaña “Theme”. - Correo de pedido personalizado: la actualización solo amplió la plantilla de confirmación de pedido si nunca se había editado. Según Shopware, las plantillas personalizadas no reciben automáticamente la etiqueta GARAN ni el enlace al aviso.
- Texto de condiciones sobrescrito: el enlace al aviso de garantía legal queda activado tras la actualización (“Show legal guarantee notice on checkout page”). Si sobrescribiste en tu tema el texto de condiciones de la página de confirmación del pedido, Shopware indica que debes adaptar esa sobrescritura.
- Varios canales de venta: el ajuste del aviso de garantía legal se puede sobrescribir por canal de venta. Revisa cada canal por separado.
Más fuentes
- Shopware: GARAN label and EU guarantee requirements (en inglés)
- Changelog de Shopware 6.6.10.24: EU harmonised guarantee label (GitHub, en inglés)
- Versión de Shopware 6.7.14.0 (GitHub, en inglés)
- Plantilla de Shopware buy-widget.html.twig (GitHub)
- Documentación de Shopware: Shopping Experiences (en inglés)
- Documentación de Shopware: Products (en inglés)
- Documentación de Shopware: Sales channels (en inglés)
- Documentación para desarrolladores de Shopware: Customize templates (en inglés)
Aviso de garantía legal en la confirmación de pedido
Según las directrices de la Comisión, el aviso también debería aparecer en el correo de confirmación. En Shopware, las plantillas de correo se editan en “Settings” → “Email templates” (Ajustes → Plantillas de correo). El gráfico oficial se puede añadir como imagen a la plantilla de confirmación de pedido. Es poco probable que un simple enlace cuente como soporte duradero (TJUE, asunto C-49/11, Content Services); lo más seguro es poner el aviso directamente en el correo como imagen, texto o adjunto. Encontrarás los archivos oficiales en nuestra página de descargas.
¿Garantía del productor? Entonces añade la etiqueta GARAN
Si el productor da gratis una garantía comercial de durabilidad de más de dos años que cubre la totalidad del bien, la etiqueta GARAN también va en la página de producto. Con el generador de etiquetas GARAN la creas en segundos a partir de los años, la marca y el modelo; tus primeras 3 etiquetas son gratis y sin registro. Debajo de cada etiqueta terminada recibes un código para insertar con direcciones de imagen permanentes: no subes nada y lo pegas en Shopware 6 como se muestra arriba.
¿Prefieres tus propios archivos? Sube la versión completa y la anidada a la biblioteca de medios de Shopware 6 e introduce las direcciones en el código del widget:
<div data-garantielabel
data-garan-voll="https://…/GARAN-MX-500.svg"
data-garan-klein="https://…/GARAN-MX-500-anidada.svg"></div>El widget muestra entonces la versión anidada debajo del aviso de garantía legal, y un clic abre la etiqueta GARAN completa.
Preguntas frecuentes
¿Funciona también en Shopware 5?
Sí, mediante un elemento de Shopping World o el archivo de plantilla de la página de detalle. Sin embargo, Shopware 5 no tiene soporte desde julio de 2024.
¿Tengo que hacerlo para cada producto?
No. En el diseño de la página de producto, el código se aplica a todos los productos a los que está asignado el diseño.
¿Interfiere con la caja de compra?
No. El widget solo dibuja dentro de su marcador y no cambia nada fuera de él.
¿Necesito el widget si Shopware ya muestra la etiqueta GARAN?
Para la etiqueta GARAN, no. Desde Shopware 6.7.14 o 6.6.10.24, Shopware se encarga por sí mismo. Shopware enlaza el aviso de garantía legal en la página de confirmación del pedido. Para la página de producto y el pie de página, el widget sigue siendo útil, en ese caso sin data-garan-….
¿Qué campo usa Shopware como identificador del modelo?
El número de producto del fabricante (“Manufacturer product number”) de la pestaña “General”. La marca procede del campo “Manufacturer”.
¿Por qué Shopware no muestra ninguna etiqueta GARAN?
Shopware solo la muestra si “Show label in Storefront” está activado y están definidos la duración de la garantía, el fabricante y el número de producto del fabricante.