Smart Offers — Documentazione completa
Configurare e gestire Offerte combinate su PrestaShop 1.7.8, 8 e 9: acquista X ricevi Y, regali bundle, offerte a scelta e lotti, applicati in modo automatico e sicuro nel carrello.
Offerte combinate ti permette di proporre le quattro promozioni combinate più diffuse su PrestaShop: acquista X e ricevi Y dello stesso prodotto, un regalo per prodotti acquistati insieme, offerte a scelta tra una selezione e lotti. Il modulo aggiunge gli articoli premio al carrello, applica lo sconto e mostra l’offerta nella scheda prodotto e nel carrello, su PrestaShop 1.7.8, 8 e 9.
Compatibilità
| Elemento | Supportato |
|---|---|
| PrestaShop | 1.7.8, da 8.0 a 8.2, 9.0 e successive (un solo ZIP) |
| PHP | 7.2 e superiore (vale la versione richiesta dal tuo PrestaShop) |
| Temi | Classic, Hummingbird e i loro temi figli |
| Multinegozio, multivaluta, combinazioni | Sì |
| Lingue | inglese, francese, spagnolo, tedesco, italiano, polacco, olandese, portoghese |
Installazione e aggiornamento
- Nel back office apri Moduli → Gestione moduli e fai clic su Carica un modulo.
- Trascina il file
dfoffers-3.0.0.zip. - Il modulo compare in Catalogo → Sconti → Offerte combinate, accanto alle regole carrello.
Aggiornamento dalla 2.x: carica il nuovo ZIP sopra il precedente. Offerte, prodotti, traduzioni e negozi vengono conservati. Lo script di aggiornamento aggiunge le nuove opzioni, sposta la voce di menu e mette in sicurezza le regole carrello già create dalla 2.x (non può più essere generato alcun buono per l’importo residuo).
La dashboard
La pagina Offerte mostra le offerte in corso, gli ordini validi che hanno usato un’offerta negli ultimi 30 giorni, il loro fatturato e lo sconto concesso. Ogni offerta mostra la sua regola in chiaro, il suo stato (in corso, programmata, terminata, disattivata), le date, gli ordini e lo sconto. Puoi cercare, filtrare per stato, attivare o disattivare con un clic, duplicare, eliminare e applicare azioni di gruppo.

I quattro tipi di offerta
- Acquista X, ricevi Y dello stesso prodotto: il classico 1+1 o 2+1. Ogni prodotto della lista ha la sua offerta; lascia «qualsiasi combinazione» per contare insieme tutte le varianti.
- Acquista prodotti insieme, ricevi un regalo: tutti i prodotti attivatori devono essere nel carrello, i prodotti premio sono allora gratis o scontati.
- A scelta tra una selezione: il cliente sceglie N articoli tra prodotti o combinazioni, i più economici sono gratis o scontati (ad esempio 3 per 2 su tutte le tazze).
- Lotto: per ogni lotto di X unità di un prodotto, il cliente riceve Y unità di un altro prodotto.
Creare un’offerta
Fai clic su Nuova offerta oppure scegli uno dei quattro modelli quando non esiste ancora alcuna offerta. L’editor ha cinque passaggi e, a destra, un’anteprima dal vivo del banner prodotto e un riepilogo della regola in chiaro.
- Tipo di offerta: una delle quattro schede. Vengono mostrati solo i campi utili.
- Prodotti e quantità: aggiungi i prodotti con la finestra di ricerca, per nome, riferimento o ID. Per un prodotto con combinazioni, aggiungilo per tutte le combinazioni o scegline una o più.
- Premio: gratis (100%) o percentuale (50 per «il secondo a metà prezzo»), aggiunta automatica al carrello o no, ripetizione a ogni lotto completo, massimo per carrello.
- Visualizzazione: nome, testo del badge e testo aggiuntivo in ogni lingua, colore dell’offerta. Il colore del testo del badge viene scelto automaticamente per restare leggibile.
- Disponibilità: stato, date di inizio e fine, priorità, gruppi di clienti e negozi.


Quando gli articoli premio non vengono aggiunti automaticamente, il cliente li aggiunge e lo sconto si applica appena sono nel carrello; il carrello gli ricorda allora il premio in attesa.

Il banner della scheda prodotto
Su ogni prodotto interessato, un banner spiega l’offerta con i prodotti da acquistare e il premio, il prezzo abituale barrato accanto agli articoli gratis o scontati, la data di fine dell’offerta e lo stato «Applicata nel tuo carrello» appena il cliente ne beneficia. Si adatta alle colonne strette e al mobile.




Il carrello
Sotto le righe del carrello, il cliente vede le offerte applicate con l’importo risparmiato e gli articoli ricevuti. Un badge («Gratis ×1», «1 a -50%») segnala le righe con unità scontate, nel carrello e nel riepilogo dell’ordine. Il blocco si aggiorna dopo ogni modifica della quantità, sia su Classic sia su Hummingbird.

Ci sei quasi elenca cosa manca per sbloccare un’offerta («Aggiungi 1 × T-shirt») e Ti aspetta un premio ricorda al cliente di aggiungere un premio che non viene aggiunto automaticamente.

Se il cliente rimuove un regalo, non gli viene reimposto: l’offerta viene messa da parte e compare il pulsante Rimetti nel carrello. Per un «acquista X ricevi Y» sullo stesso prodotto, vengono rimosse prima le unità gratuite: il cliente non perde mai un’unità pagata.

Impostazioni
- Posizione del banner: sotto il pulsante Aggiungi al carrello (consigliato), subito sotto il prezzo, sotto le immagini, nel blocco rassicurazioni o a tutta larghezza sotto la descrizione.
- Banner compatto, prezzi nel banner e data di fine.
- Carrello: mostra cosa manca per sbloccare un’offerta, badge sulle righe del carrello.
- Log di debug: scrive ogni calcolo del carrello in Parametri avanzati → Log; lascialo disattivato in produzione.
- Manutenzione: numero di regole carrello create dal modulo e pulizia di quelle dei carrelli abbandonati.

Come funziona il motore
- A ogni modifica del carrello (e all’apertura del carrello o del checkout), il modulo legge il carrello e distingue le unità pagate dal cliente da quelle che ha aggiunto lui stesso.
- Le offerte vengono valutate per priorità (prima la 1). Un’unità usata da un’offerta non viene riutilizzata da un’altra: lo stesso articolo non è mai scontato due volte.
- Per ogni offerta applicabile, i premi mancanti vengono aggiunti (se lo hai scelto) e viene creata o aggiornata una regola carrello per prodotto scontato (codice
DFOFFER_…). - Le offerte che non si applicano più vengono ritirate: unità aggiunte riprese, regole carrello eliminate.
Sicurezza e tasse
- Tutto viene calcolato sul server a partire dal carrello e dalle tue offerte; nulla di ciò che invia il browser entra in un prezzo.
- Ogni regola carrello è limitata al prodotto scontato: non può mai superare quanto il cliente ha di quel prodotto nel carrello, e allo sconto si applica l’aliquota IVA di quel prodotto, anche in fattura.
- Le regole non generano mai un buono per l’importo residuo, non compaiono in «I miei buoni» e un codice copiato da un altro carrello viene rimosso prima del pagamento.
- Un premio esaurito o disattivato non viene scontato. Un ordine già effettuato non viene mai modificato.
- Le azioni del back office rispettano i permessi della scheda per dipendente (vedere, aggiungere, modificare, eliminare).
Le regole carrello dei carrelli abbandonati da 30 giorni vengono rimosse automaticamente una volta al giorno all’apertura del modulo; quelle usate da un ordine sono sempre conservate per la contabilità.
Aiuto e risoluzione dei problemi
La scheda Aiuto del modulo spiega il funzionamento e risponde alle domande più frequenti.
- Il banner non compare: verifica che l’offerta sia attivata, nelle sue date, disponibile per il gruppo di clienti e il negozio, e che il prodotto sia attivo. Poi prova un’altra posizione del banner: alcuni temi non richiamano tutti gli hook.
- Un tuo buono viene rifiutato con un’offerta: un buono impostato come «non cumulabile con altre regole carrello» può rifiutare la combinazione; adattalo in Catalogo → Sconti.
- Il badge manca sulle righe del carrello: il tuo tema deve contenere
{hook h='displayProductPriceBlock' product=$product type="unit_price"}o{hook h='displayCartExtraProductActions' product=$product}nel template della riga del carrello.

Dettagli tecnici
- Hook: displayProductAdditionalInfo (o la posizione scelta), displayProductPriceBlock, displayAfterProductThumbs, displayReassurance, displayFooterProduct, displayShoppingCartFooter, displayCartExtraProductActions, actionCartSave, actionFrontControllerSetMedia, actionObjectProductDeleteAfter, actionObjectCombinationDeleteAfter.
- Tabelle: ps_dfoffers_offer, _offer_lang, _trigger, _reward, _shop, _cart_auto, _rule, _cart_declined.
- Template sovrascrivibili nel tuo tema:
views/templates/hook/product-banner.tpl,cart-offer.tpl,cart-line-gift.tpl. Le classi CSS usano il prefissodfoffers-. - Nessun override, nessun cron, nessun servizio esterno. La disinstallazione elimina le offerte e le regole carrello non utilizzate; quelle usate dagli ordini vengono conservate.