Procedura Guidata di Configurazione e Pannello di Controllo
Quando installi Order Payment Reminders Pro per la prima volta, una checklist in quattro passaggi ti guida attraverso tutto ciò che il modulo richiede prima di poter iniziare a inviare email.
Disponibile dalla v1.2.0
Panoramica
Il pannello Configurazione Modulo è la prima schermata che vedi quando apri la configurazione del modulo. Mostra una barra di avanzamento e un indicatore che conta quanti dei quattro passaggi obbligatori hai completato — ad esempio, "2/4 Passaggi Completati". Finché tutti e quattro i passaggi non sono terminati, il modulo è inattivo e non invia promemoria ai tuoi clienti.
Una volta completati tutti i passaggi, l'indicatore diventa verde e un banner di stato conferma "Il modulo è attivo e pronto per inviare i promemoria di pagamento!" Da quel momento in poi, il pannello rimane accessibile come riferimento rapido. Puoi riaprire qualsiasi passaggio in qualsiasi momento per modificare le impostazioni.
La procedura guidata originale (v1.1.0) è stata sostituita da questo pannello checklist nella v1.2.0. Se stai aggiornando da una versione precedente alla 1.2.0, il pannello appare automaticamente la prossima volta che apri la configurazione del modulo.
Quando Utilizzare Questa Schermata
- Prima installazione: Completa tutti e quattro i passaggi prima di pianificare il cron job. Il modulo non invierà email finché il Passaggio 4 (Test e Verifica) non è stato completato.
- Dopo aver modificato l'host email o le impostazioni SMTP: Ripeti il Passaggio 4 per confermare che le email arrivino ancora nella tua casella di posta.
- Dopo aver aggiunto un nuovo metodo di pagamento al negozio: Riapri il Passaggio 2, spunta il nuovo modulo di pagamento e salva.
- Dopo aver cambiato lo stile del template email: Riapri il Passaggio 1, seleziona un preset diverso e salva.
Configurazione
La checklist di configurazione non ha un'opzione di attivazione globale — è essa stessa la configurazione. Completa ciascun passaggio indicato di seguito.
Passaggio 1 — Template Email
Questo passaggio definisce il contenitore HTML che circonda ogni email di promemoria pagamento. Consideralo come il design della busta — l'oggetto e il corpo specifici di ogni messaggio vengono inseriti al suo interno.
Indicatore di stato: "Obbligatorio" (arancione) fino al salvataggio di un file template valido; "Configurato" (verde) dopo il salvataggio.
- Fai clic sull'intestazione Passaggio 1: Template Email per espanderlo.
- Scegli una delle quattro opzioni dal menu a tendina Seleziona un template preimpostato o personalizza il tuo:
| Opzione | Descrizione |
|---|---|
| Minimal — Pulito e semplice | Layout a tabella senza decorazioni. Compatibile con tutti i client email. |
| Professionale — Stile aziendale | Layout con bordi, barra di intestazione grigia e piè di pagina. Adatto a negozi formali. |
| Friendly — Caldo e personale | Sfondo crema, font serif, piè di pagina accogliente. |
| Custom — Inizia da zero | Apre un editor vuoto per scrivere il proprio HTML. |
- Dopo aver selezionato un preset, l'editor carica il codice HTML per quello stile. Rivedi e modifica colori, font o layout come preferisci.
- Il template deve contenere
{wr_title}e{wr_message}esattamente come scritti. Il salvataggio fallisce con un avviso se uno dei due segnaposto è assente. - Fai clic su Salva Template. La pagina si ricarica e il Passaggio 1 mostra l'indicatore verde "Configurato".
{wr_title}viene sostituito al momento dell'invio con l'oggetto di quel specifico promemoria.{wr_message}viene sostituito con il corpo che scrivi quando crei un messaggio nel Passaggio 3.
Se scegli Custom, l'editor si apre vuoto. Incolla il tuo HTML e includi entrambi i segnaposto obbligatori prima di salvare.
Passaggio 2 — Moduli di Pagamento
Questo passaggio indica al modulo quali metodi di pagamento devono attivare i promemoria. Solo gli ordini effettuati tramite uno dei moduli di pagamento selezionati riceveranno email.
Indicatore di stato: "Obbligatorio" (arancione) finché almeno un modulo non viene salvato; "Configurato" (verde) dopo il salvataggio.
- Fai clic sull'intestazione Passaggio 2: Moduli di Pagamento per espanderlo.
- Vedrai una casella di spunta per ogni modulo di pagamento attualmente installato nel tuo negozio.
- Spunta ogni metodo di pagamento i cui ordini non pagati devono ricevere promemoria. Per la maggior parte dei negozi si tratta del modulo Bonifico Bancario. Se utilizzi anche un modulo di pagamento tramite fattura personalizzato, spunta anche quello.
- Fai clic su Salva Moduli di Pagamento. La pagina si ricarica e il Passaggio 2 mostra l'indicatore verde "Configurato".
Puoi selezionare più di un modulo di pagamento. Ogni singolo messaggio di promemoria che crei in seguito può essere ulteriormente filtrato per applicarsi a un modulo di pagamento specifico o a tutti quelli selezionati.
Se un modulo di pagamento è installato ma non spuntato qui, gli ordini provenienti da quel modulo vengono completamente ignorati — nessun promemoria, nessuna cancellazione automatica.
Passaggio 3 — Crea Messaggi
Questo passaggio crea almeno un messaggio di promemoria. Un messaggio definisce la tempistica (quanti giorni o ore dopo l'ordine), l'oggetto, il corpo e se l'ordine debba essere cancellato dopo l'invio del messaggio.
Indicatore di stato: "Obbligatorio" (arancione) finché non esiste almeno un messaggio; mostra il conteggio dei messaggi in verde non appena almeno uno è stato salvato.
Hai due possibilità:
Opzione A — Usa un template preimpostato
Il passaggio mostra tre categorie di template di messaggi già pronti:
| Categoria | Scopo |
|---|---|
| Gentle Nudge | Primi promemoria cordiali, senza pressione. |
| Persistent Follow-up | Secondo o terzo promemoria per ordini senza risposta. |
| Urgent / Final | Messaggi dell'ultimo momento inviati poco prima della cancellazione automatica. |
Seleziona un template dal menu a tendina in qualsiasi categoria per caricarlo automaticamente nel modulo di creazione del messaggio.
Opzione B — Crea da zero
Fai clic su Crea Nuovo Messaggio. Questo ti porta al modulo del messaggio dove imposti la tempistica, l'oggetto, il corpo e il flag di cancellazione per quel specifico promemoria.
Una volta che esiste almeno un messaggio, la pagina si ricarica e il Passaggio 3 mostra l'indicatore con il conteggio dei messaggi (ad esempio, "3 messaggi").
Puoi aggiungere altri messaggi in qualsiasi momento dopo la configurazione. Una sequenza tipica prevede tre messaggi: uno a 2 giorni, uno a 5 giorni e un avviso finale a 8 giorni con la cancellazione automatica attivata.
Passaggio 4 — Test e Verifica
Questo passaggio invia una vera email attraverso il sistema di posta del tuo negozio per confermare che la consegna funzioni. Fai clic su un link di verifica contenuto in quell'email e il modulo si contrassegna come verificato e attivo.
Indicatore di stato: "Bloccato" (grigio) mentre i Passaggi 1–3 sono incompleti; "Obbligatorio" (arancione) una volta che i Passaggi 1–3 sono completati; "Verificato" (verde) dopo aver fatto clic sul link nell'email di test.
- Completa prima i Passaggi 1, 2 e 3 — il Passaggio 4 è bloccato finché tutti e tre non sono terminati.
- Fai clic sull'intestazione Passaggio 4: Test e Verifica per espanderlo.
- Nel campo Indirizzo email, inserisci un indirizzo email che puoi controllare immediatamente. L'email di amministrazione del negozio è precompilata.
- Fai clic su Invia Email di Test. Il pulsante si disabilita durante l'invio.
- Controlla la tua casella di posta per l'oggetto "Test Email - Order Payment Reminders". Apri l'email.
- Fai clic sul pulsante Verifica Consegna Email all'interno dell'email. Questo ti porta a una pagina di conferma sul front-end del tuo negozio.
- Torna al Back Office e aggiorna la pagina di configurazione del modulo. Il Passaggio 4 mostra ora l'indicatore verde "Verificato" e l'avviso di stato generale riporta "Il modulo è attivo e pronto per inviare i promemoria di pagamento!"
Il link di verifica scade dopo 24 ore. Se non fai clic in tempo, torna al Passaggio 4 e invia una nuova email di test per generare un link aggiornato.
Se l'email di test non arriva mai, controlla le impostazioni di posta del tuo negozio in Parametri Avanzati > Email. Il modulo utilizza la stessa configurazione di posta di tutte le altre email transazionali di PrestaShop.
Come Funziona
Logica di Completamento della Configurazione
Il modulo verifica tutte e quattro le condizioni in tempo reale. Ogni volta che apri la pagina di configurazione, controlla se il file template esiste e contiene entrambi i segnaposto obbligatori, se almeno un modulo di pagamento è salvato, se esiste almeno un messaggio di promemoria nel database e se il flag di verifica è impostato. Tutte e quattro devono essere soddisfatte prima che il pannello mostri lo stato "Modulo attivo".
Il pannello appare automaticamente ogni volta che una di queste condizioni non è soddisfatta — indipendentemente dal fatto che tu abbia visitato la configurazione in precedenza. Se elimini tutti i messaggi di promemoria, ad esempio, il pannello riapparirà la prossima volta che apri il modulo.
Dopo il Completamento della Configurazione
Una volta verificati tutti e quattro i passaggi, due cose cambiano:
- L'indicatore di avanzamento in alto riporta "4/4 Passaggi Completati" con sfondo verde.
- L'avviso di stato cambia in "Il modulo è attivo e pronto per inviare i promemoria di pagamento!"
Il pannello Statistiche di Recupero appare sotto la checklist di configurazione una volta che il modulo ha elaborato degli ordini. Prima che siano disponibili dati, il pannello mostra un messaggio segnaposto. Quando le statistiche sono disponibili, vedrai:
| Statistica | Descrizione |
|---|---|
| Ordini con Promemoria | Ordini unici che hanno ricevuto almeno un promemoria negli ultimi 6 mesi. |
| Ordini Recuperati | Ordini che sono stati successivamente pagati dopo aver ricevuto un promemoria. |
| Entrate Recuperate | Valore totale di quegli ordini recuperati, nella valuta del tuo negozio. |
| Tasso di Recupero | Ordini Recuperati ÷ Ordini con Promemoria × 100. Mostrato in verde sopra il 20%, arancione sotto. |
Una tabella di riepilogo mensile mostra le stesse cifre per ogni mese del calendario.
Compatibilità con la Procedura Guidata Legacy
Se il flag wr_first è ancora impostato su 1 (negozi configurati prima della v1.2.0 che non hanno mai completato la vecchia procedura guidata), il modulo continua a mostrare la procedura guidata legacy per compatibilità con le versioni precedenti. Facendo clic su Salta Procedura Guidata si imposta wr_first su 0 e la pagina si ricarica, mostrando il pannello moderno.
Esempi di Utilizzo
Esempio: Nuovo negozio con pagamenti tramite bonifico bancario
Installa il modulo e apri la sua configurazione. Il pannello mostra 0/4 Passaggi Completati. Seleziona il template "Professionale" nel Passaggio 1 e fai clic su Salva Template. Nel Passaggio 2, spunta Bonifico Bancario (ps_wirepayment) e fai clic su Salva Moduli di Pagamento. Nel Passaggio 3, seleziona il template "Gentle Nudge" dal menu a tendina per creare il tuo primo promemoria a 3 giorni. Fai clic su Crea Nuovo Messaggio e salvalo. Nel Passaggio 4, inserisci il tuo indirizzo email e invia l'email di test. Fai clic sul link di verifica. Il pannello mostra 4/4 Passaggi Completati e sei pronto per pianificare il cron job.
Esempio: Aggiunta di un secondo metodo di pagamento in seguito
Dopo aver aggiunto un nuovo plugin di pagamento tramite fattura al tuo negozio, noti che non attiva i promemoria. Torna alla configurazione del modulo — il pannello mostra ancora 4/4 perché il tuo modulo di pagamento esistente è ancora selezionato. Fai clic sull'intestazione del Passaggio 2, spunta il nuovo modulo di pagamento tramite fattura in aggiunta a quelli esistenti e fai clic su Salva Moduli di Pagamento. Non è necessario modificare altri passaggi.
Esempio: Ripristino dopo una migrazione del server email
Dopo la migrazione a un nuovo server di posta, vuoi confermare che i promemoria vengano ancora recapitati. Apri la configurazione del modulo. Anche se il pannello mostra 4/4, fai clic sull'intestazione del Passaggio 4, inserisci la tua email e fai clic su Invia Email di Test. Fai clic sul nuovo link di verifica. Lo stato verificato viene aggiornato e puoi avere la certezza che le email raggiungano i clienti.
Note Importanti
- I passaggi devono essere completati approssimativamente in ordine — il Passaggio 4 è bloccato e non può essere aperto finché i Passaggi 1–3 non mostrano tutti il verde.
- Il pannello è per singolo negozio in una configurazione multi-shop. La configurazione di ogni negozio deve essere completata in modo indipendente quando si utilizza la modalità multi-shop.
- L'eliminazione di tutti i messaggi di promemoria fa riapparire il pannello al successivo caricamento della pagina, poiché il Passaggio 3 non è più soddisfatto.
- Il flag
wr_first(il vecchio flag della procedura guidata) e la chiavewr_setup_completecoesistono. Nelle nuove installazioni dopo la v1.2.0, il pannello è l'unico flusso che vedrai. Negli aggiornamenti, entrambi i flag possono essere presenti, ma la logica del pannello ha la precedenza.
Risoluzione dei Problemi
| Problema | Soluzione |
|---|---|
| Il Passaggio 4 mostra "Bloccato" anche se ho completato i Passaggi 1–3 | Ricarica la pagina. Tutti e tre i passaggi precedenti devono mostrare l'indicatore verde. Se il Passaggio 2 mostra ancora "Obbligatorio", fai clic su Salva Moduli di Pagamento di nuovo con almeno un modulo spuntato. |
| L'email di test non arriva mai | Vai a Parametri Avanzati > Email nel tuo Back Office e invia un test da lì. Se fallisce anche quello, la configurazione SMTP o dell'hosting blocca la posta in uscita. Correggi le impostazioni di posta prima di tornare al Passaggio 4. |
| Ho fatto clic sul link di verifica ma il Passaggio 4 mostra ancora "Obbligatorio" | Il link potrebbe essere scaduto (valido per 24 ore). Torna al Passaggio 4, invia una nuova email di test e fai clic sul nuovo link. |
Avviso "Il template deve contenere i segnaposto {wr_title} e {wr_message}" durante il salvataggio | Nell'area di testo del template manca uno o entrambi i segnaposto obbligatori. Cerca {wr_title} e {wr_message} nell'editor e aggiungili se assenti. |
| Ho salvato il template ma l'indicatore mostra ancora "Obbligatorio" dopo il ricaricamento | Il file template non è stato scritto sul disco. Verifica che modules/wiretransferreminder/mails/template/ sia scrivibile dall'utente del server web. |
| Il link di verifica restituisce un errore "pagina non trovata" | Il link utilizza il sistema di URL amichevoli del tuo negozio. Assicurati che .htaccess sia presente e che gli URL amichevoli del front-office siano abilitati in Preferenze > SEO e URL. Se il tuo negozio è in modalità manutenzione, disabilitala temporaneamente prima di fare clic sul link. |
| Le statistiche di recupero mostrano zero anche se i promemoria sono stati inviati | Le statistiche contano solo gli ordini in cui lo stato di pagamento è cambiato in pagato dopo l'invio di un promemoria. Gli ordini pagati prima della consegna del promemoria non vengono contati come recuperi. |
Domande Frequenti
Posso modificare il template email dopo aver completato la configurazione?
Sì. Apri la configurazione del modulo, fai clic sull'intestazione Passaggio 1: Template Email, seleziona un nuovo preset o modifica il codice HTML esistente, poi fai clic su Salva Template. La modifica si applica immediatamente a tutte le future email di promemoria e non influisce sui messaggi già creati.
Cosa succede se salto il Passaggio 4 e attivo il cron job comunque?
L'endpoint del cron non è bloccato dal flag di verifica — tenterà di inviare promemoria indipendentemente. Se non esistono ancora messaggi, non viene inviato nulla. Completa tutti e quattro i passaggi prima di pianificare il cron per evitare l'invio di email configurate in modo errato.
La modifica del template email influisce sui messaggi già creati?
No. Il template è solo il contenitore visivo esterno. I messaggi esistenti mantengono il proprio oggetto e corpo. Cambia solo il contenitore di design che li circonda.
Posso usare un design HTML completamente personalizzato per il template?
Sì. Scegli Custom — Inizia da zero dal menu a tendina dei template, incolla il tuo HTML nell'editor e salva. L'unico requisito è che il tuo HTML includa {wr_title} e {wr_message} da qualche parte nel corpo.
Ho selezionato il template Professionale ma voglio cambiare il colore dell'intestazione. È possibile?
Sì. Dopo aver selezionato Professionale dal menu a tendina, il codice HTML si carica nell'editor. Trova il colore di sfondo negli attributi di stile e sostituiscilo con qualsiasi valore CSS valido. Salva normalmente.
Come posso reimpostare lo stato di verifica se qualcosa è andato storto durante la prima configurazione?
Apri la configurazione del modulo e ripeti il Passaggio 4 — fai clic sull'intestazione del Passaggio 4, invia una nuova email di test e fai clic sul nuovo link di verifica. Ogni salvataggio in qualsiasi passaggio sovrascrive il valore precedente, quindi non è necessario disinstallare e reinstallare il modulo.
Il pannello continua a riapparire anche se avevo completato tutti e quattro i passaggi.
Il modulo verifica tutte e quattro le condizioni in tempo reale ogni volta che la pagina di configurazione si carica. La causa più comune è che tutti i messaggi di promemoria sono stati eliminati (il Passaggio 3 non è soddisfatto) o che il file template è stato rimosso o danneggiato (il Passaggio 1 non è soddisfatto). Controlla l'indicatore di ogni passaggio per trovare quale condizione non è più soddisfatta.