En JTL-Shop 5, añades el aviso de garantía legal para todos los artículos mediante la plantilla hija de la página de detalle del artículo. Para artículos sueltos también sirve el OnPage Composer con un portlet de texto en la vista de código fuente.
Novedad desde JTL-Shop 5.8: JTL-Shop trae integradas ambas etiquetas. Las activas en „Darstellung“ → „Einstellungen“ → „Global“ (Presentación → Ajustes → Global), sección „Gewährleistungs- und Garantielabel“ (etiquetas de garantía legal y de garantía). JTL muestra el aviso de garantía legal en el resumen del pedido, en la página „Gesetzliche Gewährleistung“ (garantía legal) del pie de página y como PDF adjunto a la confirmación de pedido, pero según JTL no en la página de detalle del artículo. Para eso está el widget. JTL lee la etiqueta GARAN de los atributos de función de Wawi jtl_guarantee_manufacturer, jtl_guarantee_model_identifier y jtl_guarantee_years.
El código para JTL-Shop
<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 JTL-Shop
- Usa una plantilla hija
Los cambios van en una plantilla hija (para NOVA: NOVAChild) para que las actualizaciones no los sobrescriban. - Amplía la plantilla
En la plantilla hija, amplía la plantilla de la página de detalle del artículo y coloca el código del widget debajo del botón de añadir a la cesta. Así se aplica a todos los artículos. - Artículo suelto
Solo para un artículo: en el OnPage Composer, arrastra un portlet de texto debajo del botón de añadir a la cesta y pega el código en la vista de código fuente. El OnPage Composer edita cada página por separado. - Comprueba
Vacía la caché o publica el borrador y revisa un artículo.
Los nombres de menú entre comillas son los de la interfaz en alemán; entre paréntesis va nuestra traducción.
Lo que conviene saber de JTL-Shop
- Sin el OnPage Composer (JTL-Shop 4), pega el código en la plantilla de la página de detalle del artículo.
- Si la minificación está activa en la plantilla,
widget.jsno debe procesarse con ella; se carga directamente desde garantielabel.app.
Dónde colocar el aviso en JTL-Shop
La plantilla NOVA construye la página de detalle del artículo a partir de productdetails/details.tpl. Ahí, el bloque productdetails-details-include-basket incluye la zona de compra. El botón de añadir al carrito está en productdetails/basket.tpl, en el bloque productdetails-basket-add-to-cart. En la plantilla hija, creas el archivo con la misma ruta y amplías el bloque con append o prepend. Así se conserva el contenido original y la zona de compra no cambia.
Desde JTL-Shop 5.8, la tienda trae integradas las dos etiquetas. Las activas en “Darstellung → Einstellungen → Global” (Presentación → Ajustes → Global), en la sección “Gewährleistungs- und Garantielabel” (aviso de garantía legal y etiqueta de garantía). JTL muestra entonces el aviso de garantía legal en el resumen del pedido y en la página “Gesetzliche Gewährleistung” (garantía legal). JTL añade esta página automáticamente al área del pie de página “Gesetzliche Informationen” (información legal), el grupo de enlaces con el nombre de plantilla “Fuss”. JTL no menciona la página de detalle del artículo para el aviso de garantía legal. Ahí, el widget añade el aviso.
Artículos hijo, atributos de función y etiqueta GARAN
JTL-Wawi distingue entre artículos con variaciones y artículos hijo (antes, combinaciones de variaciones). Las variaciones sin artículos hijo no son artículos independientes, así que muchos ajustes no se pueden hacer por variación. Los artículos hijo, en cambio, son artículos propios. Heredan del artículo padre, por ejemplo, atributos y características, pero se pueden gestionar como artículos normales.
La etiqueta de garantía integrada (etiqueta GARAN) lee tres atributos de función de JTL-Wawi: jtl_guarantee_manufacturer para el productor, jtl_guarantee_model_identifier para el identificador del modelo y jtl_guarantee_years para la duración en años. Desde JTL-Wawi 2.1 ya existen, pero hay que activarlos para la tienda online. Si falta uno de los tres valores, la tienda no muestra ninguna etiqueta de garantía para ese artículo. Si los artículos hijo tienen identificadores del modelo propios, introduce jtl_guarantee_model_identifier en cada artículo hijo.
Eliges por separado dónde aparece la etiqueta: lista de artículos, página de detalle del artículo, carrito, resumen del pedido y confirmación de pedido. En la página de detalle del artículo, se sitúa debajo del número de artículo, el GTIN, la categoría y el fabricante. Si usas la etiqueta de garantía integrada, omite data-garan-voll y data-garan-klein en el widget, porque de lo contrario la etiqueta aparece dos veces.
Errores habituales en JTL-Shop
- Desactivadas por defecto: según JTL, las dos etiquetas están desactivadas al principio. Después de actualizar a 5.8, tienes que activarlas tú.
- Sincronización: los nuevos datos de garantía solo aparecen en la tienda después de una sincronización de la tienda online desde JTL-Wawi.
- Duración de la garantía: según JTL,
jtl_guarantee_yearsindica la duración total desde la compra. Con 3 años, son 3 años en total, no 5. - Plantilla hija: el nombre de la carpeta debe coincidir con el nombre de
template.xml, conNOVAcomo plantilla padre. La plantilla hija solo contiene los archivos modificados. Después de activarla, vacía la caché de plantillas.
Más fuentes
- JTL-Guide: configurar las etiquetas de garantía legal y de garantía en JTL-Shop (en alemán)
- JTL-Guide: ajustes globales en detalle (en alemán)
- JTL-Guide: glosario de artículos (en alemán)
- JTL-Guide: datos maestros del artículo, artículos hijo (en alemán)
- Guía para desarrolladores de JTL: crear una plantilla hija (en alemán)
- JTL-Shop 5.8.1: plantilla NOVA productdetails/details.tpl (GitLab)
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. Las plantillas de correo se gestionan en el back end de JTL-Shop, en las plantillas de correo. El gráfico oficial se puede añadir como imagen a la 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 JTL-Shop como se muestra arriba.
¿Prefieres tus propios archivos? Sube la versión completa y la anidada a la biblioteca de medios de JTL-Shop 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 con datos de JTL-Wawi?
Sí. Si guardas las direcciones de las etiquetas GARAN como atributo del artículo y las muestras en la plantilla en data-garan-voll y data-garan-klein, cada artículo muestra su etiqueta.
¿Necesito un plugin?
No. Basta con la plantilla hija. Un portlet HTML solo existe como plugin del Extension Store, y no lo necesitas.
¿Lo sobrescribirán las actualizaciones?
No, si el cambio está en la plantilla hija. El contenido del OnPage Composer también se conserva.
¿JTL-Shop 5.8 muestra las etiquetas por sí solo?
Sí, en cuanto las activas en “Darstellung → Einstellungen → Global”. Las dos están desactivadas por defecto. El aviso de garantía legal aparece entonces en el resumen del pedido y en la página “Gesetzliche Gewährleistung”, y la etiqueta de garantía en los lugares que elijas.
¿Por qué falta la etiqueta de garantía en un artículo?
Normalmente falta uno de los valores jtl_guarantee_manufacturer, jtl_guarantee_model_identifier o jtl_guarantee_years, o la sincronización de la tienda online aún está pendiente. Comprueba también que los atributos de función estén activados para la tienda online.
¿En qué bloque añado el widget?
Por ejemplo, con append en el bloque productdetails-details-include-basket de productdetails/details.tpl en la plantilla hija. Así queda justo después de la zona de compra.