Verifica della Consegna Email
Prima che il modulo inizi a inviare promemoria di pagamento ai tuoi clienti, questa funzione conferma che il sistema di posta di PrestaShop è in grado di consegnare effettivamente un'email a una casella di posta reale.
Disponibile dalla v1.2.0
Panoramica
La verifica della consegna email è il Passaggio 4 della checklist di configurazione del modulo. Quando clicchi su Send Test Email, il modulo genera un link univoco con scadenza temporale e lo incorpora in un messaggio di prova inviato all'indirizzo che scegli. Cliccando su quel link comunichi al modulo che il tuo sistema di posta funziona — e sblocchi lo stato finale "attivo" nella dashboard di configurazione.
Finché la verifica non è completata, la dashboard Module Setup mantiene il badge di stato ambra e mostra "Module is not active yet." La barra di avanzamento rimane sotto il 100%. Una volta cliccato il link, il badge diventa verde e il banner recita "Module is active and ready to send payment reminders!"
Questo passaggio esiste perché molte installazioni di PrestaShop hanno impostazioni di posta configurate in modo errato — credenziali SMTP errate, porte bloccate o filtri antispam aggressivi. Individuare un problema di consegna durante la configurazione è molto più semplice che diagnosticarlo dopo che i clienti hanno già perso i propri promemoria di pagamento.
Configurazione
La verifica della consegna email non ha un pannello di impostazioni persistente — è un flusso una tantum che si avvia dalla dashboard di configurazione. L'unico dato che devi fornire è l'indirizzo email dove desideri ricevere il messaggio di prova.
| Campo | Note |
|---|---|
| Email address | Pre-compilato con l'email dell'amministratore del negozio. Puoi cambiarlo con qualsiasi casella di posta a cui hai accesso immediato. |
L'indirizzo inserito qui viene utilizzato esclusivamente per l'email di verifica. Non viene salvato in modo permanente e non ha alcun effetto sull'indirizzo a cui vengono inviati i promemoria ai clienti.
Il Passaggio 4 è disponibile solo una volta completati i Passaggi 1–3. Se la scheda mostra un badge Locked, completa prima i seguenti passaggi:
- Passaggio 1 — Configura e salva il tuo modello di email.
- Passaggio 2 — Seleziona almeno un modulo di pagamento da monitorare.
- Passaggio 3 — Crea almeno un messaggio di promemoria.
Una volta completati tutti e tre, il Passaggio 4 si apre automaticamente.
Come Funziona
Invio dell'email di prova
- Vai su Modules > Module Manager, trova Order Payment Reminders Pro e clicca su Configure.
- Si apre la dashboard Module Setup. Espandi la scheda Test & Verify (Passaggio 4).
- Nel campo Email address, conferma o modifica l'indirizzo di destinazione.
- Clicca su Send Test Email.
- Appare un messaggio di conferma: "Test email sent to [indirizzo]. Please check your inbox and click the verification link."
Clic sul link di verifica
- Apri la tua casella di posta e cerca l'email con oggetto "Test Email - Order Payment Reminders".
- Il corpo dell'email contiene un pulsante verde Verify Email Delivery. Cliccaci sopra.
- Il browser apre una pagina nel tuo negozio. Se la consegna è avvenuta con successo, la pagina mostra un segno di spunta verde e il messaggio "Email delivery confirmed! Your module is ready to use."
- Clicca su Return to Module Configuration per tornare al Back Office.
Meccanismo del token
Il link di verifica contiene un token univoco generato nel momento in cui clicchi su Send Test Email. Il token è valido per 24 ore. Una volta cliccato il link con successo, il token viene immediatamente eliminato — cliccando lo stesso link una seconda volta viene mostrato "Invalid verification token," il che è previsto e non causa alcun problema.
Se le 24 ore scadono prima che tu clicchi, la pagina mostra: "Verification link has expired. Please send a new test email from the module configuration." Torna alla dashboard e clicca di nuovo su Send Test Email per ottenere un nuovo link.
Cosa cambia quando la verifica ha successo
Dopo un clic riuscito, il modulo imposta il tuo negozio come verificato. La dashboard di configurazione lo riflette immediatamente:
- Il Passaggio 4 mostra un badge verde Verified.
- La barra di avanzamento raggiunge il 100%.
- Il banner di stato diventa verde: "Module is active and ready to send payment reminders!"
Effetto sul cron job
Il cron job giornaliero che invia le email di promemoria non controlla lo stato di verifica. Se il cron è programmato prima che tu completi questo passaggio, il modulo tenterà comunque di inviare i promemoria. La verifica è una misura di sicurezza in fase di configurazione, non un blocco in fase di esecuzione. Il flusso raccomandato è completare tutti e quattro i passaggi — inclusa la verifica — prima di aggiungere il cron job al tuo server.
Interazione con la Modalità Test
La Modalità Test e la verifica email sono funzioni indipendenti. Se la Modalità Test è attiva quando clicchi su Send Test Email, l'email di prova viene comunque inviata all'indirizzo inserito nel campo di verifica — non all'indirizzo della Modalità Test. La verifica bypassa intenzionalmente il reindirizzamento della Modalità Test.
Esempi d'uso
Esempio: Prima configurazione Hai appena installato il modulo, creato il tuo primo messaggio di promemoria e selezionato il modulo di pagamento Bonifico Bancario nel Passaggio 2. Apri il Passaggio 4, lascia l'indirizzo email dell'amministratore predefinito e clicca su Send Test Email. L'email arriva entro un minuto. Clicchi il pulsante verde, la pagina del negozio conferma la consegna e la dashboard mostra tutti e quattro i passaggi completati. I tuoi primi promemoria verranno ora inviati secondo la pianificazione.
Esempio: Dopo aver modificato le impostazioni SMTP Il tuo provider di hosting ha spostato il sito su un nuovo server con credenziali di posta in uscita diverse. Aggiorni le impostazioni SMTP in Parametri avanzati > E-mail in PrestaShop, poi torni alla dashboard del modulo e clicchi di nuovo su Send Test Email. Se la nuova email arriva e clicchi il link, sai che la nuova configurazione SMTP funziona correttamente.
Esempio: Diagnosticare promemoria mancanti Un cliente ti contatta dicendo di non aver mai ricevuto un promemoria di pagamento. Riesegui il flusso di verifica usando il tuo indirizzo email. Se l'email di prova non arriva, il tuo sistema di posta ha un problema di consegna che riguarda tutta la posta in uscita — non solo i promemoria. Se arriva, il problema è specifico a quell'ordine o cliente.
Note Importanti
- Lo stato di verifica viene memorizzato per negozio. In una configurazione multi-negozio, completa il passaggio di verifica mentre sei connesso al contesto del Back Office di ogni negozio per contrassegnare ciascuno come verificato nella propria dashboard.
- Il link di verifica apre una pagina pubblica nel tuo negozio e non richiede alcun accesso al Back Office. È sicuro cliccarci da qualsiasi dispositivo o client email.
- Se il tuo client email rimuove l'HTML, non ci sarà nessun pulsante — solo un URL lungo. Copia e incolla l'URL dalla versione in testo semplice dell'email nel tuo browser.
- Non modificare manualmente l'URL di verifica. Il parametro
tokendeve essere presente e intatto affinché il link funzioni.
Risoluzione dei Problemi
| Problema | Soluzione |
|---|---|
| L'email di verifica non è mai arrivata | Controlla le impostazioni di posta di PrestaShop in Parametri avanzati > E-mail e invia prima un test da quella pagina. Controlla anche la cartella spam. |
| "Verification link has expired" al momento del clic | La finestra di 24 ore è scaduta. Torna alla dashboard, clicca di nuovo su Send Test Email e clicca prontamente il nuovo link. |
| "Invalid verification token" al momento del clic | Hai già cliccato il link con successo (il token viene consumato al primo utilizzo), oppure un'email di prova più recente ha sostituito questo token. Torna alla dashboard — se il Passaggio 4 mostra Verified, la configurazione è completata. |
| "Invalid verification link" al momento del clic | L'URL è malformato o il parametro token è mancante. Non copiare l'URL manualmente; clicca il pulsante all'interno dell'email. |
| Il Passaggio 4 mostra "Locked" invece del modulo email | I Passaggi 1–3 non sono tutti completati. Controlla ogni passaggio per un badge Required e completa prima quei passaggi. |
| La dashboard mostra ancora il Passaggio 4 come in sospeso dopo aver cliccato il link | Un livello di cache potrebbe aver ritardato l'aggiornamento. Aggiorna forzatamente la pagina di configurazione del modulo (Ctrl + Shift + R / Cmd + Shift + R). |
| Il pulsante Send Test Email non fa nulla | Controlla la console del browser per errori JavaScript. Prova a salvare la configurazione del modulo una volta prima di riprovare per aggiornare il token AJAX. |
Domande Frequenti
Il modulo smette di inviare promemoria se perdo lo stato di verifica?
No. Il cron job giornaliero che invia i promemoria viene eseguito indipendentemente dallo stato di verifica. Il flag di verifica influisce solo sulla visualizzazione della dashboard di configurazione — una volta superata la configurazione iniziale, non blocca la consegna delle email.
Posso ri-verificare dopo aver modificato le impostazioni SMTP?
Sì. Apri il passaggio Test & Verify e clicca di nuovo su Send Test Email. Il modulo genera un nuovo token e invia una nuova email all'indirizzo inserito, sovrascrivendo il token precedente.
La pagina di verifica dice "Email delivery confirmed!" ma il Passaggio 4 mostra ancora in sospeso nella dashboard. Cosa è successo?
Il flag di verifica è stato salvato correttamente, ma il browser stava mostrando una versione in cache della dashboard. Aggiorna forzatamente la pagina di configurazione del modulo (Ctrl + Shift + R o Cmd + Shift + R) e il passaggio verrà mostrato come Verified.
La verifica deve essere ripetuta per ogni negozio in una configurazione multi-negozio?
Sì. Il flag di verifica viene memorizzato per negozio. Completa il passaggio di verifica mentre sei connesso al contesto del Back Office di ogni negozio affinché la dashboard di ciascun negozio mostri lo stato corretto.
L'email di verifica è arrivata ma non c'è nessun pulsante — solo un URL lungo. Cosa devo fare?
Il tuo client email sta rimuovendo l'HTML. Apri l'email in un client diverso, oppure copia l'URL grezzo dalla sezione in testo semplice e incollalo nel browser.
Quale indirizzo email dovrei usare per il test?
Usa qualsiasi casella di posta a cui puoi accedere immediatamente — la tua email personale o l'indirizzo amministratore vanno benissimo. L'indirizzo non viene salvato e viene utilizzato solo per consegnare questo unico messaggio di prova. L'email dell'amministratore del negozio è inserita per impostazione predefinita.
È sicuro cliccare il link di verifica da un dispositivo mobile?
Sì. Il link apre una pagina nel tuo negozio, convalida il token, registra lo stato di verifica e mostra un messaggio di conferma. Non è richiesto alcun accesso al Back Office e non viene eseguita alcuna azione sensibile.