Sistema di sconti fedeltà: configurazione e aiuto
Avvio rapido
- Installa lo ZIP in Moduli > "Module Manager", fai clic su "Configure" e seleziona un negozio.
- In Livelli, apri Impostazioni e verifica "Discount source", gli ordini conteggiati, "Evaluation window" e le regole di cambio livello.
- Aggiungi livelli con Nome del livello, Colore, Icona e Attivo, quindi ordinali dal rango più basso al più alto.
- Aggiungi Regole di qualificazione e Vantaggi, includendo importo, politica delle promozioni e selezione dei prodotti per ogni Sconto.
- Usa "Price preview" e "Rebuild prices"; attendi "Prices ready".
- Apri Clienti e avvia "Start silent recount", continuando fino al completamento.
- Pianifica una chiamata all'URL in Impostazioni > Configurazione > "Scheduled maintenance" ogni minuto, a meno che la suite non gestisca la pianificazione.
- Accedi come cliente di prova e verifica il livello, i progressi nell'account, i prezzi dei prodotti, il carrello ed eventuali vantaggi di spedizione.
Richiede PrestaShop 1.6.1 o successivo e PHP 7.1 o successivo.
Manuale di configurazione
Installare e scegliere un negozio
Carica lo ZIP in Moduli > "Module Manager" > "Upload a module". Installalo e fai clic su "Configure" per aprire Configurazione dei livelli.
Apri "Loyalty Discounts" per accedere a Livelli, Clienti, Pannello di controllo e Impostazioni > Configurazione. Seleziona un negozio prima di modificare. La pagina dei livelli richiede al dipendente il permesso di visualizzazione per leggere, di modifica per apportare cambiamenti e di eliminazione per eliminare. Ricarica la pagina se il suo token di sicurezza scade.
Richiede PrestaShop 1.6.1 o successivo e PHP 7.1 o successivo.
Il modulo utilizza un programma fedeltà B2C per ogni negozio. La qualificazione si configura con regole. Non devi compilare un singolo campo Spesa minima e collegare manualmente ogni livello a un gruppo clienti esistente.
Configurare le impostazioni del programma
In Livelli, fai clic su Impostazioni. Questa finestra contiene le impostazioni di qualificazione, prezzi, notifiche e spedizione. La pagina separata Impostazioni > Configurazione contiene le integrazioni e l'URL di manutenzione.
Scegliere la fonte dello sconto
"Discount source" è impostato per impostazione predefinita su "Module tier benefits". Questa opzione usa vantaggi di sconto con impostazioni per importo, imposte, politica delle promozioni e selezione dei prodotti.
Scegli "PrestaShop group reduction" quando ti serve il comportamento nativo delle riduzioni di gruppo. La modalità gruppo usa il primo sconto attivo quando è percentuale; i gruppi collegati mantengono la propria riduzione. Il modulo crea o gestisce i gruppi dei livelli secondo necessità. Non presumere che una percentuale visualizzata sia puramente informativa.
Usa "Rebuild prices" dopo aver verificato le modifiche e attendi "Prices ready". In base alla versione di PrestaShop, il calcolo prezzi del modulo usa hook nativi dei prezzi o prezzi specifici compilati. Controlla i risultati di compatibilità segnalati e l'eventuale rapporto "Original customer group prices" prima di usare il risultato.
Definire cosa viene conteggiato nel fatturato
| Impostazione | Valore predefinito | Come configurarla |
|---|---|---|
| "Counted order states" | Vuoto | Se vuoto, conteggia ogni ordine valido. Seleziona gli stati per limitare lo storico conteggiato. |
| "Deduct refunds" | Sì | Sottrae gli importi rimborsati dal fatturato. Disattiva solo se il tuo programma conteggia deliberatamente le spese rimborsate. |
| "Include tax" | Sì | Conteggia la spesa comprensiva di imposte. |
| "Include shipping" | No | Aggiunge i costi di consegna alla base di spesa quando è attivo. |
Le metriche memorizzate usano la valuta predefinita del negozio. Non confrontare una soglia con un totale non convertito proveniente da un'altra valuta.
Selezionare il periodo di valutazione
| Impostazione | Valore predefinito | Come configurarla |
|---|---|---|
| "Evaluation window" | A vita | Scegli A vita, "Rolling days", "Rolling months" o "Calendar year". |
| "Rolling window days" | 365 | Usato per "Rolling days". |
| "Rolling window months" | 12 | Usato per "Rolling months". |
| "Minimum months for averages" | 3 | Divisore minimo per le medie mensili di fatturato e ordini. |
Usa il periodo corrispondente alla tua politica di qualificazione. Un periodo mobile può far scendere il livello di un cliente quando gli ordini più vecchi ne escono.
Controllare i cambi di livello
| Impostazione | Valore predefinito | Come configurarla |
|---|---|---|
| "Evaluation frequency" | "On order" | Scegli "On order", "Daily" o "Weekly". Le attività pianificate richiedono chiamate di manutenzione. |
| "Immediate upgrade" | Sì | Consente a un ordine di attivare immediatamente un livello superiore. |
| "Initial tier" | "No initial tier" | Scegli un livello di ripiego quando nessuna regola di qualificazione è soddisfatta. |
| "Protection months" | 0 | Mantiene un livello appena ottenuto per il periodo configurato. Zero non offre protezione. |
| "Grace days" | 0 | Concede tempo per qualificarsi di nuovo prima del declassamento. Zero non concede tempo aggiuntivo. |
| "Automatic downgrade" | Sì | Consente il passaggio a un livello inferiore quando si perde la qualificazione. |
L'ordine dei livelli ne determina il rango. Il livello idoneo più avanti nell'elenco ordinato è il candidato superiore. Riordina i livelli dal più basso al più alto.
Configurare notifiche e visualizzazione
| Impostazione | Valore predefinito | Come configurarla |
|---|---|---|
| "Notify on upgrade" | Sì | Invia una notifica di cambio livello per gli eventi idonei non silenziosi. |
| "Notify on downgrade" | No | Attiva se i clienti devono ricevere notifiche di declassamento. |
| "Notify before downgrade" | No | Attiva gli avvisi prima della fine di un periodo di grazia. |
| "Warning days" | 7 | Anticipo dell'avviso quando gli avvisi sono attivi. |
| "Show progress" | Sì | Mostra le informazioni di fedeltà nell'area account del cliente autenticato. |
Configurare la spedizione
"Carriers priced by loyalty" è inizialmente vuoto. Seleziona i corrieri nativi idonei se usi vantaggi di spedizione gratuita o ridotta. Il modulo diventa il modulo di calcolo prezzi per i corrieri adottati nelle versioni che usano questa integrazione. I corrieri già gestiti da un altro modulo corriere non possono essere adottati. Il rilascio di un corriere ripristina le sue impostazioni originali registrate.
Leggi il risultato dell'adozione dopo il salvataggio. Alcuni core forniscono direttamente l'hook di spedizione; l'interfaccia si adatta a questa capacità. Non presumere che un vantaggio di spedizione si applichi a un corriere non selezionato o non supportato.
Creare livelli e regole di qualificazione
Fai clic su Aggiungi livello. Inserisci il Nome del livello multilingue. È richiesto un nome nella lingua predefinita del negozio. Il campo Colore ha il valore predefinito #6c757d, il campo Icona è inizialmente vuoto e l'opzione Attivo è inizialmente attiva. Salva il livello, poi disponilo nell'ordine di rango previsto.
In Regole di qualificazione, fai clic su Aggiungi regola. Scegli Tipo di regola, Operatore e Valore. Le regole all'interno di uno stesso Gruppo di regole usano AND. Aggiungi gruppo OR crea un altro gruppo alternativo.
I tipi di regole B2C includono "Total turnover", "Monthly average turnover", "Total orders", "Average order value", "Order frequency", "Account age", "Return rate", "Late payments", "Consecutive months with orders", "Days since last order", "Categories purchased" e "Products purchased". Alcuni dati dipendono dalle informazioni o dalle integrazioni disponibili. Non devi presumere che una metrica non disponibile soddisfi una regola.
Per le metriche monetarie, usa la valuta predefinita del negozio. La frequenza degli ordini indica gli ordini al mese. I valori di anzianità e inattività usano i giorni. Le regole per gli elenchi di categorie e prodotti accettano ID positivi separati da virgole con "Contains all".
Per un livello Gold basato sulla spesa, crea:
Tier Name: Gold
Qualification Rules:
Rule Type: Total turnover
Operator: At least
Value: 500
Questo sostituisce il vecchio campo a soglia unica. Puoi invece qualificare in base al numero di ordini o combinare più requisiti.
Configurare i vantaggi dei livelli
In Vantaggi, fai clic su Aggiungi vantaggio. Scegli "Benefit Type" e compila i valori richiesti. Il campo Etichetta personalizzata è facoltativo e multilingue. Nessun vantaggio esiste finché non ne salvi uno.
| "Benefit Type" | Campi da configurare | Significato operativo |
|---|---|---|
| Sconto | "Discount type", Importo, "Tax basis", "Currency" per un importo fisso, "Promotion policy", "Product selection" | Applica uno sconto percentuale o fisso usando la fonte di calcolo prezzi selezionata. |
| "Free shipping" | "Minimum shipment amount (0 = no minimum)", "Tax basis", "Currency", "Product selection" | Spedizione gratuita sui corrieri supportati quando la spedizione fisica soddisfa i requisiti. |
| "Reduced shipping" | "Percentage", "Product selection" | Riduce i costi di spedizione supportati. |
| "Payment terms" | "Days" | Pubblica il vantaggio configurato; non presumere che crei un gateway di pagamento autonomo. |
| "Credit limit" | Importo, "Coverage ratio (%)", "Payment days" | Memorizza i dati del vantaggio di credito per le integrazioni che li usano. |
| "Extended returns" | "Days" | Descrive il periodo di reso del livello. |
| "Dedicated representative" | "Representative" | Associa il dipendente selezionato. |
| "Early sale access" | "Hours" | Memorizza il vantaggio di accesso anticipato. |
| "Exclusive products" | "Product selection" | Memorizza l'ambito di prodotti pertinente. |
| "Volume rebates" | "Percentage", "Period" | Memorizza condizioni di ristorno "Monthly", "Quarterly" o "Yearly". |
| "Free samples" | "Samples per month" | Memorizza la quota mensile. |
| "Priority support", "Priority handling", "Free refunds" | Vantaggio attivo ed etichetta facoltativa | Registra il diritto indicato. |
Il modulo autonomo applica automaticamente il calcolo degli sconti e le riduzioni di spedizione supportate. Gli altri tipi di vantaggi vengono registrati con il livello, ma il modulo non li esegue: erogazione, rimborsi, controllo degli accessi, pagamento di ristorni e condizioni di pagamento richiedono un tuo processo o un'altra integrazione. Predisponili prima di promettere questi vantaggi ai clienti.
Per gli sconti, nel modulo di nuovo vantaggio "Discount type" parte da "Percentage", "Tax basis" da "Tax excluded" e "Promotion policy" da "Use the better price". Inserisci esplicitamente l'importo. Gli importi fissi richiedono una valuta. Le altre politiche delle promozioni sono "Only products without promotions" e "Stack with promotions".
"Product selection" offre "All products" o "Selected products". Controlla il selettore prima di salvare. Per i vantaggi di spedizione, ogni prodotto fisico nella spedizione deve appartenere alla selezione idonea. Le soglie usano la merce fisica dopo gli sconti sui prodotti e prima degli sconti sul carrello.
Per l'esempio Gold, aggiungi un vantaggio Sconto con "Percentage" e Importo 10. In modalità prezzi del modulo, è una definizione di sconto operativa. Non ricrearla separatamente come sconto nativo di gruppo a meno che tu non abbia scelto intenzionalmente quella fonte.
Visualizzare in anteprima e pubblicare i prezzi
Usa "Price preview" di un livello per provare un prodotto, una combinazione e una quantità. L'anteprima di riferimento usa la valuta e il paese predefiniti del negozio. Mostra i prezzi unitari esclusi ecotassa e personalizzazione. La quantità seleziona lo scaglione di prezzo applicabile.
Controlla la promozione nativa, il risultato della politica, il prezzo finale, la riga compilata e i risultati di compatibilità. Le definizioni salvate e i prezzi compilati possono differire finché la ricostruzione non termina. Usa "Rebuild prices" e attendi "Prices ready" prima di controllare il negozio.
Usa "Shipping preview" per un livello con un vantaggio di spedizione. Fornisci prodotti e quantità oppure un carrello esistente e le sue impostazioni di consegna. Controlla corriere, contenuto della spedizione, costo nativo del trasporto, risparmio, costo da pagare, soglia e importo mancante. Un'anteprima può non essere disponibile quando richiederebbe una chiamata a un altro modulo corriere.
Ricalcolare i clienti e pianificare la manutenzione
Apri Clienti. Usa "Start silent recount" per valutare i clienti esistenti senza inviare messaggi iniziali di cambio livello. Prosegui con "Continue recount" fino al completamento oppure lascia che cron continui.
Per i lotti di calcolo prezzi, usa "Start pricing reconciliation" e "Continue pricing reconciliation". Esamina l'elenco clienti e l'istantanea attuale di un singolo cliente. L'elenco supporta l'esportazione e mostra le informazioni di valutazione memorizzate. Il pannello dei dettagli cliente include le informazioni di fedeltà attuali e lo storico recente.
Apri Impostazioni > Configurazione. In "Scheduled maintenance", copia l'URL generato e richiamalo ogni minuto. Contiene l'ID del negozio e un token privato. Per esempio:
* * * * * curl -fsS "YOUR_EXACT_SCHEDULED_MAINTENANCE_URL" >/dev/null
Usa l'URL effettivamente copiato. Il controller richiede che il suo id_shop corrisponda al negozio della richiesta e un token valido di 64 caratteri. La manutenzione prosegue le valutazioni in scadenza, i lotti di ricalcolo, la riconciliazione dei prezzi e i tentativi di reinvio delle notifiche. Se la suite è attiva, il suo pianificatore gestisce questi processi e l'esecutore autonomo può saltare l'esecuzione.
La stessa pagina offre "Enable edrone" e "edrone app ID". L'integrazione rimane disattivata finché non la attivi e richiede un ID app non vuoto. Non attivarla senza l'identificativo dell'account previsto.
Verificare la visualizzazione cliente e le notifiche
Accedi come cliente di prova dopo il ricalcolo. Apri la pagina dell'account e confronta il livello attuale, la base di qualificazione, il livello successivo, i requisiti non soddisfatti e i vantaggi con l'istantanea del Back Office. Gli ospiti non hanno uno stato fedeltà personale.
Controlla i prezzi in un elenco, in una pagina prodotto, nel carrello e in un ordine di prova completato. Controlla un ordine con promozione e un ordine rimborsato rispetto agli stati conteggiati e alle impostazioni dei rimborsi. Il motore attuale valuta lo storico ordini e le regole di transizione; non si limita ad aggiungere per sempre l'importo di ogni ordine convalidato.
Puoi personalizzare il template dell'account in:
/themes/your-theme/modules/mprloyaltydiscountssystem/views/templates/hook/customer_account.tpl
Usa il template dell'istantanea fedeltà attuale. Applica gli stili al contenitore dell'account con .mpr-loyalty-account, all'elenco delle metriche con .mpr-loyalty-details e ai requisiti non soddisfatti con .mpr-loyalty-requirements. Il vecchio markup del badge e della barra di avanzamento percentuale non è l'interfaccia del template attuale.
L'invio delle e-mail di livello usa mails/en/loyalty_upgrade.html e loyalty_downgrade.html, con supporto per il polacco e ripiego sull'inglese per le altre lingue nel sistema di invio. Le variabili attuali includono {firstname}, {lastname}, {notification}, {tier_name}, {base_tier_name}, {tier_benefits}, {total_turnover}, {window}, {basis}, {next_tier_name}, {shortfalls}, {account_url} e {shop_name}. Il precedente esempio {tier_discount} non è un token attuale del sistema di invio.
Risolvere i problemi e disinstallare
Se non riesci a salvare le modifiche, seleziona un negozio e controlla i permessi del dipendente e la validità del token. Se i clienti non hanno un livello, controlla regole attive, logica dei gruppi, stati conteggiati, metriche disponibili e periodo di valutazione.
Se i prezzi differiscono dalle definizioni, controlla lo stato di ricostruzione e i risultati di compatibilità. Se la spedizione non cambia, controlla l'adozione del corriere e il contenuto idoneo della spedizione. Se i progressi non sono visibili, controlla "Show progress", lo stato di accesso, l'hook dell'account e quale modulo gestisce attualmente l'esecuzione del programma fedeltà.
Usa Impostazioni > Integrità per i controlli dell'infrastruttura del modulo. Esamina il JSON di manutenzione e la diagnostica del modulo per individuare lotti non riusciti o problemi di recapito delle e-mail. Evita di ripetere un salvataggio della definizione riuscito solo perché una ricostruzione successiva non è riuscita; usa "Rebuild prices" per riprovare.
Disattiva o disinstalla tramite "Module Manager" quando vuoi arrestare il modulo. La pulizia durante l'esecuzione rilascia le righe dei prezzi e i diritti sui gruppi detenuti e trasferisce o rilascia i corrieri adottati secondo i casi. Le tabelle di fedeltà condivise sono dichiarate persistenti e vengono conservate. Le voci di menu autonome, la configurazione del modulo e le preferenze di amministrazione vengono rimosse alla disinstallazione. Conserva un backup del database se ti serve un'esportazione storica completa.
Domande
2
Loyalty Discounts System rallenta il mio negozio?
In un'installazione multinegozio, la spesa fedeltà è tracciata per negozio o combinata?
No. I programmi fedeltà e lo stato del cliente sono separati per negozio e la query sulla cronologia include solo gli ordini di quel negozio. Valuta e controlla il cliente separatamente in ciascun negozio interessato.
Problemi noti
14
Rafforzamento della sicurezza
Il ricalcolo poteva cancellare la posizione del cliente
Gli ordini non pagati potevano assegnare un livello fedeltà
Buoni e rimborsi alteravano la spesa idonea
I prezzi per livello potevano essere errati o gli sconti inattivi
La ricostruzione dei prezzi poteva alterare le promozioni
Le etichette del menu fedeltà erano illeggibili
I clienti idonei potevano non ricevere il proprio livello
I messaggi di amministrazione restavano in inglese
Comparivano traduzioni errate
Le risorse combinate potevano compromettere l'aspetto del negozio
Gli stati d'ordine fedeltà selezionati non venivano conservati
Dati fedeltà necessari mancanti dopo l'installazione
I filtri delle liste di amministrazione funzionavano male
Richieste funzionalità
12
Implementato
Sconti fedeltà basati su soglie di spesa
Livelli fedeltà basati sulla spesa
Aggiornamenti del modulo dal back office
Verifiche dell’installazione
Altre lingue di amministrazione
Gestione avanzata dei livelli
Vantaggi fedeltà sulla spedizione
Regole di interazione con le promozioni
Periodo di calcolo della spesa
Protezione del livello raggiunto
Email fedeltà più complete
Tag dei livelli per edrone
Registro modifiche
v1.1.102026-09-22
- Addedcomplete FR/DE/ES/IT/PL translations
- FixedPersist loyalty order state settings
- FixedInstall loyalty tables through schema manager
- FixedReplace Tools::displayPrice with PriceFormatter compat wrapper
Versioni precedenti
v1.0.02026-05-11
- Initialrelease: automatic customer group assignment based on cumulative spending thresholds
- InitialConfigurable tiers: set spending threshold and target customer group per level
- InitialCompatible with PrestaShop native customer group discounts for seamless pricing rules
- InitialAdmin overview showing each customer's current tier, total spend, and next threshold
v1.3.02026-04-20
- Addedadmin menu management via MenuInstaller for streamlined module setup
- Addedself-healing integrity checks for automatic diagnostics and repair
- AddedLicense management tab with key management and renewal options
- Addedcomplete FR/DE/ES/IT/PL translations
- Improvedsettings form organization with tabbed layout
- Fixedadmin list filters — sorting, searching, and filtering now work correctly on all columns
v1.2.02026-02-19
- Addedfull compatibility with PrestaShop 9.x and Hummingbird theme
- Addedspending tier preview on the My Account page showing progress to next discount level
- Improvedcumulative spend recalculation: background job processes all customers nightly via cron
- Fixedcustomer group not reverting when a qualifying order was refunded
- Addedconfigurable spending currency for multi-currency stores with exchange rate normalisation
v1.1.02025-10-07
- Addedthreshold editor with unlimited tiers, each with its own discount percentage or fixed amount
- Improvedaudit log: records each group assignment change with trigger order reference
- Fixedtier upgrade not applying immediately when order status changed to 'Payment accepted'
- Addedemail notification template for customers promoted to a new loyalty tier
Demo
Prova il modulo completo prima di acquistare
Acquista la licenza in seguito e mantieni le tue impostazioni.
- La tua demo di 30 giorni Provalo sul tuo negozio per 30 giorni dalla prima installazione.
- Negozio demo pronto Esplora un negozio demo pronto nel tuo browser.
- Senza registrazione Nessun account, e-mail o dominio del negozio richiesto.
Scaricando, accetti le condizioni della demo e l’informativa sulla privacy.
Aprendo questa demo accetti i termini della demo e la politica sulla privacy.