Configurazione Globale
Il pannello di Configurazione Globale è il luogo in cui si controlla il comportamento principale del modulo: quali metodi di pagamento attivano i promemoria, come appare il wrapper delle email, come funziona la modalità di test, quando gli ordini non pagati vengono annullati automaticamente e chi riceve il riepilogo giornaliero per l'amministratore.
Disponibile dalla v1.2.0
Panoramica
Order Payment Reminders Pro separa cosa si dice (i singoli messaggi di promemoria che si creano) da come si comporta il sistema (le regole globali che li governano tutti). Le impostazioni descritte in questa guida riguardano la seconda parte.
La maggior parte di queste impostazioni va configurata una sola volta durante la configurazione iniziale e raramente viene modificata in seguito. L'eccezione principale è la Modalità di Test, che si attiverà e disattiverà ogni volta che si desidera verificare la sequenza di promemoria senza influire sui clienti reali.
La pagina di configurazione è organizzata nelle seguenti sezioni: Configurazione del Modulo (la checklist di configurazione), Modalità di Test, Impostazioni Globali, Template Email e Configurazione Cron Job. Ogni sezione con campi modificabili ha il proprio pulsante Salva.
Configurazione
- Accedere al Back Office.
- Andare su Moduli > Gestore Moduli.
- Trovare Order Payment Reminders Pro e fare clic su Configura.
- La pagina si apre sulla scheda Configurazione del Modulo quando la configurazione è incompleta, oppure sulla vista di configurazione principale una volta che la checklist è completamente terminata.
- Scorrere attraverso ciascuna sezione oppure utilizzare le schede di navigazione a sinistra per spostarsi tra Configurazione del Modulo, Modalità di Test, Impostazioni Globali, Template Email e Configurazione Cron Job.
Configurazione del Modulo — Checklist di Configurazione
Il pannello Configurazione del Modulo è una checklist guidata che tiene traccia della configurazione iniziale. La barra di avanzamento in cima mostra quanti dei quattro passaggi richiesti sono stati completati. Il modulo non invia alcun promemoria finché tutti e quattro i passaggi non mostrano un badge verde "Configurato".
Passaggio 1 — Template Email
Selezionare il wrapper HTML che circonda tutte le email di promemoria. È possibile scegliere tra template pre-progettati o crearne uno personalizzato.
Dopo aver selezionato un template, appare un'area di testo in cui è possibile modificare direttamente l'HTML. Il template deve contenere entrambi i segnaposto {wr_title} e {wr_message} — il modulo non segnerà questo passaggio come completato senza di essi.
Il segnaposto
{wr_title}viene automaticamente sostituito con l'oggetto di ogni singolo messaggio di promemoria. Non è necessario digitare un oggetto direttamente nel template.
Fare clic su Salva Template per memorizzare le modifiche. Il badge del passaggio diventa verde una volta salvato un template valido.
Passaggio 2 — Moduli di Pagamento
Scegliere quali metodi di pagamento devono attivare le email di promemoria. Solo gli ordini pagati tramite un metodo selezionato entreranno nella coda dei promemoria.
Un elenco di caselle di controllo mostra tutti i moduli di pagamento attualmente installati nel negozio. Selezionare ogni metodo per cui si desidera che vengano inviati i promemoria — ad esempio, Bonifico Bancario per gli ordini con pagamento tramite bonifico o un modulo di pagamento offline personalizzato.
Se si desidera sequenze di promemoria diverse per metodi di pagamento diversi, è possibile assegnare un modulo di pagamento specifico a ciascun messaggio di promemoria al momento della sua creazione. La selezione globale qui funge da filtro — se un modulo di pagamento non è selezionato, i suoi ordini non riceveranno mai promemoria, indipendentemente dalle impostazioni dei singoli messaggi.
Fare clic su Salva Moduli di Pagamento per confermare. Il badge del passaggio diventa verde una volta selezionato almeno un modulo.
Passaggio 3 — Crea Messaggi
Creare almeno un messaggio di promemoria per definire cosa viene inviato e quando. Sono disponibili template di messaggi pre-scritti in tre categorie di tono:
- Promemoria Gentile — primi promemoria amichevoli inviati alcuni giorni dopo l'ordine
- Sollecito Persistente — secondo e terzo contatto per i clienti che non rispondono
- Urgente / Finale — avvisi dell'ultima possibilità inviati vicino alla scadenza di annullamento
Utilizzare i menu a tendina per precompilare un nuovo messaggio con uno di questi template, quindi fare clic su Crea Nuovo Messaggio per aprire l'editor dei messaggi. Consultare Messaggi di Promemoria per una guida completa.
Passaggio 4 — Test e Verifica
Prima di andare in produzione, inviare un'email di test per confermare che il server possa consegnare i messaggi correttamente. Inserire qualsiasi indirizzo email nel campo e fare clic su Invia Email di Test. L'email include un link di verifica — facendo clic su di esso si segna la configurazione come verificata e questo passaggio diventa verde.
Il Passaggio 4 è bloccato fino al completamento dei Passaggi 1–3.
Consultare Verifica Email per una spiegazione dettagliata del funzionamento del sistema di verifica.
Modalità di Test
La sezione Modalità di Test consente di validare in sicurezza la sequenza di promemoria senza influire sui clienti reali o sugli ordini reali.
| Campo | Valori | Predefinito | Descrizione |
|---|---|---|---|
| Abilita Modalità di Test | Sì / No | Sì (all'installazione) | Quando attiva, tutte le email di promemoria vengono inviate all'indirizzo di test indicato di seguito anziché ai clienti reali. Gli ordini non vengono annullati e lo stato dei messaggi inviati non viene aggiornato — quindi gli stessi messaggi vengono inviati ad ogni esecuzione. |
| Indirizzo Email di Test | Qualsiasi email valida | Email dell'amministratore del negozio | L'indirizzo che riceve tutte le email mentre la modalità di test è attiva. |
| Output di Test | Email / Schermo | Email invia il promemoria all'indirizzo di test. Schermo stampa l'output di elaborazione direttamente nel browser invece di inviare email. |
Quando la modalità di test è attiva, appare un banner informativo blu in ogni sezione del modulo come promemoria. Assicurarsi sempre di aver disabilitato la modalità di test prima di aspettarsi che i clienti reali ricevano i promemoria.
Fare clic su Salva in fondo al modulo Modalità di Test per applicare le modifiche.
Impostazioni Globali
La sezione Impostazioni Globali controlla il comportamento di annullamento degli ordini e la notifica del riepilogo per l'amministratore.
| Campo | Valori | Predefinito | Descrizione |
|---|---|---|---|
| Attiva Funzione Annullamento Ordini | Sì / No | No | Quando abilitata, gli ordini non pagati vengono annullati automaticamente una volta trascorso il numero di giorni impostato di seguito dalla data di creazione dell'ordine. I prodotti degli ordini annullati vengono restituiti al magazzino. |
| Annulla Ordine dopo | Numero di giorni | — | Il numero di giorni dopo i quali un ordine non pagato viene annullato automaticamente. La descrizione del campo mostra il valore attualmente impostato nel modulo nativo Bonifico Bancario (se installato) come riferimento consigliato. Se un singolo messaggio di promemoria ha l'opzione "annulla ordine" abilitata ed è pianificato prima di questo valore, l'annullamento a livello di messaggio ha la priorità. |
| Email Riepilogo Amministratore | Sì / No | No | Quando abilitata, il modulo invia un riepilogo giornaliero degli ordini che si avvicinano alla scadenza di annullamento. Il riepilogo viene inviato una volta al giorno e solo quando esiste almeno un ordine idoneo. |
| Email Riepilogo | Qualsiasi email valida | Email del negozio | L'indirizzo che riceve il riepilogo per l'amministratore. Lasciare vuoto per utilizzare l'indirizzo email principale del negozio. |
| Avviso Prima dell'Annullamento | Numero di ore | 24 | Quante ore prima della scadenza di annullamento un ordine deve trovarsi per apparire nel riepilogo. Ad esempio, 24 significa che si riceve un avviso un giorno prima della scadenza. |
La funzione di annullamento automatico rispetta la Modalità di Test. Se la modalità di test è attiva, nessun ordine verrà annullato anche se la scadenza di annullamento è già trascorsa.
Il riepilogo per l'amministratore richiede che siano abilitate sia Attiva Funzione Annullamento Ordini che Email Riepilogo Amministratore, e Annulla Ordine dopo deve essere impostato su un valore maggiore di zero.
Fare clic su Salva in fondo al modulo Impostazioni Globali per applicare le modifiche.
Template Email
La sezione Template Email fornisce un editor rich-text (TinyMCE) completo in cui è possibile personalizzare il wrapper HTML che circonda ogni email di promemoria.
Questa sezione appare solo dopo che la checklist di Configurazione del Modulo è stata completata almeno una volta. Completare prima tutti e quattro i passaggi di configurazione.
Il template deve contenere due segnaposto obbligatori:
| Segnaposto | Sostituito con |
|---|---|
{wr_title} | L'oggetto del singolo messaggio di promemoria inviato |
{wr_message} | Il contenuto del corpo del singolo messaggio di promemoria inviato |
Nel template possono comparire anche qualsiasi altra variabile supportata ({shop_name}, {shop_logo}, {completename}, ecc.).
Fare clic su Salva per applicare le modifiche. Consultare Template e Design Email per il riferimento completo ai template.
Configurazione Cron Job
La sezione Configurazione Cron Job fornisce l'URL da aggiungere nel pannello di hosting affinché il modulo venga eseguito automaticamente ogni giorno.
L'URL del cron contiene una chiave di sicurezza (?key=...) che impedisce a soggetti non autorizzati di avviare il processo di promemoria. Questa chiave viene generata automaticamente quando il modulo viene installato e memorizzata in modo permanente — non cambia quando si salvano altre impostazioni o si reinstalla il modulo su un'installazione esistente.
Copiare l'URL completo visualizzato in questa sezione e aggiungerlo come cron job nel pannello di controllo del proprio hosting o server. La frequenza consigliata è una volta al giorno, anche se è supportata anche la cadenza oraria se si utilizzano pianificazioni di promemoria basate sulle ore.
Non condividere mai pubblicamente l'URL del cron. Se si sospetta che sia stato esposto, contattare il supporto per reimpostare la chiave.
Consultare Configurazione Cron Job per istruzioni dettagliate sui pannelli di hosting.
Come Funziona
Comportamento della Modalità di Test
Quando la Modalità di Test è abilitata, il modulo intercetta ogni email di promemoria in uscita e la reindirizza all'indirizzo email di test configurato. Nessun cliente riceve mai un'email in questo stato. Inoltre, il modulo salta l'aggiornamento dello stato "inviato" per ogni messaggio, quindi l'esecuzione più volte del cron invia gli stessi messaggi ogni volta — consentendo di eseguire test iterativi senza reimpostare i dati.
Anche l'annullamento degli ordini è completamente disabilitato durante la modalità di test, anche se la scadenza di annullamento è già trascorsa per uno o più ordini.
Annullamento Globale vs. Annullamento per Singolo Messaggio
Esistono due modi per annullare automaticamente gli ordini non pagati:
- Impostazione globale: Abilitare Attiva Funzione Annullamento Ordini e impostare Annulla Ordine dopo su un numero di giorni. Ogni ordine non pagato corrispondente ai metodi di pagamento selezionati verrà annullato dopo quel numero di giorni.
- Annullamento per singolo messaggio: Abilitare l'opzione "annulla ordine" su un singolo messaggio di promemoria. L'annullamento si attiva quando quel messaggio specifico viene inviato, indipendentemente dall'impostazione globale dei giorni.
Se entrambi sono configurati e l'annullamento per singolo messaggio si attiva prima, l'impostazione globale viene ignorata per quell'ordine. Ciò consente di applicare scadenze effettive diverse a metodi di pagamento o sequenze di promemoria diversi.
Logica del Riepilogo per l'Amministratore
Il riepilogo per l'amministratore viene eseguito durante la stessa esecuzione del cron che elabora i promemoria. Controlla gli ordini non pagati la cui scadenza di annullamento ricade nella finestra Avviso Prima dell'Annullamento (ad esempio, nelle prossime 24 ore). Se esiste almeno un ordine di questo tipo, invia un'email di riepilogo all'indirizzo di riepilogo configurato.
Il riepilogo è soggetto a throttling: una volta inviato in un determinato giorno, non verrà inviato nuovamente fino al giorno successivo, anche se si esegue il cron manualmente più volte.
Filtro Moduli di Pagamento
La selezione del modulo di pagamento nel Passaggio 2 della checklist di configurazione funge da lista di consenso globale. Solo gli ordini dei metodi di pagamento selezionati riceveranno mai promemoria. È possibile restringere ulteriormente il pubblico a livello di singolo messaggio assegnando un metodo di pagamento specifico a ciascun promemoria, ma non è possibile aggiungere a livello di messaggio un metodo di pagamento che non era stato prima abilitato globalmente.
Esempi d'Uso
Esempio: Negozio con bonifico bancario che va in produzione per la prima volta
Un negozio che utilizza solo pagamenti tramite bonifico bancario vuole inviare un promemoria a 3 giorni, un sollecito a 7 giorni e annullare tutti gli ordini non pagati dopo 14 giorni.
- In Configurazione del Modulo, selezionare un template email e selezionare il modulo di pagamento Bonifico Bancario.
- Creare tre messaggi di promemoria (3 giorni, 7 giorni, 14 giorni) e impostare il messaggio di 14 giorni su "annulla ordine".
- In Impostazioni Globali, lasciare disabilitata Attiva Funzione Annullamento Ordini — l'annullamento per messaggio al giorno 14 lo gestisce.
- Abilitare Email Riepilogo Amministratore con Avviso Prima dell'Annullamento impostato a
48ore in modo da avere due giorni di preavviso prima che un ordine venga annullato. - Disabilitare la Modalità di Test una volta verificata la consegna delle email tramite la checklist di configurazione.
Esempio: Negozio multi-pagamento con scadenze di annullamento diverse
Un negozio accetta sia il bonifico bancario che un metodo di ritiro in contrassegno. Gli ordini tramite bonifico dovrebbero essere annullati dopo 10 giorni; quelli in contrassegno dopo 3 giorni.
- Selezionare entrambi i moduli di pagamento in Configurazione del Modulo.
- Creare una sequenza di promemoria separata per ciascun modulo di pagamento (assegnata per messaggio utilizzando il campo Modulo di Pagamento in ogni messaggio).
- In Impostazioni Globali, impostare Annulla Ordine dopo a
10giorni e abilitare la funzione di annullamento. Per il metodo in contrassegno, aggiungere un messaggio al giorno 3 con "annulla ordine" abilitato — questo sovrascrive il limite globale di 10 giorni per quegli ordini.
Esempio: Test di un nuovo messaggio senza inviare email ai clienti
Si aggiunge un nuovo messaggio di sollecito urgente e si vuole verificare che venga visualizzato correttamente prima che raggiunga i clienti reali.
- In Modalità di Test, impostare Abilita Modalità di Test su Sì e inserire il proprio indirizzo email.
- Eseguire manualmente l'URL del cron dal browser una volta.
- Controllare la posta in arrivo per l'email di test e confermare che il layout, le variabili e l'oggetto siano corretti.
- Reimpostare Abilita Modalità di Test su No e fare clic su Salva una volta soddisfatti.
Note Importanti
- La modalità di test è abilitata per impostazione predefinita su una nuova installazione. È necessario disabilitarla manualmente prima che il modulo invii email ai clienti reali.
- Il riepilogo per l'amministratore è soggetto a throttling a una email per giorno solare. Se è già stato inviato oggi, non verrà inviato nuovamente fino a domani anche se si esegue il cron manualmente.
- Il campo dei giorni Annulla Ordine dopo è un fallback. Se un messaggio di promemoria ha "annulla ordine" abilitato ed è pianificato prima del limite globale di giorni, l'annullamento a livello di messaggio viene eseguito per primo e il limite globale viene ignorato per quell'ordine.
- La chiave del cron è memorizzata a livello globale (non per negozio) e viene preservata durante le reinstallazioni del modulo finché la riga del database esiste. Si rigenererà solo dopo una disinstallazione completa che cancella la configurazione del modulo.
- In una configurazione multi-shop, la selezione del modulo di pagamento e la maggior parte delle impostazioni globali sono per negozio. La chiave di sicurezza del cron (
wr_cron_key) è globale per tutti i negozi. - L'editor Template Email è nascosto fino al completamento della checklist di Configurazione del Modulo almeno una volta. Appare automaticamente una volta completati tutti e quattro i passaggi.
Risoluzione dei Problemi
| Problema | Soluzione |
|---|---|
| Il modulo mostra "Modulo non ancora attivo" anche dopo aver salvato le impostazioni | Completare tutti e quattro i passaggi nella checklist di Configurazione del Modulo. Ogni passaggio deve mostrare un badge verde "Configurato". Il passaggio mancante più comune è la verifica email (Passaggio 4). |
| Le email vengono inviate ai clienti mentre la Modalità di Test sembra essere attiva | Confermare di aver fatto clic su Salva nel modulo Modalità di Test dopo averla abilitata. Verificare che il banner blu della modalità di test sia visibile in tutte le sezioni del modulo. |
| Il riepilogo per l'amministratore non viene mai ricevuto | Confermare che Attiva Funzione Annullamento Ordini sia abilitata, che Annulla Ordine dopo sia un numero positivo e che Email Riepilogo Amministratore sia impostata su Sì. Il riepilogo viene inviato solo quando almeno un ordine si trova nella finestra di avviso. Controllare la cartella spam. |
| Il riepilogo per l'amministratore è stato inviato una volta e poi si è fermato | Comportamento previsto — il riepilogo è soggetto a throttling a una volta al giorno. Riprenderà domani quando il cron verrà eseguito di nuovo. |
| L'URL del cron è cambiato dopo la reinstallazione del modulo | La chiave viene preservata finché la riga del database esiste. Una disinstallazione completa (che rimuove la configurazione) causa la rigenerazione della chiave. Aggiornare l'URL del cron nel pannello di hosting dopo una reinstallazione completa. |
| Il modulo Template Email non è visibile | L'editor appare solo dopo che la checklist di Configurazione del Modulo è stata completata almeno una volta. Completare prima tutti e quattro i passaggi di configurazione. |
| L'Output di Test impostato su "Schermo" non mostra nulla | L'output su schermo viene stampato come testo normale quando l'URL del cron viene chiamato direttamente in un browser. Assicurarsi di aprire l'URL del cron direttamente nel browser e non di attivarlo dall'interfaccia del Back Office. |
| Gli ordini non vengono annullati automaticamente | Confermare che Attiva Funzione Annullamento Ordini sia abilitata e che Annulla Ordine dopo sia un numero positivo. Confermare inoltre che la modalità di test sia disabilitata — l'annullamento automatico viene soppresso mentre la modalità di test è attiva. |
Domande Frequenti
È necessario configurare le Impostazioni Globali prima di creare i messaggi di promemoria?
No. È possibile creare messaggi di promemoria in qualsiasi momento. Tuttavia, il modulo non invierà alcuna email finché tutti e quattro i passaggi nella checklist di Configurazione del Modulo non sono completati, inclusa la verifica email.
Cosa succede ai prodotti quando un ordine viene annullato automaticamente?
Gli ordini annullati hanno le quantità dei loro prodotti restituite al magazzino. L'annullamento utilizza il processo standard di annullamento degli ordini di PrestaShop, quindi i livelli di stock, la cronologia degli ordini e le statistiche vengono tutti aggiornati correttamente.
Posso impostare una scadenza di annullamento diversa per metodi di pagamento diversi?
Sì. Il valore globale Annulla Ordine dopo si applica a tutti i metodi di pagamento per impostazione predefinita. Per sovrascriverlo per un metodo specifico, creare un messaggio di promemoria assegnato a quel metodo di pagamento e abilitare l'opzione "annulla ordine" su quel messaggio. L'annullamento a livello di messaggio si attiva per primo e bypassa il limite globale per gli ordini di quel metodo di pagamento.
Il riepilogo email per l'amministratore mostra tutti gli ordini in sospeso o solo quelli vicini all'annullamento?
Solo gli ordini che si trovano nella finestra Avviso Prima dell'Annullamento configurata (predefinita: 24 ore). Gli ordini che hanno ancora molto tempo prima della scadenza non vengono inclusi.
Posso utilizzare un indirizzo email diverso per il riepilogo per l'amministratore e l'email di contatto del negozio?
Sì. Compilare il campo Email Riepilogo con qualsiasi indirizzo. Lasciarlo vuoto se si desidera che il riepilogo venga inviato all'indirizzo email principale del negozio configurato in PrestaShop.
A cosa serve l'opzione "Schermo" per l'Output di Test?
È uno strumento diagnostico per ambienti server in cui la consegna delle email non è affidabile o non è configurata. Invece di inviare email, stampa un riepilogo testuale di ogni ordine elaborato e di ogni messaggio che sarebbe stato inviato. Questo è utile per il debug iniziale lato server.
Il modulo invierà email ai clienti se dimentico di disabilitare la Modalità di Test?
No. Mentre la Modalità di Test è attiva, tutte le email di promemoria vengono reindirizzate all'indirizzo email di test impostato. Nessun cliente riceverà un promemoria fino a quando non si disabilita esplicitamente la Modalità di Test e si salva.
Come posso reimpostare la chiave di sicurezza del cron?
La chiave non può essere reimpostata dal Back Office. Contattare il team di supporto del modulo se è necessario ruotare la chiave dopo un incidente di sicurezza.
Se seleziono più moduli di pagamento nella checklist di configurazione, tutti gli ordini di quei metodi riceveranno gli stessi promemoria?
Per impostazione predefinita, sì — tutti i metodi di pagamento selezionati condividono gli stessi messaggi di promemoria. Se si desidera una sequenza diversa per metodo, assegnare un modulo di pagamento specifico a ogni singolo messaggio di promemoria utilizzando il campo Modulo di Pagamento durante la modifica di quel messaggio.