Modalità Test
La modalità test ti permette di eseguire l'intera sequenza di promemoria su ordini reali in attesa senza coinvolgere i tuoi clienti né i dati live.
Disponibile dalla v1.0.3
Tutte le email vengono indirizzate a un unico indirizzo sotto il tuo controllo, gli ordini non vengono mai annullati e il contatore dello stato di invio è volutamente bloccato, così puoi ripetere lo stesso test quante volte vuoi.
Panoramica
Quando installi Order Payment Reminders Pro per la prima volta, la modalità test è attiva per impostazione predefinita. Questa scelta è intenzionale: il modulo è pronto a elaborare gli ordini, ma nulla raggiunge i tuoi clienti finché non hai verificato ogni passaggio e non hai attivato esplicitamente il funzionamento live.
Mentre la modalità test è attiva, il cron elabora gli ordini esattamente come farebbe in produzione — valuta le pianificazioni, costruisce il contenuto delle email e applica tutte le variabili personalizzate — ma con tre differenze fondamentali:
- Ogni email di promemoria in uscita viene reindirizzata al tuo indirizzo di test configurato invece che all'indirizzo del cliente.
- Gli ordini che verrebbero altrimenti annullati (a causa delle regole di annullamento automatico) non vengono annullati. L'esecuzione del cron registra ciò che avrebbe fatto, ma non compie alcuna azione.
- Il record "ultimo messaggio inviato" per ciascun ordine non viene aggiornato. Ciò significa che lo stesso messaggio di promemoria verrà inviato a ogni esecuzione del cron durante i test, così puoi esaminare ogni messaggio più volte senza dover creare nuovi ordini non pagati.
L'email digest dell'amministratore (il riepilogo giornaliero degli ordini prossimi all'annullamento) è un report interno indirizzato a te, non ai clienti. Viene sempre inviata all'indirizzo del destinatario del digest che hai impostato, indipendentemente dal fatto che la modalità test sia attiva o meno.
Configurazione
Attiva la modalità test e imposta il tuo indirizzo di test
- Vai su Moduli > Gestione moduli, trova Order Payment Reminders Pro e clicca su Configura.
- Scorri fino alla sezione Modalità Test (o clicca sulla scheda Modalità Test dalla panoramica).
- Conferma che Attiva Modalità Test sia impostato su Sì. Questa è l'impostazione predefinita dopo l'installazione.
- Inserisci il tuo indirizzo email nel campo Indirizzo Email di Test. Tutte le email di promemoria verranno consegnate qui invece che ai clienti. Il campo è precompilato con l'email amministratore del tuo negozio.
- Scegli una modalità Output Test:
- Email (predefinita) — l'esecuzione del cron invia email reali all'indirizzo di test. Usala per verificare la consegna e la formattazione.
- Schermo — l'esecuzione del cron stampa un log di elaborazione dettagliato nel browser invece di inviare email. Usala per tracciare quali ordini vengono rilevati, quali messaggi verrebbero inviati e quali ordini verrebbero annullati.
- Clicca su Salva.
Un banner informativo blu appare nella parte superiore della pagina di configurazione del modulo ogni volta che la modalità test è attiva, confermando che i clienti reali non vengono contattati.
Invia un'email di verifica una tantum
La dashboard di configurazione include un pulsante dedicato Invia Email di Test (Passaggio 4 — Testa e Verifica) separato dal flusso di test basato sul cron descritto sopra. Usalo per confermare che PrestaShop sia in grado di inviare email prima di eseguire il test completo del cron.
- Nel Back Office, vai su Moduli > Gestione moduli > Order Payment Reminders Pro > Configura.
- La dashboard si apre per impostazione predefinita. Espandi il Passaggio 4 — Testa e Verifica (si apre automaticamente una volta completati i passaggi 1–3).
- Inserisci l'indirizzo email su cui vuoi ricevere la consegna di test.
- Clicca su Invia Email di Test.
- Controlla la tua casella di posta. L'email contiene un link Verifica Consegna Email. Cliccalo per contrassegnare la tua configurazione come verificata.
Questo pulsante invia una singola email di verifica tramite il sistema di posta di PrestaShop. Non interagisce con la logica del cron per i promemoria e non richiede la presenza di ordini non pagati nel tuo negozio.
Passa al funzionamento live
Quando sei soddisfatto della tua configurazione:
- Torna su Moduli > Gestione moduli > Order Payment Reminders Pro > Configura.
- Scorri fino alla sezione Modalità Test.
- Imposta Attiva Modalità Test su No.
- Clicca su Salva.
Dalla successiva esecuzione del cron in poi, le email di promemoria vengono inviate agli indirizzi reali dei clienti, gli ordini vengono annullati secondo le regole di annullamento automatico e lo stato di invio di ciascun ordine viene aggiornato in modo che ogni messaggio venga inviato una sola volta.
Dopo aver disattivato la modalità test, gli ordini elaborati durante i test verranno trattati come se non fossero stati inviati promemoria — perché lo stato di invio non è mai stato aggiornato durante i test. La prima esecuzione del cron live valuterà ogni ordine da zero e invierà il promemoria appropriato in base alla tua pianificazione.
Riferimento impostazioni
| Impostazione | Valori | Predefinito | Descrizione |
|---|---|---|---|
| Attiva Modalità Test | Sì / No | Sì (all'installazione) | Se impostato su Sì, attiva tutte le protezioni della modalità test: reindirizzamento email, blocco annullamenti e blocco dello stato di invio. |
| Indirizzo Email di Test | Qualsiasi email valida | Email amministratore del negozio | Tutte le email di promemoria vengono consegnate a questo indirizzo mentre la modalità test è attiva. Non influisce sull'email digest dell'amministratore. |
| Output Test | Email / Schermo | Controlla dove vengono visualizzati i risultati del test. Email invia all'indirizzo di test. Schermo stampa il log di elaborazione nel browser quando l'URL del cron viene aperto direttamente. |
Come Funziona
Quando il cron viene eseguito con la modalità test attiva, legge l'impostazione wr_test_mode all'inizio di ogni ciclo di elaborazione. Da quel momento ogni ordine viene gestito con le seguenti modifiche:
Reindirizzamento email — Invece di cercare l'indirizzo email del cliente, il modulo utilizza l'indirizzo memorizzato in wr_test_email. L'email viene completamente renderizzata con tutte le variabili sostituite esattamente come avverrebbe in produzione, quindi ciò che ricevi nella tua casella di test è un'anteprima accurata di ciò che vedrebbe il cliente.
Blocco annullamenti — Quando un ordine supera la scadenza di annullamento automatico, il modulo salta l'annullamento effettivo. Se hai Output Test impostato su Schermo, stampa una riga Direct Cancel Order per ogni ordine che sarebbe stato annullato, così puoi verificare che la logica sia corretta.
Blocco stato di invio — Dopo l'invio di un'email di test, la chiamata updateLastMessageSent() viene saltata. Il record del promemoria dell'ordine nel database non viene aggiornato. Ciò significa che lo stesso ordine si riqualificherà alla prossima esecuzione del cron, che è esattamente quello che vuoi durante i test.
Modalità output schermo — Quando Output Test è impostato su Schermo e apri l'URL del cron nel browser, il controller stampa un log riga per riga: quanti ordini sono stati trovati, il risultato dell'elaborazione per ciascun ordine (messaggio inviato, ordine che sarebbe stato annullato, ordine già all'ultimo messaggio) e un separatore tra gli ordini. In questa modalità non vengono inviate email.
Come interagisce con ogni tipo di email
| Tipo di email | Modalità test ATTIVA | Modalità test DISATTIVA |
|---|---|---|
| Email di promemoria (rivolte al cliente) | Reindirizzate all'indirizzo di test | Inviate al cliente |
| Notifica annullamento automatico (annullamento per messaggio) | Bloccata — il cron registra l'annullamento in modalità Schermo | Ordine annullato, cliente notificato |
| Annullamento automatico globale (impostazione giorni di annullamento) | Bloccato — il cron registra l'annullamento in modalità Schermo | Ordine annullato |
| Email digest amministratore | Sempre inviata al destinatario del digest — non influenzata dalla modalità test | Sempre inviata al destinatario del digest |
Esecuzione del cron in modalità test
Una volta configurata la modalità test, attiva manualmente l'URL del cron dal browser o tramite terminale per vederlo in azione:
- Copia l'URL del cron dalla sezione Configurazione Cron della configurazione del modulo.
- Apri l'URL nel browser (o eseguilo con
curl). - Se Output Test è impostato su Schermo, vedrai un log riga per riga: quanti ordini sono stati trovati, quale messaggio riceverebbe ciascun ordine e quali ordini verrebbero annullati.
- Se Output Test è impostato su Email, controlla la casella di test che hai configurato. Ogni ordine idoneo genera un'email di promemoria consegnata a quell'indirizzo.
Consulta Configurazione Cron per le istruzioni su come trovare e pianificare l'URL del cron.
Esempi d'Uso
Esempio: Verifica della configurazione iniziale
Hai appena installato il modulo e creato due messaggi di promemoria: uno inviato dopo 2 giorni e un follow-up inviato dopo 5 giorni. La modalità test è attiva. Apri l'URL del cron nel browser con Output Test impostato su Email. Vengono trovati tre ordini non pagati. Ricevi sei email di test nella tua casella — due per ordine, poiché entrambi i messaggi vengono valutati ogni volta. Le righe dell'oggetto e la sostituzione delle variabili sembrano corrette. Clicchi sul link di verifica nella dashboard del Passaggio 4, che contrassegna la tua configurazione come verificata. Quindi imposti Attiva Modalità Test su No e il modulo entra in funzionamento live.
Esempio: Debug di un problema di formattazione
Una variabile personalizzata {shop_phone} mostra la chiave di configurazione grezza invece del suo valore in uno dei tuoi messaggi di promemoria. Passi Output Test a Schermo e apri l'URL del cron. Il log di elaborazione mostra il contenuto esatto del messaggio inviato per ciascun ordine, rendendo immediatamente visibile la sostituzione mancante. Correggi la definizione della variabile, torni all'output Email e confermi che la correzione sia corretta prima di salvare.
Esempio: Anteprima di un nuovo template senza disturbare i clienti
Vuoi passare dal tuo attuale template email a uno dei 14 template predefiniti. Attivi la modalità test (se era disattiva), applichi il nuovo template e avvii un'esecuzione del cron. L'email di test arriva nella tua casella con l'output completamente renderizzato incluse le variabili specifiche dell'ordine. Una volta approvato il layout, disattivi la modalità test.
Note Importanti
- La modalità test è globale — si applica a tutti i negozi in una configurazione multi-negozio. Non esiste una modalità test per singolo negozio.
- Il blocco dello stato di invio è intenzionale. Poiché lo stato non viene aggiornato durante i test, gli stessi ordini produrranno le stesse email a ogni esecuzione di test. Questo ti permette di ripetere i test senza dover avere nuovi ordini non pagati ogni volta.
- Se hai ordini con un record "ultimo messaggio inviato" da una precedente esecuzione live, quegli ordini non riceveranno di nuovo lo stesso messaggio durante i test. La modalità test blocca solo i nuovi aggiornamenti; non azzera i record esistenti.
- Il digest amministratore ignora la modalità test. Se vuoi sopprimere il digest durante i test, disabilitalo separatamente nella sezione Digest Amministratore.
- Il pulsante Invia Email di Test nel Passaggio 4 è indipendente dalla modalità test. Consegna sempre all'indirizzo che digiti nell'input del Passaggio 4 — non viene reindirizzato attraverso l'impostazione dell'indirizzo email di test e non interagisce con la logica del cron.
Risoluzione dei Problemi
| Problema | Soluzione |
|---|---|
| Le email di test non arrivano | Verifica la configurazione email di PrestaShop tramite Parametri Avanzati > Email. Usa il pulsante Invia Email di Test nel Passaggio 4 per confermare la consegna di base prima di eseguire il cron. |
| L'output Schermo è vuoto quando apro l'URL del cron | Conferma che l'URL del cron includa il parametro key= o token= corretto. Un token non valido o mancante fa uscire il controller in silenzio. Se l'URL è valido ma non esistono ordini nello stato in attesa di pagamento, il cron restituisce "No unpaid bankwire orders" e si interrompe. |
| Le email arrivano ai clienti reali anche se la modalità test sembra attiva | Conferma di aver salvato dopo aver attivato la modalità test — clicca su Salva e cerca il banner informativo blu nella parte superiore della pagina, che conferma che la modalità test è attiva. |
| Gli stessi ordini continuano ad apparire a ogni esecuzione del cron | Questo è il comportamento atteso durante i test. Lo stato di invio è bloccato intenzionalmente. Dopo il passaggio alla modalità live, lo stato si aggiorna normalmente e ogni messaggio viene inviato una sola volta. |
| Il digest amministratore continua a essere inviato durante i test | Questo è il comportamento corretto. Il digest è un report interno per l'amministratore e non viene soppresso dalla modalità test. Per bloccarlo durante i test, disabilitalo nella sezione Digest Amministratore. |
| La modalità test era attiva per diverse esecuzioni del cron — gli ordini riceveranno messaggi duplicati quando si passa alla modalità live? | No. Poiché lo stato di invio era bloccato, il modulo valuta ogni ordine come se non fossero stati inviati messaggi. La prima esecuzione del cron live invia il messaggio corretto in base all'età dell'ordine e alla tua pianificazione. |
Domande Frequenti
L'attivazione della modalità test influisce sugli ordini che hanno già ricevuto promemoria prima che la attivavi?
No. La modalità test cambia solo ciò che accade durante un'esecuzione del cron — le email vengono reindirizzate e gli aggiornamenti di stato vengono soppressi. Qualsiasi record scritto prima di aver attivato la modalità test rimane invariato.
Posso impostare un indirizzo email di test diverso per ogni negozio in una configurazione multi-negozio?
No. L'indirizzo email di test e il toggle della modalità test sono impostazioni globali che si applicano a tutti i negozi. Non è disponibile alcuna sovrascrittura per singolo negozio.
Perché l'email digest dell'amministratore arriva sempre al destinatario reale anche in modalità test?
Il digest è un report rivolto all'amministratore, non una comunicazione al cliente. È escluso intenzionalmente dal reindirizzamento della modalità test in modo che tu possa verificarne il corretto funzionamento durante la configurazione.
Cosa succede alle regole di annullamento automatico quando la modalità test è attiva?
Gli ordini che hanno superato la scadenza di annullamento non vengono annullati. In modalità output Schermo, il cron stampa una riga "Direct Cancel Order" per ogni ordine che avrebbe annullato, così puoi verificare che la logica sia corretta senza modificare alcun ordine.
L'output "Schermo" non mostra nulla — è normale?
Se nel tuo negozio non esistono ordini non pagati per i moduli di pagamento configurati, il cron restituisce un breve messaggio e si interrompe. È necessario almeno un ordine nello stato in attesa di pagamento affinché il modulo elabori qualcosa.
Ho disattivato la modalità test ma il banner blu è ancora visibile.
Il banner legge il valore di configurazione salvato. Assicurati di aver cliccato Salva dopo aver cambiato il toggle. Aggiorna la pagina dopo il salvataggio e il banner dovrebbe scomparire.
Il pulsante "Invia Email di Test" nel Passaggio 4 usa l'indirizzo email di test che ho configurato?
No. Il pulsante Invia Email di Test consegna all'indirizzo che digiti direttamente nel campo di input del Passaggio 4. È indipendente dall'impostazione dell'indirizzo email della modalità test e dal toggle della modalità test.
Se ho lasciato la modalità test attiva per errore e il cron è stato eseguito durante la notte, cosa devo fare?
Semplicemente disattiva la modalità test e salva. Poiché lo stato di invio non è mai stato aggiornato durante le esecuzioni di test, il modulo valuterà ogni ordine da zero alla prossima esecuzione del cron live e invierà il promemoria corretto in base all'età attuale e alla pianificazione di ciascun ordine.