Avviso garanzia legale su OXID: widget gratis

In OXID eShop 7 aggiungi l'avviso sulla garanzia legale sotto il pulsante di aggiunta al carrello con un'estensione del template: nel blocco Twig details_productmain_tobasket del tema APEX, tramite un piccolo modulo o un tema child. Una pagina CMS nell'amministrazione non basta, perché l'editor rimuove gli script e nella pagina prodotto non c'è uno slot CMS libero.

Il codice per OXID eShop

<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 OXID eShop

Modulo o tema child
L'estensione va in un piccolo modulo o in un tema child (in theme.php con 'parentTheme' => 'apex'), così gli aggiornamenti del tema APEX non la sovrascrivono. La attivi in Extensions → Modules o Extensions → Themes. Ti serve l'accesso ai file; di solito se ne occupa la tua agenzia.
Estendi il blocco
Estendi il template page/details/inc/productmain.html.twig e incolla il codice del widget nel blocco details_productmain_tobasket dopo {{ parent() }}. Con parent() il pulsante di aggiunta al carrello resta invariato.
Etichetta GARAN per prodotto
Per le tue etichette GARAN crea due attributi in Administer Products → Attributes, ad esempio “GARAN completa” e “GARAN piccola”, e inserisci nel prodotto, in Selection → Assign Attributes, gli indirizzi dei due file. Nel template mostra i valori in data-garan-voll e data-garan-klein.
Svuota la cache
Svuota la cache dei template con vendor/bin/oe-console oe:cache:clear e controlla la pagina prodotto, varianti comprese.

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

In un modulo il file si trova in views/twig/extensions/themes/apex/page/details/inc/productmain.html.twig e ha questo aspetto:

{% extends 'page/details/inc/productmain.html.twig' %}

{% block details_productmain_tobasket %}
  {{ parent() }}
  <div data-garantielabel></div>
  <script src="https://www.garantielabel.app/widget.js" async></script>
{% endblock %}

Da sapere su OXID eShop

L'editor delle pagine CMS rimuove <script>. Da OXID 7.5 c'è anche un HTML sanitizer che, se attivato, rimuove gli script. Il codice va quindi nel template.
Per impostazione predefinita gli attributi assegnati compaiono anche nell'elenco delle proprietà del prodotto nella pagina di dettaglio. Se necessario, nascondi lì i due attributi GARAN nel template.
OXID 6 con i temi Smarty Flow e Wave: il blocco ha lo stesso nome. I moduli lo agganciano tramite blocks in metadata.php; il template è page/details/inc/productmain.tpl.

Dove va esattamente l’avviso in OXID eShop

Nella pagina prodotto, l’avviso si trova nel blocco details_productmain_tobasket, come descritto sopra. Quando il cliente sceglie un’altra variante, APEX ricarica l’area details_container e la sostituisce con HTML appena generato. Il tema esegue di nuovo gli script che contiene. Così la tua estensione del blocco torna sulla pagina anche dopo il cambio di variante.

Per un avviso su tutte le pagine, estendi il template layout/footer.html.twig. Nel tema APEX contiene, tra gli altri, il blocco dd_footer_copyright, che mostra il contenuto della pagina CMS con l’ident oxstdfooter. In un modulo, il tuo file si trova in views/twig/extensions/themes/apex/layout/footer.html.twig:

{% extends 'layout/footer.html.twig' %}

{% block dd_footer_copyright %}
  {{ parent() }}
  <div data-garantielabel></div>
  <script src="https://www.garantielabel.app/widget.js" async></script>
{% endblock %}

Il testo del footer continui a gestirlo nella pagina CMS. Il segnaposto invece va nel template, per lo stesso motivo visto sopra: l’editor rimuove gli script. Il template vale per tutte le lingue del negozio. Il widget sceglie la lingua dell’avviso in base alla lingua indicata dalla pagina, che APEX imposta dalla lingua attiva del negozio.

Varianti e identificativo del modello per l’etichetta GARAN

In OXID crei prima un prodotto padre. Secondo la documentazione utente, contiene tutte le informazioni di base che vengono ereditate dalle varianti. Le varianti si gestiscono nella scheda “Variants” (nomi dell’interfaccia in inglese). Lì puoi inserire, tra l’altro, un codice prodotto, un prezzo e una giacenza diversi da quelli del prodotto padre. La descrizione lunga del prodotto padre viene mostrata per tutte le varianti, a meno che una variante non abbia la propria.

Produttore e codice del produttore (MPN) si trovano nella scheda “Main”. Il produttore lo scegli da un elenco che gestisci in “Master Settings ‣ Brands/Manufacturers”. Secondo la documentazione, la vista di modifica di una variante è quasi identica a quella di un prodotto normale.

Un’etichetta GARAN vale per un identificativo del modello. Se tutte le varianti hanno lo stesso, basta l’etichetta sul prodotto padre. Se le varianti sono modelli distinti, ogni modello ha bisogno della propria etichetta. Dopo la configurazione, controlla nel negozio online pubblicato se, al cambio di variante, il tuo template mostra l’etichetta della variante scelta o quella del prodotto padre.

Errori tipici in OXID eShop

Cache dei template: Secondo OXID, le modifiche a template, configurazioni o moduli spesso vengono applicate correttamente solo dopo aver svuotato la cache. Oltre al comando da console visto sopra, il modulo OXID Admin Tools svuota la cache dei template in “Service ‣ Tools”. Questa cache contiene i template Twig compilati.
Varnish: Con il reverse proxy Varnish, un server separato tiene le pagine in cache. Per farlo OXID suddivide le pagine in sezioni, i cosiddetti widget. Controlla la modifica solo quando anche questa cache fornisce la nuova versione. Di solito la svuota la tua agenzia o il tuo hosting.
Subshop: Secondo la documentazione per sviluppatori, attivi un modulo per un subshop con l’opzione --shop-id, cioè vendor/bin/oe-console oe:module:activate <module-id> --shop-id=<shop-id>. Poi controlla ogni subshop separatamente.
Contenuti CMS per lingua: Secondo la documentazione, le pagine CMS si gestiscono separatamente per ogni lingua, tramite la selezione della lingua. Un’estensione del template, invece, serve una sola volta.

Altre fonti

L'avviso sulla garanzia legale nella conferma d'ordine

Secondo gli orientamenti della Commissione, l'avviso dovrebbe comparire anche nell'e-mail di conferma. La conferma d'ordine usa la pagina CMS con l'ident oxuserorderemail, che modifichi in Customer Info → CMS Pages. Nelle e-mail JavaScript non viene eseguito, quindi aggiungi lì la grafica ufficiale come immagine. 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.

Fonti

Documentazione per sviluppatori OXID: estendere un blocco di un tema attivo (in inglese)
Documentazione per sviluppatori OXID: creare un tema child (in inglese)
Documentazione per sviluppatori OXID: HTML sanitizer (7.5) (in inglese)
Documentazione utente OXID: prodotti, scheda Selection (in inglese)
Documentazione utente OXID: pagine CMS (in inglese)
Tema APEX su GitHub (template della pagina prodotto) (in inglese)

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 OXID eShop come mostrato sopra.

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

Posso semplicemente incollare il codice in una pagina CMS?

Non in modo affidabile. L'editor rimuove lo script, e nella pagina prodotto non c'è uno slot standard in cui una pagina CMS compaia automaticamente. Una piccola estensione del template è la strada sicura.

Devo modificare il tema APEX stesso?

No. Basta un modulo o un tema child con {{ parent() }}. Il tema originale resta aggiornabile e il pulsante di acquisto resta com'è.

Dove inserisco l'etichetta GARAN per prodotto?

Ad esempio come valore di un attributo nel prodotto, in Selection → Assign Attributes. Il template legge poi gli indirizzi e li passa al widget.

Come mostro l’avviso su tutte le pagine in OXID eShop?

Nel tuo modulo o tema figlio, estendi il template layout/footer.html.twig, nel tema APEX per esempio il blocco dd_footer_copyright. Incolla lì il codice del widget dopo {{ parent() }}.

L’avviso resta quando cambia la variante?

Sì, se si trova nel blocco details_productmain_tobasket. Al cambio di variante APEX ricarica tutta l’area dei dettagli, compresa la tua estensione del blocco, ed esegue di nuovo gli script che contiene.

Devo attivare il modulo in ogni subshop?

Secondo la documentazione per sviluppatori, lo attivi per un subshop con l’opzione --shop-id. Poi controlla ogni subshop nel negozio online pubblicato.

Aggiungi l'avviso sulla garanzia legale su OXID eShop