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 ti consentono di controllare come vengono visualizzati questi dati modificandone il formato o il contenuto.

Cosa sono i filtri?

I filtri modificano l'output di una variabile. Vengono utilizzati all'interno di parentesi graffe doppie {{ }} e sono separati dalla variabile da una barra verticale |. Ad esempio, {{ contact.FIRSTNAME|upper }} visualizzerà il nome del contatto in maiuscolo.

Puoi anche concatenare più filtri insieme, il che significa che l'output di un filtro viene passato al successivo.

Per utilizzare un filtro in una campagna email o in un modello di email, devi aggiungerlo manualmente alla variabile. Ciò significa che devi scrivere da solo l'intera variabile. Nell'editor drag & drop, la variabile apparirà quindi come un tag, senza il filtro.

💬 Inserimento di un valore predefinito

default

Inserisce un valore di riserva predefinito per i casi in cui il valore della variabile è vuoto.

🔠 Formato Maiuscolo/minuscolo

capfirst

Rende maiuscolo il primo carattere del valore di una variabile.

title

Restituisce una versione del valore di una variabile con tutte le iniziali maiuscole. Le parole inizieranno con lettere maiuscole, tutti gli altri caratteri saranno minuscoli.

upper

Rende maiuscolo ogni carattere del valore di una variabile.

lower

Rende minuscolo ogni carattere del valore di una variabile.

truncatechars

Accorcia il valore di una variabile se è più lungo del numero di caratteri specificato. I valori troncati termineranno con i puntini di sospensione (…) inclusi nel conteggio dei caratteri.

🔢 Formato dei numeri

floatformat

Arrotonda il risultato dei valori in virgola mobile della variabile alla posizione decimale specificata.

Per funzionare correttamente, i valori passati devono essere passati come numero, anziché come stringa, e non devono essere passati tra virgolette come "valore".

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 in base alla lingua del destinatario.

📅 Formato di data e ora

time_parse

Converte il formato della data (passato come stringa) in un formato di data standard che può essere usato con altri filtri.

Per passare il formato di data corrente come argomento, formatta la data/ora esatta di come verrebbe visualizzata l'ora di riferimento se fosse il valore.

date

Converte una data in un formato specificato.

Otterrai una data da una stringa utilizzando il filtro time_parse o l'ora corrente passando il filtro date alla variabile time_now.

date_i18n

Converte una data in un formato specificato, ma l'output sarà in altre lingue.

Attualmente le lingue supportate sono en, fr, it, es, de e pt. Questo filtro è simile al filtro "date" e l'unica differenza è che deve prima essere specificata la lingua nel filtro e poi il formato.

time_add_date

Aggiunge un numero di giorni a un timbro data/ora o a una stringa di data. È obbligatorio passare tutti i valori a questo filtro nel seguente ordine: "anno, mese, giorno".

time_in_location

Converte un timbro data/ora o una stringa di data in base al fuso orario passato al filtro. È obbligatorio passare un fuso orario al filtro nel seguente formato: "posizione/fuso orario".

time_add_duration

Aggiunge la durata a un timbro data/ora o a una stringa di data. È obbligatorio 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 avere il formato {{ contact.ATTRIBUTE | aes_256:"key" }}, dove 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 le doppie parentesi graffe come {{ this }} nella tua email, Brevo le considera come un elemento del modello.

Per visualizzare {{ }} come testo normale 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 {% autoescape off %}. Racchiudi 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.