Modulo Prezzo «A partire da» (dffromprice) — Documentazione

Il modulo dffromprice («A partire da») mostra il prezzo per quantità più basso direttamente nei tuoi elenchi prodotti quando un prodotto ha uno sconto sulla quantità. Questa documentazione copre l’installazione, la configurazione completa e la risoluzione dei problemi.

Presentazione

Quando un prodotto ha sconti sulla quantità (ad esempio «compra 3 = risparmia il 20%»), questa informazione è visibile solo nella scheda prodotto, in fondo. Il modulo fa emergere un’etichetta «A partire da X» sulla miniatura del prodotto, nelle categorie, nella ricerca, nelle vendite incrociate e nei blocchi di prodotti in evidenza. Il prezzo mostrato è calcolato con il meccanismo nativo di PrestaShop, tenendo conto del gruppo cliente, della valuta, del paese e del metodo di calcolo dell’imposta.

Installazione

Dal back-office

1. Vai in Moduli > Gestore moduli.
2. Clicca su Carica un modulo e seleziona il file ZIP del modulo.
3. Al termine del caricamento, il modulo si installa automaticamente e registra i suoi hook.

Via FTP

1. Decomprimi l’archivio e posiziona la cartella dffromprice nella directory /modules del tuo negozio.
2. In Moduli > Gestore moduli, cerca «A partire da» e clicca su Installa.

Impostazioni

La configurazione si trova in Moduli > Gestore moduli > dffromprice > Configura. È organizzata in due pannelli.

Visualizzazione

• Attiva il modulo: interruttore generale.
• Mostra negli elenchi prodotti: categorie, ricerca, vendite incrociate, prodotti in evidenza.
• Mostra nella scheda prodotto: aggiunge il prezzo «A partire da» dopo il prezzo principale della scheda.
• Etichetta: testo mostrato prima del prezzo, traducibile per lingua («A partire da», «From»…).
• Mostra la quantità minima: indica la quantità necessaria per ottenere il miglior prezzo.
• Etichetta di quantità: testo che accompagna la quantità, con la variabile %qty% (es. «da %qty% unità»).
• Mostra la percentuale di risparmio: badge «-21%» basato sulla differenza tra il prezzo base e il miglior prezzo per quantità.
• Etichetta imposta (IVA incl./escl.): Mai, Secondo le impostazioni del negozio, o Sempre.
• Modalità di visualizzazione: Sostituisci il prezzo normale o Mostra accanto al prezzo normale.
• Selettore/i CSS da nascondere: in modalità sostituzione, selettori CSS nascosti quando viene mostrato il prezzo «A partire da».

Aspetto e restrizioni

• Colore del testo: selettore di colore, #f1a019 per impostazione predefinita.
• Risparmio minimo per mostrare (%): nasconde il prezzo «A partire da» se il risparmio è inferiore a questa percentuale. 0 = mostra sempre.
• ID prodotti esclusi: elenco di ID separati da virgole.
• ID categorie escluse: elenco di ID separati da virgole (in base alla categoria predefinita del prodotto).
• CSS personalizzato: aggiunto su ogni pagina del front, per puntare al blocco .df-fromprice e ai suoi figli.

Funzionamento e calcolo del prezzo

Il modulo si basa su SpecificPrice::getQuantityDiscounts() con gli stessi parametri della tabella nativa «Sconto sulla quantità» (negozio, valuta, paese, gruppo cliente, cliente). Per ogni fascia di quantità superiore a 1, il prezzo unitario reale è calcolato tramite Product::getPriceStatic(). Il prezzo «A partire da» viene mostrato solo se questo prezzo è strettamente inferiore al prezzo base. Una cache statica per prodotto e combinazione garantisce una sola query di calcolo per miniatura all’interno di una pagina.

Compatibilità temi

Il modulo si aggancia all’hook displayProductPriceBlock, presente in ogni elenco prodotti standard di PrestaShop. In modalità sostituzione, il prezzo normale viene nascosto dal selettore CSS configurabile. Il valore predefinito copre i temi basati su Classic e il tema Falcon:

.df-fromprice + .wrapper-price-taxe, .df-fromprice + .price

Per un altro tema, ispeziona il contenitore del prezzo nella miniatura e regola il selettore di conseguenza.

Risoluzione dei problemi

Il prezzo «A partire da» non appare

• Verifica che il prodotto abbia effettivamente uno sconto sulla quantità (fascia di quantità superiore a 1) e che il prezzo per fascia sia inferiore al prezzo base.
• Verifica che la visualizzazione negli elenchi prodotti sia attivata.
• Controlla la soglia minima di risparmio: se troppo alta, la visualizzazione può essere bloccata.
• Assicurati che il prodotto o la sua categoria non figurino nelle esclusioni.

Il prezzo normale resta visibile in modalità sostituzione

Il selettore CSS di occultamento non corrisponde al contenitore del prezzo del tuo tema. Regola il campo «Selettore/i CSS da nascondere» e poi svuota la cache.