In PrestaShop aggiungi l'avviso sulla garanzia legale tramite il template della pagina prodotto in un tema child, oppure tramite un modulo che mostra HTML nell'hook delle informazioni aggiuntive sul prodotto.
Il codice per PrestaShop
<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 PrestaShop
- Usa un tema child
Le modifiche al tema vanno in un tema child, così gli aggiornamenti non le sovrascrivono. - Scegli il punto
Intemplates/catalog/product.tpltrova l'area sotto il pulsante Aggiungi al carrello. - Incolla il codice
Incolla lì il codice del widget. In alternativa usa un modulo per blocchi HTML dal marketplace Addons nell'hookdisplayProductAdditionalInfo. - Svuota la cache
Svuota la cache in Advanced Parameters → Performance e controlla.
I nomi dei menu sono riportati come nell'interfaccia inglese; nella versione italiana possono essere diversi.
Da sapere su PrestaShop
- Smarty interpreta le parentesi graffe. Il codice del widget non ne contiene, quindi puoi incollarlo direttamente.
- Se nelle impostazioni delle prestazioni è attiva la “Smart cache for JavaScript”, lo script esterno ne resta fuori.
Dove va l’avviso in PrestaShop
PrestaShop inserisce i contenuti tramite hook. Secondo la documentazione per sviluppatori, questi tre si trovano nei punti seguenti dei temi Classic e Hummingbird:
displayProductAdditionalInfo(“Product page additional info”) si trova incatalog/_partials/product-additional-info.tpl. Nel tema Classic,product.tplinclude questo file subito dopo l’area di aggiunta al carrello. È il punto giusto per l’avviso nella pagina prodotto.displayReassurancesi trova incatalog/product.tpl, ma anche incheckout/cart.tplecheckout/checkout.tpl. Un modulo su questo hook compare quindi nella pagina prodotto, nel carrello e al checkout.displayFootersi trova in_partials/footer.tple compare quindi su tutte le pagine.
Agganci un modulo a un hook in “Design → Positions” (etichette della versione inglese del pannello), con il pulsante in alto a destra (“Transplant a module”). Per il footer c’è anche il modulo “Link list” (“Design → Link Widget”). Collega pagine di “Design → Pages” in blocchi di link; nel tema Classic i blocchi si trovano nel footer. Una tua pagina con il widget compare così come link nel footer.
Combinazioni, marchio e identificativo del modello
In PrestaShop le varianti si chiamano combinazioni. Quando crei il prodotto scegli il tipo “Product with combinations” e compare la scheda “Combinations”. Ogni combinazione ha i propri riferimenti: riferimento, più ISBN, EAN e UPC. Secondo la documentazione del webservice, ogni combinazione ha anche un proprio campo MPN.
Il marchio invece appartiene al prodotto. Secondo PrestaShop, un prodotto ha esattamente un marchio, gestito in “Brands & Suppliers”. Tutte le combinazioni condividono quindi il marchio. L’MPN nella scheda “Details” è il riferimento univoco del produttore. Se corrisponde all’identificativo del modello sull’etichetta GARAN lo ricavi dalle informazioni del produttore.
L’etichetta GARAN riporta il marchio e l’identificativo del modello, quindi c’è un’etichetta per ogni identificativo del modello. Il widget mostra un’etichetta GARAN per segnaposto e non cambia con la combinazione selezionata. Se le combinazioni hanno identificativi del modello diversi, crea questi modelli come prodotti separati, ognuno con la propria etichetta.
Errori tipici in PrestaShop
- Cache dei template: Se in “Advanced Parameters → Performance” è impostato di non ricompilare mai i file dei template, il negozio mostra le modifiche al tema solo dopo aver svuotato la cache.
- Tema figlio: In
config/theme.yml,parentcontiene il nome della cartella del tema padre, non il suo nome visualizzato. Il tuonamedeve corrispondere al nome della tua cartella. - Altri temi: Le posizioni degli hook indicate sopra valgono per Classic e Hummingbird. Un altro tema può mostrare gli hook altrove o non mostrarli affatto. Controlla in “Design → Positions” quali hook mostra il tuo tema.
- Modulo senza metodo: Secondo la documentazione per sviluppatori, un modulo agganciato a un hook per cui non ha il metodo corrispondente non mostra nulla.
Altre fonti
- Documentazione per sviluppatori PrestaShop: List of hooks (in inglese)
- Tema Classic di PrestaShop: catalog/product.tpl (GitHub)
- Documentazione per sviluppatori PrestaShop: Displaying content on the front office (in inglese)
- Documentazione PrestaShop: Link Widget (in inglese)
- Documentazione PrestaShop: Managing products (in inglese)
- Documentazione per sviluppatori PrestaShop: risorsa webservice Combinations (in inglese)
- Documentazione PrestaShop: Performance (in inglese)
- Documentazione per sviluppatori PrestaShop: Creating a child theme (in inglese)
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 modifichi in International → Translations o in Design → Email Theme. 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 PrestaShop come mostrato sopra.
Preferisci usare i tuoi file? Allora carica la versione completa e quella annidata nella libreria multimediale di PrestaShop 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
Esiste un modulo pronto?
Non ti serve un modulo apposito. Basta il template nel tema child; in alternativa un modulo per blocchi HTML dal marketplace Addons.
Funziona in PrestaShop 1.7, 8 e 9?
Sì, allo stesso modo in tutte e tre le versioni.
Devo svuotare la cache?
Sì, dopo aver modificato il template.
Quale hook mostra l’avviso anche nel carrello?
displayReassurance. In Classic e Hummingbird si trova nella pagina prodotto, nel carrello e al checkout.
Ogni combinazione ha un proprio identificativo del modello?
Ogni combinazione ha i propri riferimenti (riferimento, ISBN, EAN, UPC e, secondo la documentazione del webservice, MPN). Il marchio invece vale per l’intero prodotto.
Come inserisco l’avviso nel footer?
Con un modulo sull’hook displayFooter, oppure come link: crea una pagina con il widget in “Design → Pages” e collegala nel footer con il modulo “Link list”.