In Shopware 6 posizioni il segnaposto nel layout della pagina prodotto tramite le Shopping Experiences. Lo script lo carichi tramite il tema o un plugin per script personalizzati, perché da Shopware 6.5 l'editor rimuove gli script dagli elementi di testo.
Novità da Shopware 6.7.14 (e 6.6.10.24): Shopware ha l'etichetta GARAN integrata. Inserisci la durata della garanzia nel prodotto; marchio e identificativo del modello derivano dal produttore e dal codice prodotto del produttore. Il widget aggiunge l'avviso sulla garanzia legale nella pagina prodotto. Ometti data-garan-* nel widget, così l'etichetta GARAN non compare due volte. Dettagli più sotto, in “Varianti e identificativo del modello”.
Il codice per Shopware 6
<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 Shopware 6
- Apri la Shopping Experience
Nell'amministrazione vai su Content → Shopping Experiences e apri il layout delle tue pagine prodotto, oppure creane uno nuovo di tipo “Product page”. - Inserisci il segnaposto
Sotto il riquadro di acquisto aggiungi un blocco con un elemento di testo, passa alla vista del codice sorgente e inserisci<div data-garantielabel></div>. - Carica lo script
Aggiungi la riga conwidget.jstramite il tema (ad esempio inbase.html.twig) o tramite un plugin per script personalizzati, poi salva il layout e assegnalo ai prodotti. - Alternativa nel tema
Gli sviluppatori estendono nel proprio tema il template del riquadro di acquisto (buy-widget.html.twig) con il segnaposto e caricano lo script nell'intestazione del template.
I nomi dei menu sono riportati come nell'interfaccia inglese; nella versione italiana possono essere diversi.
Da sapere su Shopware 6
- Dalla versione 6.5 Shopware filtra gli script nell'elemento di testo (HTML sanitizer). Si può disattivare solo nei negozi self-hosted; in Shopware Cloud la strada resta il tema o un plugin.
- Se usi una tua Content Security Policy,
www.garantielabel.appdeve essere consentito per script, immagini e connessioni.
Dove va l’avviso in Shopware 6
In Shopware la pagina prodotto è una Shopping Experience di tipo “Product page”. Di default contiene la Buybox con la galleria di immagini e la descrizione del prodotto. Sono disponibili anche elementi come “Product name & manufacturer logo” e Cross Selling. Il layout si assegna nella scheda “Layout” del prodotto. Per renderlo il layout predefinito delle nuove pagine prodotto, usa “Layout assignment → Default layouts” nella barra laterale.
Nel tema la Buybox proviene dal template buy-widget.html.twig, in Shopware 6.7 in storefront/component/buy-widget/. I tuoi template li crei in un plugin o in un tema in Resources/views con la stessa struttura di cartelle ed estendi l’originale con sw_extends.
Per il footer, seleziona nelle impostazioni del canale di vendita l’“Entry point footer navigation”. Nel tema standard il livello sottostante fornisce i titoli e quello ancora sotto i link. Gli sviluppatori invece estendono il template layout/footer/footer.html.twig e vi aggiungono il widget con data-darstellung="link".
Varianti, codice prodotto del produttore ed etichetta GARAN
Le varianti si creano nella scheda “Variants” del prodotto con il generatore di varianti. Prima servono delle proprietà in “Products → Properties”. Le varianti ereditano dal prodotto principale dati come nome e descrizione. L’icona della catena rimuove l’ereditarietà per una variante.
Da Shopware 6.7.14 e 6.6.10.24, Shopware mostra da sé l’etichetta GARAN. Il prodotto ha un riquadro “Guarantee (GARAN Label)” con “Producer guarantee duration in months” (da 30 a 600, a passi di 6) e l’interruttore “Show label in Storefront”. Il marchio proviene dal campo “Manufacturer”, l’identificativo del modello dal “Manufacturer product number” nella scheda “General”. Se uno dei due manca, Shopware non mostra alcuna etichetta. Secondo Shopware, i campi della garanzia si possono impostare sul prodotto principale e sovrascrivere per ogni variante. Se le tue varianti hanno identificativi del modello propri, inserisci il codice prodotto del produttore in ogni variante.
L’etichetta GARAN compare poi sotto la Buybox, nel carrello, nella pagina di conferma dell’ordine e nell’e-mail di conferma d’ordine. Shopware inserisce il link all’avviso sulla garanzia legale nella pagina di conferma dell’ordine, accanto al testo delle condizioni generali. Shopware non descrive una visualizzazione nella pagina prodotto: lì e nel footer è il widget ad aggiungere l’avviso. Se il tuo negozio online usa l’etichetta GARAN integrata, ometti data-garan-voll e data-garan-klein nel widget, altrimenti l’etichetta compare due volte.
Errori tipici in Shopware
- Cache: dopo aver modificato i template, svuota la cache, per esempio con
bin/console cache:clear. Il tema deve essere assegnato al canale di vendita giusto nella scheda “Theme”. - E-mail d’ordine personalizzata: l’aggiornamento ha esteso il template della conferma d’ordine solo se non era mai stato modificato. Secondo Shopware, i template personalizzati non ricevono automaticamente l’etichetta GARAN e il link all’avviso.
- Testo delle condizioni sovrascritto: dopo l’aggiornamento il link all’avviso sulla garanzia legale è attivo (“Show legal guarantee notice on checkout page”). Se nel tuo tema hai sovrascritto il testo delle condizioni della pagina di conferma dell’ordine, secondo Shopware devi adattare quella sovrascrittura.
- Più canali di vendita: l’impostazione dell’avviso sulla garanzia legale si può sovrascrivere per ogni canale di vendita. Controlla ogni canale separatamente.
Altre fonti
- Shopware: GARAN label and EU guarantee requirements (in inglese)
- Changelog di Shopware 6.6.10.24: EU harmonised guarantee label (GitHub, in inglese)
- Release di Shopware 6.7.14.0 (GitHub, in inglese)
- Template di Shopware buy-widget.html.twig (GitHub)
- Documentazione di Shopware: Shopping Experiences (in inglese)
- Documentazione di Shopware: Products (in inglese)
- Documentazione di Shopware: Sales channels (in inglese)
- Documentazione per sviluppatori di Shopware: Customize templates (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. In Shopware modifichi i modelli e-mail in Settings → Email templates. La grafica ufficiale si può aggiungere come immagine al modello della 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 Shopware 6 come mostrato sopra.
Preferisci usare i tuoi file? Allora carica la versione completa e quella annidata nella libreria multimediale di Shopware 6 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 anche in Shopware 5?
Sì, tramite un elemento Shopping World o il file del template della pagina di dettaglio. Tuttavia Shopware 5 non è più supportato da luglio 2024.
Devo farlo per ogni prodotto?
No. Nel layout della pagina prodotto il codice vale per tutti i prodotti a cui è assegnato il layout.
Interferisce con il riquadro di acquisto?
No. Il widget disegna solo all'interno del proprio segnaposto e non modifica nulla al di fuori.
Mi serve il widget se Shopware mostra già l’etichetta GARAN?
Per l’etichetta GARAN no. Da Shopware 6.7.14 o 6.6.10.24 se ne occupa Shopware stesso. Shopware inserisce il link all’avviso sulla garanzia legale nella pagina di conferma dell’ordine. Per la pagina prodotto e il footer il widget resta utile, in quel caso senza data-garan-….
Quale campo usa Shopware come identificativo del modello?
Il codice prodotto del produttore (“Manufacturer product number”) nella scheda “General”. Il marchio proviene dal campo “Manufacturer”.
Perché Shopware non mostra l’etichetta GARAN?
Shopware la mostra solo se “Show label in Storefront” è attivo e sono impostati la durata della garanzia, il produttore e il codice prodotto del produttore.