Variabili del Modello Email
I segnaposto ti permettono di personalizzare ogni promemoria automaticamente — il modulo sostituisce ogni {variabile} con i dati reali dell'ordine, del cliente o del negozio prima dell'invio.
Disponibile dalla v1.0.0
Panoramica
Quando scrivi un messaggio di promemoria, puoi inserire variabili in qualsiasi punto della riga oggetto o del corpo del messaggio racchiudendo il nome della variabile tra parentesi graffe: {reference}, {name}, {totalamount}, e così via.
Al momento dell'invio, il modulo recupera ogni valore dall'ordine corrente e lo sostituisce. Non è necessaria alcuna configurazione — la sostituzione avviene automaticamente, purché il segnaposto sia scritto correttamente, incluse le parentesi graffe e le maiuscole/minuscole esatte indicate in questa guida.
Un riferimento variabile comprimibile è integrato nell'editor messaggi del Back Office, così non è necessario memorizzare i nomi. Fai clic su Available Variables sopra il campo oggetto o messaggio per espandere l'elenco, quindi fai clic su un nome di variabile per copiarlo negli appunti.
Le variabili che restituiscono HTML — in particolare {shop_logo}, {order_products} e {urgency_banner} — devono essere inserite solo nel corpo del messaggio, non nella riga oggetto. L'oggetto non può renderizzare HTML, quindi queste tre variabili sono intenzionalmente nascoste dal selettore variabili dell'oggetto.
Configurazione
Non c'è nulla da abilitare — le variabili sono sempre disponibili in ogni messaggio di promemoria. Per inserirne una:
- Vai su Modules > Module Manager > Order Payment Reminders Pro > Configure.
- Fai clic su Edit su qualsiasi messaggio nell'elenco.
- Posiziona il cursore nel campo Subject o Message nel punto in cui vuoi che appaia il valore.
- Fai clic su Available Variables sopra il campo per espandere il pannello di riferimento.
- Fai clic sul nome della variabile — viene copiato negli appunti.
- Incollalo nella posizione del cursore, quindi fai clic su Save.
Puoi anche digitare una variabile direttamente. Assicurati di includere entrambe le parentesi graffe e di corrispondere al nome esatto — {reference} funziona; { reference } o {Reference} no.
Le variabili personalizzate (dati bancari, telefono di supporto, ecc.) devono essere prima definite nella scheda Custom Variables prima di diventare disponibili come segnaposto. Vedi Variabili Personalizzate.
Come Funziona
Quando il modulo invia un'email di promemoria, costruisce una mappa dati dall'ordine corrente: il nome del cliente, il riferimento dell'ordine, il totale, la data di inserimento e così via. Ogni segnaposto nell'oggetto e nel corpo viene quindi sostituito con il valore corrispondente da quella mappa.
Le variabili personalizzate che definisci nella scheda Custom Variables vengono unite a questa mappa con il nome che hai assegnato loro. Se il nome di una variabile personalizzata corrisponde a un segnaposto nel messaggio, il suo valore lo sostituisce. Se non viene trovata corrispondenza, il segnaposto rimane invariato — il tuo cliente vedrà il testo letterale {nome_variabile}.
Informazioni sul negozio
Queste variabili restituiscono informazioni sul tuo negozio e sono disponibili sia nell'oggetto che nel corpo del messaggio.
| Variabile | Output | Esempio | Oggetto? |
|---|---|---|---|
{shop_name} | Il nome del tuo negozio come impostato in Shop Parameters > Contact | My Online Shop | Sì |
{shop_url} | L'URL completo del tuo negozio inclusa la barra finale | https://myshop.com/ | Sì |
{shop_logo} | Un tag <img> che punta al logo del tuo negozio | (tag HTML immagine) | No |
Non inserire
{shop_logo}in una riga oggetto — apparirà come tag HTML grezzo. Usalo solo nel corpo del messaggio.
Informazioni sul cliente
Queste variabili utilizzano il nome e i dati del cliente che ha effettuato l'ordine.
| Variabile | Output | Esempio | Oggetto? |
|---|---|---|---|
{name} | Nome del cliente | Mario | Sì |
{surname} | Cognome del cliente | Rossi | Sì |
{completename} | Nome completo del cliente (nome + cognome) | Mario Rossi | Sì |
Usa {name} per un tono informale ("Ciao {name},") e {completename} per comunicazioni formali ("Gentile {completename},").
Informazioni sull'ordine
Queste variabili riflettono l'ordine specifico per cui viene inviato il promemoria.
| Variabile | Output | Esempio | Oggetto? |
|---|---|---|---|
{reference} | Il numero di riferimento dell'ordine | GDQFM-LMQDB | Sì |
{totalamount} | Importo totale dell'ordine incluse le tasse, formattato nella valuta dell'ordine | € 129,90 | Sì |
{order_products} | Una tabella HTML con stile che elenca ogni prodotto con immagine, quantità e prezzo | (tabella HTML) | No |
{order_products_text} | Un elenco di prodotti in testo normale, uno per riga | - Maglietta Blu x2 — €29,00 | No |
{order_products} renderizza una tabella prodotti completa con immagini in miniatura, progettata per l'uso nel corpo di un'email HTML. Se l'ordine non ha prodotti, restituisce una stringa vuota invece di una tabella danneggiata.
{order_products_text} restituisce un prodotto per riga nel formato - Nome prodotto xQtà — Prezzo, seguito da una riga con il totale. Usalo nelle sezioni in testo normale della tua email invece del corpo HTML.
Tempo e annullamento
Queste variabili riflettono l'età dell'ordine e la finestra di annullamento automatico configurata. Se non è impostata alcuna scadenza di annullamento nella Configurazione Globale, {daysleft} e {hoursleft} restituiscono 0.
| Variabile | Output | Esempio | Oggetto? |
|---|---|---|---|
{cancel_days} | Numero totale di giorni configurati per l'annullamento automatico | 7 | Sì |
{daysleft} | Giorni interi rimanenti fino alla scadenza dell'annullamento automatico | 3 | Sì |
{hoursleft} | Ore rimanenti fino alla scadenza dell'annullamento automatico | 68 | Sì |
{hoursleft} è il valore grezzo in ore — ad esempio, 3 giorni rimanenti potrebbero essere 68 ore. Usa {hoursleft} nei messaggi di avviso finale dove le ore creano più urgenza dei giorni.
Formati data
Tutte le variabili data restituiscono la data in cui è stato effettuato l'ordine, non la data odierna.
| Variabile | Formato | Esempio | Oggetto? |
|---|---|---|---|
{date} | d-m-Y | 09-05-2026 | Sì |
{date_us} | Y-m-d | 2026-05-09 | Sì |
{date_english} | Ordinale inglese | 9th, May 2026 | Sì |
{date_short} | Localizzato breve (senza anno) | Sat, 9 May | Sì |
{date_full} | Localizzato completo (senza anno) | Saturday, 9 May | Sì |
{date_short_year} | Localizzato breve con anno | Sat, 9 May 2026 | Sì |
{date_full_year} | Localizzato completo con anno | Saturday, 9 May 2026 | Sì |
{date_short} e {date_full} (e le loro varianti _year) utilizzano il locale del tuo negozio per i nomi dei mesi e dei giorni. La lingua dell'output corrisponde alla lingua scelta dal cliente al momento dell'ordine, non alla lingua del Back Office. Un negozio in francese mostrerà "samedi, 9 mai" mentre uno in italiano mostrerà "sabato, 9 maggio".
{date_short_year} e {date_full_year} funzionano in modo identico a {date_short} e {date_full} ma includono l'anno. Queste quattro variabili non sono mostrate nel selettore variabili in-app ma funzionano correttamente in qualsiasi messaggio.
Banner di urgenza
| Variabile | Output | Oggetto? |
|---|---|---|
{urgency_banner} | Un blocco HTML banner con codice colore che riassume i giorni rimanenti all'annullamento | No |
Il banner di urgenza è un blocco HTML autonomo con stili inline — compatibile con tutti i principali client email. Il suo colore cambia automaticamente in base a {daysleft}:
- Verde (più di 5 giorni): "Il tuo ordine sarà mantenuto per altri N giorni."
- Arancione (2–5 giorni): "Il tuo ordine sarà mantenuto per altri N giorni."
- Rosso (meno di 2 giorni): "Il tuo ordine sta per essere annullato."
Il banner viene renderizzato solo quando è configurato l'annullamento automatico (Annulla Ordine dopo N giorni > 0). Se non è impostata alcuna scadenza di annullamento, {urgency_banner} restituisce una stringa vuota e non lascia spazi vuoti visibili nella tua email.
Posiziona {urgency_banner} nella parte superiore del corpo del messaggio per la massima visibilità, specialmente nei messaggi di avviso finale.
Variabili personalizzate
Ogni voce che definisci nella scheda Custom Variables diventa disponibile come segnaposto usando il nome che le hai assegnato. Tre nomi convenzionali utilizzati nei messaggi modello precaricati sono:
| Variabile | Output | Esempio |
|---|---|---|
{account_info} | Nome del titolare del conto bancario | Smart Modules SL |
{account_number} | Numero di conto bancario o IBAN | ES91 2100 0418 4502 0005 1332 |
{bank_address} | Indirizzo della banca o dettagli della filiale | CaixaBank, Barcelona |
Questi segnaposto funzionano solo quando hai creato voci corrispondenti nella scheda Custom Variables con quei nomi esatti. Se una variabile personalizzata corrispondente non esiste, il segnaposto viene sostituito con una stringa vuota.
Puoi definire qualsiasi nome di variabile personalizzata — ad esempio, una variabile denominata support_phone diventa {support_phone} nei tuoi messaggi. Vedi Variabili Personalizzate per istruzioni dettagliate.
Variabili interne del modello
Le seguenti variabili sono utilizzate dal modello HTML wrapper dell'email (mails/template/template.html), non nell'editor messaggi. Sono documentate qui come riferimento quando si modifica il design del modello email.
| Variabile | Dove viene usata |
|---|---|
{wr_title} | Sostituita con l'oggetto del messaggio nell'intestazione del modello HTML |
{wr_message} | Sostituita con il corpo completo del messaggio nel modello HTML |
{wr_subject} | Identica a {wr_title} — disponibile anche nel modello HTML |
{wr_cancel_order} | Flag interno — restituisce 1 o 0; non usare nel testo del messaggio |
Non usare {wr_cancel_order} in un oggetto o corpo — è un valore interno che verrà mostrato come 0 o 1 ai tuoi clienti.
Esempi d'Uso
Esempio: Primo promemoria informale con dati bancari
Oggetto: Promemoria pagamento per il tuo ordine {reference}
Corpo:
Ciao {name},
Solo un breve promemoria — il tuo ordine {reference} effettuato il {date} è ancora in attesa di pagamento.
Importo dovuto: {totalamount}
Effettua il bonifico a:
Intestatario: {account_info}
IBAN: {account_number}
Grazie,
{shop_name}
Esempio: Follow-up formale con elenco prodotti
Oggetto: Ordine {reference} — pagamento in sospeso
Corpo:
Gentile {completename},
La contatttiamo riguardo al suo ordine {reference}.
Ecco un promemoria di ciò che ha ordinato:
{order_products}
Totale dovuto: {totalamount}
La preghiamo di completare il pagamento al più presto possibile.
Cordiali saluti,
{shop_name}
Esempio: Avviso finale con banner di urgenza e conto alla rovescia in ore
Oggetto: ULTIMO AVVISO: L'ordine {reference} verrà annullato tra {daysleft} giorni
Corpo:
Gentile {name},
{urgency_banner}
Il tuo ordine {reference} verrà annullato automaticamente tra {daysleft} giorni ({hoursleft} ore) se non riceviamo il pagamento.
Importo dovuto: {totalamount}
{shop_name}
Note Importanti
- Tutte le variabili sono sensibili alle maiuscole/minuscole.
{Name}e{NAME}non verranno sostituite — usa i nomi esatti in minuscolo indicati in questa guida. - Le variabili che restituiscono HTML (
{shop_logo},{order_products},{urgency_banner}) devono essere usate solo nel corpo del messaggio, mai nella riga oggetto. {daysleft}e{hoursleft}restituiscono0quando non è configurata alcuna scadenza di annullamento automatico. Evita di usarle in messaggi in cui l'annullamento non è rilevante — mostrerebbero "0 giorni rimanenti", il che potrebbe confondere i clienti.{order_products}può restituire una stringa vuota se i dati dei prodotti dell'ordine non sono disponibili a causa di un errore nel contesto cron. Questo viene gestito senza problemi — non viene lasciato alcun HTML danneggiato.- I nomi delle variabili personalizzate vengono risolti solo quando esiste una voce corrispondente nella scheda Custom Variables. Una variabile personalizzata mancante restituisce silenziosamente una stringa vuota.
- Multi-shop: le variabili vengono risolte nel contesto del negozio a cui appartiene l'ordine. Le variabili personalizzate sono per-negozio, quindi un segnaposto definito nel Negozio A non sarà disponibile nel Negozio B.
{date_short_year}e{date_full_year}non sono mostrate nel selettore variabili in-app ma funzionano correttamente in qualsiasi corpo del messaggio o oggetto.
Risoluzione dei Problemi
| Problema | Soluzione |
|---|---|
Una variabile appare come testo letterale (es. {reference} non viene sostituita) | Verifica l'ortografia e le maiuscole/minuscole — il nome della variabile deve corrispondere esattamente ai nomi in questa guida, incluse entrambe le { e } senza spazi all'interno. |
{daysleft} o {hoursleft} mostra 0 in ogni email | L'annullamento automatico non è configurato. Vai su Global Configuration e imposta un valore per Cancel Order after N days. |
{order_products} non mostra nulla | Può accadere quando l'ordine non ha prodotti, o quando si verifica un errore di formattazione del prezzo nel contesto cron. Controlla Advanced Parameters > Logs per le voci di WireTransferReminder. |
{account_info} o {account_number} non mostra nulla | Queste sono variabili personalizzate. Vai alla scheda Custom Variables e crea voci con esattamente quei nomi. Vedi Variabili Personalizzate. |
{urgency_banner} non mostra nulla | Il banner viene renderizzato solo quando è impostata una scadenza di annullamento. Abilita Cancel Order after N days nella Configurazione Globale. |
{shop_logo} appare come HTML grezzo in un'email | Il tag <img> del logo viene renderizzato solo nel corpo delle email HTML. Non inserirlo nella riga oggetto. Alcuni client email bloccano anche le immagini remote per impostazione predefinita — i clienti potrebbero dover fare clic su "visualizza immagini". |
| Una variabile personalizzata che ho definito non viene sostituita | Verifica che il nome della variabile nella scheda Custom Variables corrisponda esattamente al segnaposto, incluse le maiuscole/minuscole. Conferma inoltre che sia salvata nel negozio corretto se utilizzi un'installazione multi-shop. |
Domande Frequenti
Posso usare le variabili nella riga oggetto dell'email?
La maggior parte delle variabili funziona nell'oggetto, incluse {reference}, {name}, {completename}, {totalamount}, {daysleft}, {hoursleft} e tutti i formati data. Le eccezioni sono le variabili che restituiscono HTML — {shop_logo}, {order_products} e {urgency_banner} — che possono essere usate solo nel corpo. Il selettore variabili in-app mostra solo le variabili compatibili con l'oggetto quando lo espandi sopra il campo oggetto.
Cosa succede se uso un nome di variabile sconosciuto come {miocampo}?
Se miocampo non corrisponde ad alcuna variabile integrata e non è definita come Variabile Personalizzata, il segnaposto rimane invariato — i tuoi clienti vedranno il testo letterale {miocampo}. Testa sempre con un'email di test prima di attivare un messaggio.
Come aggiungo il mio IBAN e il nome del titolare del conto alle email?
Crea due Variabili Personalizzate nella scheda Custom Variables — una denominata account_info con il nome del titolare del conto, e una denominata account_number con il tuo IBAN. Poi usa {account_info} e {account_number} nel corpo del messaggio. Vedi Variabili Personalizzate per istruzioni dettagliate.
{totalamount} include le tasse?
Sì. {totalamount} restituisce il totale comprensivo di tasse dall'ordine, formattato nella valuta dell'ordine.
Posso mostrare sia i giorni che le ore rimanenti nello stesso messaggio?
Sì. Usa {daysleft} e {hoursleft} insieme — ad esempio: "Il tuo ordine verrà annullato tra {daysleft} giorni ({hoursleft} ore)." Entrambi i valori provengono dallo stesso calcolo e sono sempre coerenti tra loro.
Le variabili data mostrano la data dell'ordine, non quella odierna — c'è un modo per mostrare la data di oggi?
Tutte le variabili data ({date}, {date_us}, ecc.) riflettono la data in cui è stato effettuato l'ordine, non la data corrente. Non esiste una variabile {oggi} integrata. Se hai bisogno di comunicare urgenza, usa {daysleft} e {hoursleft}.
I formati data localizzati ({date_short}, {date_full}) vengono tradotti automaticamente?
Sì. Queste variabili usano la lingua scelta dal cliente al momento dell'ordine per formattare i nomi dei mesi e dei giorni. Un ordine in lingua francese mostrerà "samedi, 9 mai" mentre uno in lingua italiana mostrerà "sabato, 9 maggio" — indipendentemente dalla lingua del Back Office.
Posso creare variabili personalizzate per cose come un numero di telefono di supporto o un link di pagamento?
Sì. Ogni voce che aggiungi nella scheda Custom Variables diventa disponibile come segnaposto usando il nome della variabile che hai scelto. Ad esempio, una variabile personalizzata denominata support_phone diventa {support_phone} nel corpo del messaggio. Vedi Variabili Personalizzate.
Qual è la differenza tra {wr_title} e {wr_subject}?
Restituiscono lo stesso valore — la riga oggetto del messaggio di promemoria corrente. Entrambe vengono usate nel modello HTML wrapper dell'email, non nell'editor messaggi. Non è necessario usare nessuna delle due nei campi oggetto o corpo del tuo messaggio.