Variabili Personalizzate
Le variabili personalizzate ti permettono di definire segnaposto riutilizzabili — come il numero di conto, l'IBAN o il telefono dell'assistenza — una volta sola, e di inserirli in qualsiasi email di promemoria digitando {nome_variabile}.
Disponibile dalla v1.2.0
Panoramica
Ogni promemoria di pagamento deve indicare ai tuoi clienti dove inviare il pagamento. Digitare i dati bancari a mano in ogni messaggio email è tedioso e soggetto a errori. Se il numero di conto cambia, dovrai aggiornare ogni messaggio singolarmente.
Le variabili personalizzate risolvono questo problema. Definisci un segnaposto con un nome una volta sola — ad esempio numero_conto — e poi scrivi {numero_conto} in qualsiasi punto dell'oggetto o del corpo di un'email. Quando il modulo invia un promemoria, sostituisce automaticamente il segnaposto con il valore reale.
Esistono due tipi di variabile. Valore Statico memorizza un testo fisso che fornisci direttamente. Chiave di Configurazione legge il valore in tempo reale da una chiave di configurazione di PrestaShop, utile quando un valore è già memorizzato in PrestaShop e vuoi che le tue email rimangano sincronizzate automaticamente senza mantenere due copie della stessa informazione.
Le variabili sono limitate al tuo negozio. In una configurazione multi-negozio, ogni negozio gestisce il proprio elenco di variabili, quindi puoi avere conti bancari o dati di contatto diversi per ogni negozio.
Configurazione
Aggiungere una Variabile
- Vai su Moduli > Gestione moduli, trova Order Payment Reminders Pro e clicca su Configura.
- Scorri fino alla sezione Variabili Personalizzate nella pagina principale del pannello (sotto la checklist di configurazione).
- Compila il modulo Aggiungi Nuova Variabile in fondo al pannello:
| Campo | Obbligatorio | Descrizione |
|---|---|---|
| Nome Variabile | Sì | Un identificatore breve che usa solo lettere, numeri e trattini bassi. Deve iniziare con una lettera o un trattino basso. Esempi: numero_conto, indirizzo_banca, telefono_assistenza. Massimo 64 caratteri. |
| Tipo | Sì | Valore Statico — memorizza il testo direttamente. Chiave di Configurazione — legge il valore da una chiave di configurazione di PrestaShop ogni volta che viene inviata un'email. |
| Valore | Sì | Per Valore Statico: il testo da inserire (max 255 caratteri, HTML rimosso). Per Chiave di Configurazione: il nome della chiave di configurazione in maiuscolo, es. PS_SHOP_EMAIL. |
- Clicca su Aggiungi.
La tabella si aggiorna immediatamente e la nuova variabile appare. La colonna Anteprima mostra il valore risolto in modo che tu possa confermare che sia corretto.
I nomi delle variabili sono sensibili alle maiuscole nei template. Una variabile chiamata
numero_contodeve essere scritta come{numero_conto}— non{Numero_Conto}o{NUMERO_CONTO}.
Modificare una Variabile
- Nella tabella Variabili Personalizzate, clicca sull'icona a matita (modifica) sulla riga che vuoi cambiare.
- Aggiorna il nome, il tipo o il valore secondo necessità.
- Clicca su Salva.
Se cambi il nome di una variabile dopo che è stata usata nei messaggi, il vecchio segnaposto non verrà più sostituito. Aggiorna prima i corpi dei messaggi, poi rinomina la variabile.
Eliminare una Variabile
- Nella tabella Variabili Personalizzate, clicca sull'icona del cestino rosso sulla riga che vuoi rimuovere.
- Conferma l'eliminazione.
L'eliminazione è immediata e permanente. I segnaposto {nome_variabile} già scritti nei tuoi template di messaggi rimarranno come testo letterale nelle email. Rimuovili dai tuoi messaggi prima di eliminare una variabile.
Usare una Variabile in un'Email
- Apri il messaggio di promemoria che vuoi modificare (nella sezione Messaggi della configurazione del modulo).
- Nell'Oggetto o nel Corpo del messaggio, digita
{nome_variabile}nel punto esatto in cui vuoi che il valore appaia. - Salva il messaggio.
Quando il cron job viene eseguito, ogni segnaposto {nome_variabile} viene sostituito con il suo valore risolto prima che l'email venga consegnata al cliente. Puoi combinare variabili personalizzate con le variabili predefinite ({totalamount}, {completename}, {daysleft}, ecc.) liberamente sia nell'oggetto che nel corpo.
Come Funziona
Quando il tuo cron job viene eseguito e un promemoria è in scadenza, il modulo recupera tutte le variabili personalizzate definite per quel negozio. Per ogni variabile di tipo Valore Statico, usa il testo che hai salvato. Per ogni variabile di tipo Chiave di Configurazione, legge il valore attuale dalla tabella di configurazione di PrestaShop in quel momento — quindi se l'impostazione sottostante è cambiata dall'ultimo salvataggio della variabile, l'email utilizza automaticamente il valore aggiornato.
Dopo aver raccolto tutti i valori risolti, il modulo esegue un singolo passaggio sia sull'oggetto che sul corpo dell'email, sostituendo ogni pattern {nome_variabile} trovato. I segnaposto che non hanno una variabile corrispondente vengono lasciati così come sono, apparendo come testo letterale nell'email consegnata.
Variabili con Valore Statico
Quando scegli Valore Statico, il testo che inserisci viene memorizzato direttamente e usato verbatim in ogni email. I tag HTML vengono rimossi automaticamente al momento del salvataggio, quindi il valore è sempre testo normale. Questa è la scelta giusta per i dati di pagamento, i numeri IBAN, i codici BIC, i nomi delle banche e qualsiasi altro testo che controlli e aggiorni manualmente.
Variabili con Chiave di Configurazione
Quando scegli Chiave di Configurazione, inserisci il nome di una chiave di configurazione di PrestaShop in maiuscolo (ad esempio PS_SHOP_NAME o PS_SHOP_EMAIL). Quando esci dal campo, il modulo valida immediatamente la chiave e mostra un'anteprima del suo valore attuale. Se la chiave non viene trovata, verrà visualizzato un avviso rosso "Non trovato".
Al momento dell'invio dell'email, il valore viene letto in tempo reale dalla tabella di configurazione, in modo che i tuoi promemoria riflettano automaticamente qualsiasi modifica all'impostazione PrestaShop sottostante. Questa è la scelta giusta per qualsiasi valore già memorizzato e mantenuto altrove nel tuo negozio — il nome del negozio, il numero di telefono, o un valore impostato da un altro modulo installato.
Sono supportati solo valori di configurazione in formato stringa semplice o numerico. Le chiavi di configurazione che contengono dati complessi (array o oggetti JSON) vengono rifiutate.
Esempi d'Uso
Esempio: Istruzioni per il bonifico bancario
Un negozio che utilizza il pagamento tramite bonifico vuole che ogni promemoria includa i dati di pagamento. Crea tre variabili:
| Nome Variabile | Tipo | Valore |
|---|---|---|
iban | Valore Statico | DE89 3704 0044 0532 0130 00 |
bic | Valore Statico | COBADEFFXXX |
nome_banca | Valore Statico | Commerzbank AG |
Nel corpo del messaggio, scrivi:
Si prega di trasferire l'importo dovuto di {totalamount} a:
Banca: {nome_banca}
IBAN: {iban}
BIC/SWIFT: {bic}
Riferimento: Ordine #{reference}
Il pagamento deve essere ricevuto entro {daysleft} giorni.
Se i tuoi dati bancari cambiano, aggiorna le tre variabili una volta sola e ogni futuro promemoria rifletterà immediatamente la modifica.
Esempio: Telefono dell'assistenza clienti tramite una chiave di configurazione PrestaShop
Il tuo numero di telefono è già impostato in Parametri negozio > Contatti. Invece di duplicarlo, crea una variabile:
| Nome Variabile | Tipo | Valore |
|---|---|---|
telefono_assistenza | Chiave di Configurazione | PS_SHOP_PHONE |
Poi inserisci {telefono_assistenza} nel piè di pagina del tuo messaggio: "Hai domande? Chiamaci al {telefono_assistenza}." Se aggiorni il numero di telefono nei parametri del negozio PrestaShop, ogni futuro promemoria utilizzerà automaticamente il nuovo numero — senza ulteriori azioni necessarie.
Esempio: Link al portale di pagamento
Il tuo negozio fornisce una pagina di pagamento ospitata dove i clienti possono completare il pagamento online. Memorizza l'URL una volta sola:
| Nome Variabile | Tipo | Valore |
|---|---|---|
url_portale_pagamento | Valore Statico | https://pay.tuonegozio.com/completa |
Nell'oggetto del tuo promemoria: "Completa il tuo pagamento su {url_portale_pagamento}". Tutti i messaggi di promemoria per tutti i tuoi metodi di pagamento includeranno lo stesso URL aggiornato.
Note Importanti
- HTML non è consentito nei valori delle variabili. Qualsiasi tag HTML in un Valore Statico viene rimosso automaticamente al momento del salvataggio. Se hai bisogno di un link cliccabile in un'email, scrivi il tag
<a>direttamente nel corpo del messaggio e usa una variabile solo per la parte dell'URL. - I nomi delle variabili sono univoci per negozio. Non puoi avere due variabili con lo stesso nome nello stesso negozio. Il tentativo di salvare un nome duplicato restituisce un errore.
- Le variabili con Chiave di Configurazione vengono validate all'inserimento. Se la chiave non esiste o contiene un valore complesso (array o oggetto), il modulo la rifiuta con un messaggio di errore chiaro.
- Multi-negozio: ogni negozio ha il proprio elenco di variabili indipendente. Passando da un negozio all'altro nel Back Office vengono mostrate solo le variabili di quel negozio. Le variabili non sono condivise tra negozi.
- Le variabili senza valore risolto vengono ignorate silenziosamente. Se una Chiave di Configurazione viene successivamente rimossa da PrestaShop, il segnaposto apparirà come testo letterale nelle email invece di inserire un valore vuoto. Rimuovi i segnaposto obsoleti dai tuoi template di messaggi se elimini la chiave di configurazione sottostante.
- I nomi delle variabili sono sensibili alle maiuscole.
{iban}e{IBAN}vengono trattati come segnaposto diversi.
Risoluzione dei Problemi
| Problema | Soluzione |
|---|---|
{nome_variabile} appare come testo letterale nell'email inviata | Il nome nel template email non corrisponde esattamente al nome della variabile nella tabella. Verifica la presenza di errori di battitura, lettere maiuscole o spazi. I nomi delle variabili sono sensibili alle maiuscole. |
| Errore "Il nome della variabile può contenere solo lettere, numeri e trattini bassi" | Il nome inserito contiene uno spazio, un trattino o un carattere speciale. Usa i trattini bassi (es. indirizzo_banca invece di indirizzo banca). |
| La Chiave di Configurazione mostra "Non trovato" nell'anteprima | La chiave inserita non esiste nella tabella di configurazione di PrestaShop. Verifica l'ortografia e assicurati che il modulo che crea questa chiave sia installato e sia stato configurato almeno una volta. |
| La Chiave di Configurazione mostra "Il valore di configurazione non è di tipo semplice" | La chiave contiene un array o oggetto JSON (es. un modulo di pagamento che memorizza configurazioni complesse). Sono supportati solo valori in formato stringa o numerico. Usa invece una variabile con Valore Statico e aggiornala manualmente. |
| Hai eliminato una variabile e ora le email mostrano il segnaposto grezzo | Hai eliminato una variabile che è ancora referenziata in un template di messaggio. Modifica i messaggi interessati e rimuovi o sostituisci il segnaposto {nome_variabile}. |
| Il valore della variabile è cambiato ma le email mostrano ancora il vecchio valore | Per le variabili Statiche, apri la variabile e salvala di nuovo con il nuovo valore. Per le variabili con Chiave di Configurazione, verifica che la configurazione PrestaShop sottostante sia stata effettivamente aggiornata e salvata. |
| Errore di nome duplicato al salvataggio | Ogni nome di variabile deve essere univoco all'interno dello stesso negozio. Scegli un nome diverso oppure modifica la variabile esistente. |
Domande Frequenti
Quante variabili personalizzate posso creare?
Non c'è un limite fisso. Puoi creare tutte le variabili di cui il tuo negozio ha bisogno.
Posso usare una variabile personalizzata sia nell'oggetto che nel corpo dell'email?
Sì. Le variabili personalizzate vengono sostituite sia nell'oggetto che nel corpo di ogni email di promemoria prima della consegna.
Cosa succede se uso {numero_conto} in un messaggio ma non ho ancora creato quella variabile?
Il segnaposto viene lasciato come testo letterale nell'email inviata — il tuo cliente vedrà {numero_conto} nel messaggio. Verifica sempre che le variabili esistano e che l'anteprima sia corretta prima di attivare un messaggio.
Posso memorizzare testo su più righe come un indirizzo postale completo in una variabile?
No. I valori delle variabili sono testo normale memorizzato in un campo a riga singola (massimo 255 caratteri). Per contenuti su più righe come un indirizzo postale completo, scrivilo direttamente nel corpo del messaggio usando l'editor di testo avanzato.
Una variabile con Chiave di Configurazione si aggiorna automaticamente quando cambia l'impostazione PrestaShop?
Sì. Il valore viene letto dalla tabella di configurazione ogni volta che il cron viene eseguito e invia un'email, quindi qualsiasi modifica all'impostazione PrestaShop sottostante ha effetto alla successiva esecuzione del promemoria, senza alcuna azione richiesta da parte tua.
Posso usare la stessa variabile in più messaggi di promemoria?
Sì. Una variabile definita una volta è disponibile in ogni messaggio di promemoria per quel negozio. Inserisci {nome_variabile} in tutti i messaggi che desideri.
Qual è la differenza tra le Variabili Personalizzate e le variabili predefinite come {totalamount}?
Le variabili predefinite vengono popolate automaticamente con i dati dell'ordine in tempo reale — nome del cliente, totale dell'ordine, giorni rimanenti e così via. Le variabili personalizzate sono testi che definisci tu stesso, tipicamente informazioni specifiche del negozio come i dati di pagamento o i contatti che non provengono da un singolo ordine.
Le variabili personalizzate vengono sostituite anche nelle email in Modalità Test?
Sì. Quando invii un'email di test dalla sezione Modalità Test, le variabili personalizzate vengono risolte e sostituite esattamente come avverrebbe in un promemoria reale.
Cosa succede se una Chiave di Configurazione che ho usato viene disinstallata o rimossa?
La variabile continuerà a esistere nel tuo elenco, ma il segnaposto apparirà come testo letterale nelle email inviate perché la chiave non esiste più. Rimuovi o sostituisci il segnaposto nei tuoi template di messaggi, poi elimina la variabile dall'elenco per mantenere tutto in ordine.