In JTL-Shop 5 aggiungi l'avviso sulla garanzia legale per tutti gli articoli tramite il child template della pagina di dettaglio dell'articolo. Per singoli articoli funziona anche l'OnPage Composer con un portlet di testo nella vista del codice sorgente.
Novità da JTL-Shop 5.8: JTL-Shop ha entrambe le etichette integrate. Le attivi in “Darstellung” → “Einstellungen” → “Global” (Visualizzazione → Impostazioni → Globale), sezione “Gewährleistungs- und Garantielabel”. JTL mostra l'avviso sulla garanzia legale nel riepilogo dell'ordine, nella pagina “Gesetzliche Gewährleistung” nel piè di pagina e come PDF allegato alla conferma d'ordine, ma secondo JTL non nella pagina di dettaglio del prodotto. A questo serve il widget. JTL legge l'etichetta GARAN dagli attributi funzionali di Wawi jtl_guarantee_manufacturer, jtl_guarantee_model_identifier e jtl_guarantee_years.
Il codice per JTL-Shop
<div data-garantielabel></div>
<script src="https://www.garantielabel.app/widget.js" async></script>Altre opzioni, come visualizzazione e lingua, le imposti nel generatore di codice.
Passo dopo passo in JTL-Shop
- Usa un child template
Le modifiche vanno in un child template (per NOVA: NOVAChild), così gli aggiornamenti non le sovrascrivono. - Estendi il template
Nel child template estendi il template della pagina di dettaglio dell'articolo e inserisci il codice del widget sotto il pulsante di aggiunta al carrello. Da quel momento vale per tutti gli articoli. - Singolo articolo
Per un solo articolo: nell'OnPage Composer trascina un portlet di testo sotto il pulsante di aggiunta al carrello e incolla il codice nella vista del codice sorgente. L'OnPage Composer modifica ogni pagina separatamente. - Controlla
Svuota la cache o pubblica la bozza e controlla un articolo.
I nomi dei menu tra virgolette sono quelli dell'interfaccia tedesca; tra parentesi trovi la traduzione.
Da sapere su JTL-Shop
- Senza l'OnPage Composer (JTL-Shop 4) incolla il codice nel template della pagina di dettaglio dell'articolo.
- Se nel template è attiva la minificazione,
widget.jsnon deve esserne interessato; si carica direttamente da garantielabel.app.
Dove va l’avviso in JTL-Shop
Il template NOVA costruisce la pagina di dettaglio dell’articolo da productdetails/details.tpl. Lì il blocco productdetails-details-include-basket include l’area di acquisto. Il pulsante di aggiunta al carrello si trova in productdetails/basket.tpl, nel blocco productdetails-basket-add-to-cart. Nel template child crei il file con lo stesso percorso ed estendi il blocco con append o prepend. Così il contenuto originale resta e l’area di acquisto non cambia.
Da JTL-Shop 5.8 il negozio ha entrambe le etichette integrate. Le attivi in “Darstellung → Einstellungen → Global” (Visualizzazione → Impostazioni → Globale), nella sezione “Gewährleistungs- und Garantielabel” (avviso sulla garanzia legale ed etichetta di garanzia). JTL mostra allora l’avviso sulla garanzia legale nel riepilogo dell’ordine e nella pagina “Gesetzliche Gewährleistung” (garanzia legale). JTL aggiunge automaticamente questa pagina all’area del footer “Gesetzliche Informationen” (informazioni legali), il gruppo di link con il nome template “Fuss”. JTL non menziona la pagina di dettaglio dell’articolo per l’avviso sulla garanzia legale. Lì è il widget ad aggiungere l’avviso.
Articoli figli, attributi funzione ed etichetta GARAN
JTL-Wawi distingue tra articoli con variazioni e articoli figli (in passato combinazioni di variazioni). Le variazioni senza articoli figli non sono articoli a sé, quindi molte impostazioni non si possono fare per singola variazione. Gli articoli figli invece sono articoli a tutti gli effetti. Ereditano dall’articolo padre, per esempio, attributi e caratteristiche, ma si possono gestire come articoli normali.
L’etichetta di garanzia integrata (etichetta GARAN) legge tre attributi funzione da JTL-Wawi: jtl_guarantee_manufacturer per il produttore, jtl_guarantee_model_identifier per l’identificativo del modello e jtl_guarantee_years per la durata in anni. Da JTL-Wawi 2.1 esistono già, ma devono essere attivati per il negozio online. Se manca uno dei tre valori, il negozio non mostra l’etichetta di garanzia per quell’articolo. Se gli articoli figli hanno identificativi del modello propri, inserisci jtl_guarantee_model_identifier su ogni articolo figlio.
Scegli separatamente dove compare l’etichetta: elenco articoli, pagina di dettaglio dell’articolo, carrello, riepilogo dell’ordine e conferma d’ordine. Nella pagina di dettaglio dell’articolo si trova sotto il numero articolo, il GTIN, la categoria e il produttore. Se usi l’etichetta di garanzia integrata, ometti data-garan-voll e data-garan-klein nel widget, altrimenti l’etichetta compare due volte.
Errori tipici in JTL-Shop
- Disattivate di default: secondo JTL, entrambe le etichette sono inizialmente disattivate. Dopo l’aggiornamento alla 5.8 devi attivarle tu.
- Sincronizzazione: i nuovi dati di garanzia compaiono nel negozio solo dopo una sincronizzazione del negozio online da JTL-Wawi.
- Durata della garanzia: secondo JTL,
jtl_guarantee_yearsindica la durata totale dall’acquisto. Con 3 anni sono 3 anni in tutto, non 5. - Template child: il nome della cartella deve corrispondere al nome in
template.xml, conNOVAcome template padre. Il child contiene solo i file modificati. Dopo l’attivazione, svuota la cache dei template.
Altre fonti
- JTL-Guide: configurare le etichette di garanzia legale e di garanzia in JTL-Shop (in tedesco)
- JTL-Guide: impostazioni globali nel dettaglio (in tedesco)
- JTL-Guide: glossario degli articoli (in tedesco)
- JTL-Guide: dati anagrafici degli articoli, articoli figli (in tedesco)
- Guida per sviluppatori JTL: creare un template child (in tedesco)
- JTL-Shop 5.8.1: template NOVA productdetails/details.tpl (GitLab)
L'avviso sulla garanzia legale nella conferma d'ordine
Secondo gli orientamenti della Commissione, l'avviso dovrebbe comparire anche nell'e-mail di conferma. I modelli e-mail li gestisci nel back end di JTL-Shop, tra i modelli e-mail. La grafica ufficiale si può aggiungere come immagine alla conferma d'ordine. Un semplice link difficilmente vale come supporto durevole (CGUE, causa C-49/11, Content Services); la strada più sicura è inserire l'avviso direttamente nell'e-mail come immagine, testo o allegato. Trovi i file ufficiali nella nostra pagina di download.
Garanzia del produttore? Allora aggiungi l'etichetta GARAN
Se il produttore offre gratuitamente una garanzia commerciale di durabilità superiore a due anni sull'intero bene, anche l'etichetta GARAN va sulla pagina prodotto. Con il generatore di etichette GARAN la crei in pochi secondi da anni, marchio e modello, le prime 3 etichette gratis e senza registrazione. Sotto ogni etichetta pronta ricevi un codice di incorporamento con indirizzi delle immagini permanenti: non carichi nulla e lo incolli in JTL-Shop come mostrato sopra.
Preferisci usare i tuoi file? Allora carica la versione completa e quella annidata nella libreria multimediale di JTL-Shop e inserisci gli indirizzi nel codice del widget:
<div data-garantielabel
data-garan-voll="https://…/GARAN-MX-500.svg"
data-garan-klein="https://…/GARAN-MX-500-annidata.svg"></div>Il widget mostra quindi la versione annidata sotto l'avviso sulla garanzia legale, e un clic apre l'etichetta GARAN completa.
Domande frequenti
Funziona con i dati di JTL-Wawi?
Sì. Se gestisci gli indirizzi delle etichette GARAN come attributo dell'articolo e li mostri nel template in data-garan-voll e data-garan-klein, ogni articolo mostra l'etichetta corrispondente.
Mi serve un plugin?
No. Basta il child template. Un portlet HTML è disponibile solo come plugin nell'Extension Store, e non ti serve.
Gli aggiornamenti lo sovrascrivono?
No, se la modifica è nel child template. Anche i contenuti dell'OnPage Composer vengono mantenuti.
JTL-Shop 5.8 mostra le etichette da solo?
Sì, una volta attivate in “Darstellung → Einstellungen → Global”. Di default sono entrambe disattivate. L’avviso sulla garanzia legale compare poi nel riepilogo dell’ordine e nella pagina “Gesetzliche Gewährleistung”, l’etichetta di garanzia nei punti che scegli.
Perché per un articolo manca l’etichetta di garanzia?
Di solito manca uno dei valori jtl_guarantee_manufacturer, jtl_guarantee_model_identifier o jtl_guarantee_years, oppure la sincronizzazione del negozio online non è ancora avvenuta. Controlla anche che gli attributi funzione siano attivati per il negozio online.
In quale blocco inserisco il widget?
Per esempio con append nel blocco productdetails-details-include-basket di productdetails/details.tpl nel template child. Così si trova subito dopo l’area di acquisto.