Le variabili (note anche come tag di personalizzazione o merge tag) ti consentono di inserire dati personalizzati per ogni destinatario, ad esempio il nome o l'acquisto più recente. I filtri modificano il modo in cui vengono visualizzati questi dati. 

Come utilizzare i filtri?

Utilizza i filtri all'interno di doppie parentesi graffe {{ }} con una barra verticale |. Ad esempio:

Puoi concatenare più filtri, così che i risultati di un filtro vengano sottoposti al successivo. Ad esempio:

Per inserire una variabile con filtri in un messaggio, puoi:

• Digitare manualmente la variabile e i filtri, oppure

  

• Selezionare una variabile esistente e modificane la sintassi nella scheda Advanced settings (Impostazioni avanzate).

  

💬 Inserimento di un valore predefinito

default

Inserisce un valore di riserva se una variabile è vuota.

🔠 Formato Maiuscolo/minuscolo

capfirst

Scrive con la maiuscola il primo carattere.

title

Scrive con la maiuscola la prima lettera di ogni parola.

upper

Converte tutti i caratteri in maiuscolo.

lower

Converte tutti i caratteri in minuscolo.

truncatechars

Accorcia una stringa a N caratteri. I valori troncati terminano con i puntini di sospensione (…) inclusi nel conteggio dei caratteri.

🔢 Formato dei numeri

floatformat

Arrotonda i valori fino a un numero specificato di decimali.

integer

Converte un numero in formato stringa o in virgola mobile in un numero intero.

float

Converte un numero in formato stringa o intero in un numero in virgola mobile.

lang_format

Formatta i numeri secondo una data lingua.

📅 Formato di data e ora

time_parse

Converte una stringa di date in un marcatore temporale standard che può essere utilizzato con altri filtri, come date o date_i18n.

Per utilizzare il formato della data come argomento, scrivi data e ora esattamente così come apparirebbe l'orario di riferimento se fosse il valore.

date

Converte un marcatore temporale o una data analizzata in un formato specificato. Utilizzalo con una data analizzata tramite time_parse o con l'orario attuale utilizzando time_now.

date_i18n

Converte un riferimento temporale o una data analizzata in un formato specificato, con l'output visualizzato in una lingua specificata. Questo filtro funziona come date, ma devi prima specificare la lingua, seguita dal formato.

Le lingue supportate sono en, fr, it, es, de e pt.

time_add_date

Aggiunge anni, mesi e giorni a un riferimento temporale o a una data analizzata. Devi specificare l'orario per aggiungere nell'ordine anno, mese, giorno.

time_in_location

Converte un riferimento temporale o una data analizzata in un fuso orario specificato. Devi specificare il fuso orario nel formato posizione/fuso orario.

time_add_duration

Aggiunge ore, minuti e secondi a un riferimento temporale o a una data analizzata. Devi specificare il valore nel formato h, m, s e passare almeno un valore (ora, minuto o secondo) nel filtro.

time_unix

Converte un valore di tempo nel timbro data/ora Unix in secondi.

time_unix_nano

Converte un valore di tempo nel timbro data/ora Unix in nanosecondi.

🧑‍💻 Codifica o cifratura dei dati

base64_encode o decode

Codifica o decodifica la base 64:

• base64_decode decodifica una stringa in []byte
• base64_encode codifica []byte in una stringa

I filtri base64_encode e decode possono accettare un parametro di codifica facoltativo:

• std: normale codifica base64,
• raw_std: normale codifica base64, senza il carattere di riempimento =,
• url: versione protetta della codifica base64 per gli URL, + e / sono sostituiti rispettivamente da - e _,
• raw_url: una combinazione di raw e url.

aes_128, 192 o 256

Crittografa un valore. Ad esempio, è possibile utilizzare questo filtro per inviare informazioni di contatto crittografate in un URL, ad esempio un indirizzo di posta elettronica o un ID.

La variante AES utilizzata dipende dalla lunghezza della chiave fornita:

Ad esempio, per la variante AES-256, la variabile deve essere formattata come {{ contact.ATTRIBUTE | aes_256:'key' }}, con la chiave:

• Deve essere costituita da 32 cifre.
• Deve essere generata in modo casuale.
• Deve continuare a persistere sul tuo lato affinché sia possibile decrittografare il valore originale.

Per impostazione predefinita, se non viene aggiunto alcun parametro di codifica, verrà utilizzato base64 std. In caso contrario, supporta anche:

• raw_std: normale codifica base64, senza il carattere di riempimento =,
• url: versione protetta della codifica base64 per gli URL, + e / sono sostituiti rispettivamente da - e _,
• raw_url: una combinazione di raw e url.

🔎 Altri filtri

first

Restituisce il primo elemento di una sequenza, un abbinamento o una stringa.

join

Combina gli elementi di una matrice in una singola stringa usando l'argomento come separatore.

Il separatore tra gli elementi è vuoto per impostazione predefinita. Puoi definirlo con il primo parametro opzionale.

last

Restituisce l'ultimo elemento di una sequenza, un abbinamento o una stringa.

length

Restituisce il numero di elementi di una sequenza o di un abbinamento, o la lunghezza di una stringa.

safe

Contrassegna una stringa come elemento che non necessita di ulteriore escape HTML prima dell'output.

Senza il filtro safe, il tag HTML verrebbe visualizzato come una normale stringa nell'email del destinatario: "<p>This is my test sentence</p>" o "Welcome to <b>Brevo</b>, we're glad to have you here".

slice

Estrae una parte di una sequenza, un abbinamento o una stringa.

Questo filtro può essere configurato per:

Per ogni esempio, tieni presente che la matrice contiene quanto segue: ["a","b","c","d","e","f","g","h"...].

verbatim

In Brevo, le variabili vengono scritte utilizzando doppie parentesi graffe come {{ params.property }}. Quando includi doppi parentesi graffe come {{ this }} nella tua email, Brevo lo considera un elemento del modello.

Per visualizzare {{ }} come testo semplice nella tua email, racchiudi il contenuto in un blocco {% verbatim %}:

autoescape

Per impostazione predefinita, Brevo esegue l'escape di tutto il contenuto della variabile, inclusi HTML e JavaScript. Ciò significa che se la tua variabile contiene codice HTML (ad esempio, <h1>Il mio titolo</h1>), verrà visualizzata come testo normale anziché come HTML.

Per consentire il rendering HTML, devi disabilitare l'autoescape utilizzando il tag {% endautoescape %}. Inserisci la variabile in questo blocco e chiudilo con {% endautoescape %}:

{% autoescape off %}{{ params.my_html }}{% endautoescape %}

📖 Risorse aggiuntive

Il linguaggio per modelli Brevo è basato su Pongo2, che è una reimplementazione di Django in Go (un linguaggio di programmazione).

Tutti i tag supportati

autoescape, comment, cycle, filter, firstof, for, if, ifchanged, now, set, spaceless, templatetag, with.

Tutti i filtri supportati

escape, safe, escapejs, add, addslashes, capfirst, center, cut, date, default, default_if_none, divisibleby, first, floatformat, get_digit, iriencode, join, last, length, length_is, linebreaks, linebreaksbr, linenumbers, ljust, lower, make_list, phone2numeric, pluralize, random, removetags, rjust, slice, stringformat, striptags, time, title, truncatechars, truncatechars_html, truncatewords, truncatewords_html, upper, urlencode, urlize, urlizetrunc, wordcount, wordwrap, yesno.

Tutti i filtri supportati per gli algoritmi hash

hash_md5, hash_sha256, hash_sha256_224, hash_sha512, hash_sha512_224, hash_sha512_256, hash_sha512_384, hash_sha3_224, hash_sha3_256, hash_sha3_384, hash_sha3_512.

🤔 Domande?

In caso di domande, non esitare a contattare il team dell’assistenza creando un ticket dal tuo account. Se ancora non hai un account, puoi contattarci qui.

Se stai cercando aiuto per un progetto che prevede l'utilizzo di Brevo, possiamo metterti in contatto con l'agenzia partner di Brevo giusta per te.