Selettore di visualizzazione delle imposte: configurazione e aiuto

Carica lo ZIP in Moduli > "Module Manager" > "Upload a module". Installalo e fai clic su "Configure". Usa la schermata Impostazioni > "Configuration" del modulo, con il titolo Impostazioni generali.

Richiede PrestaShop 1.6 o successivo e PHP 7.1 o successivo.

In multinegozio, seleziona il contesto da configurare. Le impostazioni vengono risolte nell'ordine negozio, gruppo di negozi e ambito globale.

Fai clic su Salva. Questo form non contiene un selettore di posizione separato.

Per un gruppo di clienti che dovrebbe normalmente vedere prezzi al netto delle imposte, configura il metodo di visualizzazione dei prezzi del gruppo in PrestaShop e lascia "Default Display" su "Follow customer group (default)". I valori nativi sono 0 per imposte incluse e 1 per imposte escluse.

Il modulo salva le chiavi multilingue LABEL_INCL, LABEL_EXCL, SUFFIX_INCL e SUFFIX_EXCL. Non sono quattro campi modificabili nel form attuale delle impostazioni generali.

L'installazione inizializza le etichette per lingua. I valori inglesi sono Incl. VAT, Excl. VAT, incl. VAT e excl. VAT. Il tedesco usa inkl. MwSt. e zzgl. MwSt.. Il francese usa TTC e HT. Il polacco usa brutto e netto. L'italiano usa IVA incl. e IVA escl.. Lo spagnolo usa con IVA e sin IVA. Gli altri codici lingua usano i valori inglesi di ripiego durante l'installazione.

Se hai bisogno di un testo personalizzato, adatta il template del widget del tema o predisponi una modifica controllata della configurazione. Non cercare campi per le etichette che questo form non espone. Anche le etichette compatte del selettore e il testo di aiuto usano le traduzioni del modulo.

Su PrestaShop 1.7 e versioni successive, il widget può essere visualizzato in displayNav1 o displayNav2. Viene mostrato una sola volta, alla prima chiamata applicabile. Su PrestaShop 1.6 può usare anche displayTop.

Se l'hook manca in un'intestazione personalizzata, aggiungi la chiamata nativa appropriata nella posizione desiderata:

{hook h='displayNav2'}

Per un'intestazione di PrestaShop 1.6:

{hook h='displayTop'}

Il modulo non viene visualizzato tramite displayTop su 1.7 e versioni successive. Se è già stato eseguito un altro hook di navigazione supportato, la protezione contro la visualizzazione multipla può impedire una seconda copia nella nuova posizione. Controlla l'ordine effettivo degli hook quando lo sposti.

Per un markup personalizzato, copia il template del modulo nel tema e modifica la copia:

/themes/your_theme/modules/mprtaxdisplayswitcher/views/templates/hook/switcher.tpl

Lo stile a interruttore include un controllo di aiuto. Il comportamento del tooltip usa l'integrazione dei tooltip Bootstrap disponibile nel tema.

Lo script front-office salva la preferenza direttamente nel cookie pubblico mpr_tax_display prima di aggiornare i prezzi. In questa revisione non chiama un endpoint AJAX per il cambio di modalità.

Una scelta diversa da quella predefinita salva:

mpr_tax_display=0
mpr_tax_display=1

Il ritorno alla modalità predefinita configurata rimuove il cookie. Il cookie usa il percorso /, SameSite Lax e Secure su HTTPS. Una richiesta successiva legge la preferenza prima che venga preparata la visualizzazione dei prezzi. Modifica il metodo di visualizzazione del gruppo memorizzato nella cache della richiesta senza aggiornare il record del gruppo salvato.

Il modulo fornisce dati di prezzo nascosti tramite displayProductPriceBlock solo per le chiamate all'hook con type="weight". Prepara prezzi di vendita e regolari in entrambe le modalità e li formatta nella valuta attiva. Per esempio:

<span class="mpr-tax-prices"
      style="display:none"
      data-si="120.00"
      data-se="100.00"
      data-ri="150.00"
      data-re="125.00"
      data-d="1"></span>

Questi attributi contengono stringhe formattate nell'output reale. JavaScript usa markup compatibile dei prodotti e degli elenchi per sostituire i prezzi visibili.

Il cambio è istantaneo quando tutti i prezzi visibili rilevati hanno dati .mpr-tax-prices corrispondenti. Se mancano dati, un prezzo non trova corrispondenza o la copertura è incompleta, lo script salva la preferenza e ricarica la pagina affinché il server mostri la modalità scelta. Le pagine del carrello e del checkout si ricaricano anche quando i prodotti consigliati contengono dati di prezzo.

Il modulo controlla la presentazione dei prezzi. Regole fiscali, prezzi dei prodotti salvati, obblighi fiscali effettivi e contabilizzazione degli ordini usano ancora la configurazione fiscale e di checkout del negozio. Per i dati di visualizzazione in cui i valori nativi al lordo e al netto delle imposte sono uguali mentre le imposte sono abilitate, il modulo può calcolare un valore di visualizzazione lordo di ripiego usando l'aliquota del paese predefinito. Prova questo caso separatamente per i negozi il cui comportamento dipende dall'indirizzo del cliente e dall'IVA.

Apri una pagina della vetrina non in cache senza una preferenza salvata. Conferma che usi "Default Display". Cambia modalità e controlla sia il prezzo visibile sia mpr_tax_display nei dati memorizzati dal browser.

Vai subito a un altro prodotto. Conferma che la modalità scelta persista. Torna alla modalità predefinita configurata e conferma che il cookie scompaia.

Prova un elenco di prodotti, un prodotto semplice, un prodotto con combinazioni e prezzi regolari e di vendita scontati. Cambia valuta e ripeti. Prova separatamente carrello e checkout, confrontando la visualizzazione con i totali effettivi e le righe delle imposte. Controlla i layout personalizzati in cui mancano gli span di prezzo nascosti o si aggiornano solo alcuni nodi.

Per un controllo in sola lettura dei dati nativi di visualizzazione dei gruppi, usa il prefisso delle tabelle e l'ID lingua effettivi:

SELECT g.id_group, gl.name, g.price_display_method
FROM ps_group AS g
INNER JOIN ps_group_lang AS gl ON gl.id_group = g.id_group
WHERE gl.id_lang = 1;

Usa le classi e le variabili CSS del modulo nel foglio di stile del tema. Per esempio:

:root {
  --mpr-primary: #1f7a5c;
  --mpr-border: #d6d6d6;
  --mpr-text: #222;
  --mpr-text-muted: #777;
}
.mprtaxswitch-host { margin-left: 12px; }
.mprtaxswitch__btn { text-transform: uppercase; }
.mprtaxswitch-tooltip .tooltip-inner { max-width: 320px; }

Se il controllo manca, verifica "Enable Tax Switcher", gli hook del tema, la visualizzazione una sola volta e il caricamento delle risorse front-office. Usa la schermata "Integrity" del modulo per controllare l'infrastruttura.

Se i prezzi non cambiano, controlla .mpr-tax-prices e la chiamata del tema a displayProductPriceBlock con tipo weight. Controlla gli errori di script nel browser e verifica che il markup corrisponda ai contenitori di prezzo dello script.

Se una ricarica ripristina la modalità sbagliata, controlla i permessi dei cookie, l'ambito e la cache della pagina. Prova senza una risposta HTML in cache. Se mancano i suffissi, controlla "Show Price Suffix", i valori dei suffissi, gli errori di script nel browser e il markup dei prezzi del tema.

La preferenza viene salvata nel cookie del browser. Non esiste un URL separato per il cambio su /module/mprtaxdisplayswitcher/switch o /ajax.

Imposta "Enable Tax Switcher" su No per interrompere il widget e la sostituzione mantenendo le impostazioni. Disinstalla tramite "Module Manager" per rimuovere il menu e la configurazione del modulo.

La disinstallazione lascia i cookie di preferenza esistenti nei browser dei visitatori. Puoi cancellare mpr_tax_display nel browser quando controlli il comportamento predefinito. Rimuovi separatamente eventuali personalizzazioni dei template del tema.