DF Quantity Tiers — Documentazione
Installare, configurare e sfruttare DF Quantity Tiers: visualizzazione prezzi decrescenti, aggiunta per scaglione, incentivo carrello, modalità B2B, JSON-LD e statistiche.
Presentazione e requisiti
DF Quantity Tiers trasforma gli sconti quantità nativi di PrestaShop in un blocco di vendita chiaro e cliccabile. Il modulo non introduce alcuna nuova logica di prezzo: legge i prezzi specifici per quantità già configurati nel suo catalogo e li presenta a schede o in tabella, con un pulsante di aggiunta al carrello per ogni scaglione.
- Compatibile con PrestaShop da 8.0 a 9.x, tema Classic e temi derivati.
- PHP da 7.4 a 8.3.
- Multinegozio e multilingue (FR/EN/ES/DE/IT).
- Nessun override di file: solo hook nativi.
Gli scaglioni provengono da Catalogo > Prodotto > Prezzi > Prezzi specifici, campo «A partire dalla quantità». Se un prodotto non ha prezzi specifici per quantità, il blocco non viene mostrato per quel prodotto.
Installazione
Installi il modulo come qualsiasi modulo PrestaShop:
- Scarichi l’archivio
dfquantitytiers-1.1.0.zipdal suo account cliente. - Nel back office, vada su Moduli > Gestore dei moduli.
- Clicchi su Carica un modulo e rilasci l’archivio.
- Una volta installato, clicchi su Configura.
All’installazione, il modulo registra i suoi hook, crea la sua tabella di statistiche e precompila un titolo di blocco tradotto nelle cinque lingue. I suoi sconti quantità esistenti appaiono immediatamente sulle schede prodotto interessate.
Aggiornamento dalla 1.0.0
L’aggiornamento alla 1.1.0 si effettua normalmente dal Gestore dei moduli. Lo script di aggiornamento integrato crea la tabella di statistiche, registra il nuovo hook della pagina carrello e applica i valori predefiniti delle nuove opzioni (modalità fiscale, JSON-LD, incentivo carrello, statistiche, etichette di confezionamento). Non è richiesta alcuna azione manuale e la sua configurazione esistente viene conservata.
Configurazione generale
La pagina di configurazione raccoglie tutte le impostazioni di visualizzazione:
- Titolo del blocco: testo mostrato sopra gli scaglioni, traducibile per lingua.
- Disposizione: «Schede» (consigliata, una scheda per scaglione) o «Tabella compatta» (una riga per scaglione).
- Posizione nella scheda prodotto: sotto il blocco di acquisto (hook
displayProductAdditionalInfo, predefinito) o direttamente sotto il prezzo (hookdisplayProductPriceBlock). - Colore di accento: applicato allo scaglione «Migliore offerta», ai badge e ai pulsanti.
- Visualizzazione del risparmio: in percentuale, in importo o entrambi.
- Mostrare il prezzo totale dello scaglione: aggiunge il totale per la quantità dello scaglione.
- Mostrare lo scaglione «all’unità»: mostra il prezzo base come primo scaglione di confronto.
Lo scaglione con lo sconto unitario più elevato riceve automaticamente il badge «Migliore offerta». Quando il cliente modifica la quantità, la scheda corrispondente alla sua scelta viene evidenziata in tempo reale.
Modalità fiscale (B2B)
La modalità fiscale determina se i prezzi degli scaglioni sono mostrati IVA esclusa o IVA inclusa:
- Automatica: segue l’impostazione di visualizzazione del gruppo clienti corrente (comportamento standard di PrestaShop).
- Forza IVA esclusa: mostra sempre i prezzi IVA esclusa, con la dicitura «IVA escl.» accanto a ogni prezzo unitario. Ideale per un negozio professionale.
- Forza IVA inclusa: mostra sempre i prezzi IVA inclusa, con la dicitura «IVA incl.».
La modalità scelta si applica sia alle schede della scheda prodotto sia al blocco di incentivo del carrello.
Etichette di confezionamento
Può associare un’etichetta commerciale a ogni quantità, ad esempio «cartone» o «pallet». Nel campo Etichette di confezionamento, inserisca un’associazione per riga nel formato quantità=etichetta:
12=Cartone da 12
48=Mezzo pallet
96=PalletL’etichetta viene mostrata sotto la quantità dello scaglione corrispondente. Questo campo è traducibile: lo compili per ogni lingua dal selettore di lingua del modulo.
Incentivo allo scaglione successivo
Sono disponibili due meccanismi di incentivo, attivabili in modo indipendente.
Sulla scheda prodotto
Una barra di avanzamento mostra un messaggio del tipo «Aggiunga altre 3 unità per risparmiare il 15 %», ricalcolato in tempo reale in base alla quantità inserita. Quando il cliente raggiunge lo scaglione più vantaggioso, il messaggio passa a «Hai diritto allo sconto migliore!».
Sulla pagina carrello
Per ogni prodotto del carrello il cui scaglione superiore è ancora raggiungibile, il modulo mostra sotto il carrello un blocco con «Aggiunga altre N unità per passare a X / unità», accompagnato da un pulsante di aggiunta in un clic. Il pulsante utilizza il meccanismo nativo di aggiornamento del carrello di PrestaShop, poi ricarica la pagina. Se nessuno scaglione superiore è raggiungibile, non viene mostrato alcun blocco.
Dati strutturati (JSON-LD)
Quando l’opzione è attivata, il modulo aggiunge sulla scheda prodotto un markup JSON-LD di tipo AggregateOffer, con un’offerta per scaglione e la relativa quantità idonea. Questo permette ai motori di ricerca di comprendere le sue fasce di prezzo per quantità.
Se il suo tema o un altro modulo SEO genera già un markup Offer completo per i suoi prodotti, disattivi questa opzione per evitare un markup duplicato segnalato in Search Console.
Statistiche dei clic per scaglione
Quando l’opzione è attivata, ogni clic su un pulsante di aggiunta per scaglione viene registrato in modo anonimo: prodotto, combinazione, quantità e sconto dello scaglione cliccato. Non viene utilizzato alcun dato personale né cookie, il che rende la funzione conforme al GDPR.
La pagina di configurazione mostra una dashboard degli ultimi 30 giorni: numero totale di clic e le combinazioni prodotto / scaglione / sconto più cliccate. Questi dati la aiutano a calibrare i suoi sconti individuando quali scaglioni generano realmente aggiunte al carrello.
FAQ e risoluzione dei problemi
Il blocco non appare su un prodotto
Verifichi che il prodotto abbia prezzi specifici con una quantità di partenza superiore a 1 e che tali prezzi si applichino al gruppo clienti, alla valuta e al paese correnti. Lo scaglione base da solo non attiva la visualizzazione se non esiste alcuno scaglione di sconto.
Il pulsante di aggiunta non funziona con il mio tema
Il modulo si basa sul pulsante standard di aggiunta al carrello del tema Classic. Su un tema fortemente personalizzato, si assicuri che il campo quantità e il pulsante di aggiunta seguano il markup standard di PrestaShop.
Funziona con le combinazioni?
Sì. Gli scaglioni vengono ricalcolati per ogni combinazione e il blocco si aggiorna automaticamente al cambio di variante, senza ricaricare la pagina.
Cosa succede alla disinstallazione?
La disinstallazione rimuove in modo pulito gli hook, le variabili di configurazione e la tabella di statistiche. Nessun dato residuo rimane nel database.