Aggiungi l'avviso sulla garanzia legale su Magento / Adobe Commerce

Il codice per Magento / Adobe Commerce

<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 Magento / Adobe Commerce

1. Crea un blocco CMS
   In Content → Blocks crea un nuovo blocco e incolla il codice del widget. Dalla versione 2.4.3 si apre Page Builder; lì usa l'elemento “HTML Code”.
2. Crea un widget
   In Content → Elements → Widgets crea un widget di tipo “CMS Static Block” per il tuo tema.
3. Posizionalo
   Come layout update scegli “All Product Types” e seleziona il contenitore “Product View Extra Hint”. Si trova sotto il pulsante Aggiungi al carrello.
4. Svuota la cache
   Salva, svuota la cache e controlla una pagina prodotto.

I nomi dei menu sono riportati come nell'interfaccia inglese; nella versione italiana possono essere diversi.

Da sapere su Magento / Adobe Commerce

• Con una Content Security Policy attiva (modulo Magento_Csp), www.garantielabel.app deve essere nella whitelist per script, immagini e connessioni.
• Il bundling e la minificazione di JavaScript non dovrebbero includere lo script esterno.

Dove va l’avviso in Magento

Tutte le pagine prodotto usano il file di layout catalog_product_view.xml. A questo si aggiungono file per tipo di prodotto, come catalog_product_view_type_configurable.xml, e per singolo prodotto, come catalog_product_view_sku_{sku}.xml. La colonna con prezzo e area di acquisto è il container product.info.main. Contiene product.info.extrahint, che nel modulo del widget si chiama “Product View Extra Hint”.

Nell’Admin crei i widget in “Content → Elements → Widgets”. “Display On” definisce il tipo di pagina, “Container” l’area della pagina. Per le pagine prodotto scegli “All Product Types” o un singolo tipo di prodotto. Per l’avviso nel footer, aggiungi un secondo layout update: “All Pages” con il container “Page Footer”, preferibilmente con data-darstellung="link".

Prodotti configurabili e identificativo del modello

Un prodotto configurabile appare come un unico prodotto con opzioni a discesa. Secondo Adobe, ogni variazione è un prodotto semplice separato con il proprio SKU. Il prodotto configurabile in sé è la cornice, e il suo prezzo deriva dalle variazioni.

La documentazione di Adobe non indica un campo dedicato all’identificativo del modello. Per questo crei un attributo prodotto in “Stores → Attributes → Product” e poi lo aggiungi al tuo set di attributi in “Stores → Attributes → Attribute Set”. Con “Visible on Catalog Pages on Storefront” impostato su “Yes”, compare nella pagina prodotto. Poiché ogni variazione è un prodotto a sé, può avere il proprio identificativo del modello.

L’etichetta GARAN indica 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 l’opzione scelta. Per un’etichetta che riguarda un solo prodotto, gli sviluppatori usano il file di layout di quel prodotto (catalog_product_view_sku_{sku}.xml). Se le variazioni hanno identificativi del modello diversi, conviene gestire questi modelli come prodotti separati.

Errori tipici in Magento

• Full page cache: le pagine prodotto vengono salvate già pronte nella Page Cache. Dopo una modifica, aggiorna i tipi di cache Page Cache, Layouts e Blocks HTML output in “System → Tools → Cache Management”.
• Widget legato al tema: ogni istanza di widget appartiene a un Design Theme. Dopo un cambio di tema, crea il widget per il nuovo tema.
• Store view: in “Storefront Properties” scegli le store view in cui compare il widget. Con più lingue, controlla ogni store view.
• Tema proprio: i tuoi file di layout vanno in un tema tuo. Adobe sconsiglia di modificare i temi forniti di serie, per compatibilità e aggiornamenti.

Altre fonti

• Adobe Commerce: Product layouts (in inglese)
• Adobe Commerce: Create a widget (in inglese)
• Adobe Commerce: Block positions (in inglese)
• Adobe Commerce: Configurable product (in inglese)
• Adobe Commerce: Create product attributes (in inglese)
• Adobe Commerce: Cache management (in inglese)
• Adobe Commerce: Create a storefront theme (in inglese)
• Magento Open Source: opzioni di “Display On” (GitHub)

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 in Marketing → Email Templates. La grafica ufficiale si può aggiungere come immagine al modello “New Order”. 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 Magento / Adobe Commerce come mostrato sopra.

Preferisci usare i tuoi file? Allora carica la versione completa e quella annidata nella libreria multimediale di Magento / Adobe Commerce 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