In questo articolo, spiegheremo come usare il linguaggio per modelli Brevo per modificare i segnaposto nelle tue email usando i filtri.
🤔 Cosa sono i filtri?
I filtri cambiano il risultato generato da un segnaposto. Vengono inseriti all'interno di doppie parentesi graffe {{ }} separati da una barra verticale |, ad esempio {{ contact.NAME|upper }}. È possibile concatenare più filtri e il risultato generato da un filtro viene applicato al successivo.
Per aggiungere un filtro a un segnaposto in una campagna email o in un modello, devi aggiungerlo manualmente. Nell'editor drag & drop (nuova versione), devi anche scrivere il segnaposto manualmente, poiché non puoi aggiungere un filtro a un segnaposto aggiunto usando l'opzione Personalization (Personalizzazione).
Aggiunta di un segnaposto semplice con l'opzione Personalization (Personalizzazione) | |
Aggiunta di un segnaposto con filtri manualmente |
💬 Inserimento di un valore predefinito
default
Inserisce un valore di riserva predefinito per i casi in cui il valore della variabile è vuoto.
Ingresso | Uscita |
Ciao {{ contact.NAME|default:'there' }}, | Buongiorno a te, |
🔠 Formato Maiuscolo/minuscolo
capfirst
Rende maiuscolo il primo carattere di una variabile.
Ingresso | Uscita |
{{ contact.MESSAGE|capfirst }} | La mia macchina rossa |
title
Restituisce una versione del valore con tutte le iniziali maiuscole. Le parole inizieranno con lettere maiuscole, tutti gli altri caratteri sono minuscoli.
Ingresso | Uscita |
{{ contact.NAME|title }} | John Doe |
upper
Rende maiuscolo ogni carattere di una variabile.
Ingresso | Uscita |
{{ contact.NAME|upper }} | JOHN DOE |
lower
Rende minuscolo ogni carattere di una variabile.
Ingresso | Uscita |
{{ contact.NAME|lower }} | john doe |
truncatechars
Accorcia una variabile se è più lunga del numero di caratteri specificato. Le variabili troncate termineranno con un'ellissi (...) inclusa nel conteggio dei caratteri.
Ingresso | Uscita |
{{ contact.MANAGER|truncatechars:7 }} | Elisab… |
🔢 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".
Ingresso | Uscita |
{{ contact.BALANCE|floatformat:2 }} | 40.32 |
{{ contact.BALANCE|floatformat:0 }} | 40 |
integer
Converte un numero in formato stringa o in virgola mobile in un numero intero.
Ingresso | Uscita |
{{ 10.578|integer }} | 10 |
{{ "16.765"|integer }} | 16 |
float
Converte un numero in formato stringa o intero in un numero in virgola mobile.
Ingresso | Uscita |
{{ 10|float }} | 10.000000 |
{{ "16.765"|float }} | 16.765000 |
lang_format
Formatta i numeri in base alla lingua del destinatario.
Ingresso | Uscita |
{{ params.NUMBER|lang_format:"fr" }} | 123 456,789 |
{{ params.NUMBER|lang_format:"en" }} | 123,456.789 |
{{ params.NUMBER|lang_format:"hi" }} | 1,23,456.789 |
{{ params.NUMBER|lang_format:"bn" }} | ১,২৩,৪৫৬.৭৮৯ |
{{ params.NUMBER|lang_format:"fr,%.2f" }} | 123 456,79 |
Note:
- Per forzare 2 decimali, aggiungi ,%.2f dopo la variabile della lingua.
- Per il francese, il separatore delle migliaia è uno spazio unificatore.
📅 Formato di data e ora
- L'ora di riferimento è "Monday January 2 15:04:05 -0700 MST 2006".
- Se non viene passato un valore, sarà considerato come pari a 0.
- Il fuso orario predefinito (se non passato) è UTC.
- È possibile usare le parole chiaveam/pm.
- I modi più comuni per definire il fuso orario sono: le parole chiave dedicate (MST, CET, UTC, Asia/Kolkata, ecc.), o l'alternativa numerica, +0100 o -0100, rispetto a UTC.
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.
Ingresso | Uscita |
{{ params.MY_DATE|time_parse:"Monday 02 January 2006" }} | Tuesday 11 March 2021 |
Nota: se la stringa è formattata usando RFC3339, puoi usare il parser dedicato time_parse_rfc3339 senza argomento.
date
Converte una data in un formato specificato.
Otterrai una data da una stringa utilizzando il filtro time_parse o l'ora corrente passando la data filtro al segnaposto time_now.
Ingresso | Uscita |
{{ "14:01 01/06/2018"|time_parse:"15:04 02/01/2006"|date:"Mon Jan 2 15:04:05 2006" }} | Fri Jun 1 14:01:00 2018 |
{{ time_now|date:"Monday, Jan 2, 2006" }} | tamperà il giorno e la data correnti nel formato specificato |
{{ time_now|date:"02/01/2006" }} | tamperà il giorno e la data correnti nel formato specificato |
{{ time_now|date:"01" }} |
Stamperà il mese corrente |
{{ time_now|date:"02" }} |
Stamperà il giorno corrente |
{{ time_now|date:"2006" }} |
Stamperà l'anno corrente |
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 la lingua deve essere specificata prima nel filtro e poi il formato.
Ingresso | Uscita |
{{ "14:01 01/06/2018" | time_parse:"15:04 02/01/2006"|date_i18n:"en,Monday" }} | Friday |
{{ "14:01 01/06/2018" | time_parse:"15:04 02/01/2006"|date_i18n:"de,Monday" }} | Freitag |
time_add_date
Aggiunge il numero di giorni a un timbro data/ora o a una stringa data. È obbligatorio passare tutti i valori a questo filtro nel seguente ordine: "anno, mese, giorno".
Ingresso | Uscita |
{{ time_now|time_add_date:"1,2,3" }} | Stamperà il timbro data/ora dopo aver aggiunto 1 anno, 2 mesi e 3 giorni al timbro data/ora corrente |
{{ "14:01 01/06/2018"|time_parse:"15:04 02/01/2006"|time_add_date: "1,2,3" }} |
2019-08-04 14:01:00 +0000 UTC |
time_in_location
Converte un timbro data/ora o una stringa data in base al fuso orario passato al filtro. È obbligatorio passare un timbro data/ora al filtro con il seguente formato: "posizione/fuso orario”.
Ingresso | Uscita |
{{ time_now|time_in_location:"Europe/Berlin" }} | Stamperà il timbro data/ora corrente in CEST |
{{ "14:01 01/06/2018"|time_parse:"15:04 02/01/2006"|time_in_location: "Europe/Berlin" }} | 2018-06-01 16:01:00 +0200 CEST |
time_add_duration
Aggiunge una durata di tempo a un timbro data/ora o a una stringa data. È obbligatorio passare almeno un valore (ora, minuto o secondo) nel filtro.
Ingresso | Uscita |
{{ time_now|time_add_duration:"1h2m3s" }} | Stamperà il timbro data/ora dopo aver aggiunto 1 ora, 2 minuti e 3 secondi al valore di tempo nel timbro data/ora corrente |
{{ time_now|time_add_duration:"30m" }} | Stamperà il timbro data/ora dopo aver aggiunto 30 minuti al valore di tempo |
time_unix
Converte un valore di tempo nel timbro data/ora Unix in secondi.
Ingresso | Uscita |
{{ time_now|time_unix }} | Stamperà il timbro data/ora Unix corrente in secondi |
time_unix_nano
Converte un valore di tempo nel timbro data/ora Unix in nanosecondi.
Ingresso | Uscita |
{{ time_now|time_unix_nano }} | Stamperà il timbro data/ora Unix corrente 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
Ingresso | Uscita |
https://example.com/test?name={{ contact.FIRSTNAME|base64_encode }} | https://example.com/test?name=RW56bw== (invece di of https://example.com/test?name=Enzo) |
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:
Lunghezza della chiave segreta | Variante AES |
16 byte (128 bit) | AES-128 |
24 byte (192 bit) | AES-192 |
32 byte (256 bit) | AES-256 |
Ad esempio, per la variante AES-256, il segnaposto 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.
Nei nostri esempi seguenti, stiamo crittografando gli indirizzi email dei nostri contatti utilizzando la seguente chiave: e5a34a481274c776856d04119bed8188. Nota che non devi usare la stessa chiave e invece generare la tua chiave seguendo le indicazioni fornite più sopra.
Codifica | Ingresso | Uscita |
Nessuna codifica (codifica base64 std per impostazione predefinita) |
{{ contact.EMAIL | aes_256: "e5a34a481274c776856d04119bed8188" }} |
Stamperà una stringa casuale che deve essere decrittografata per poter leggere il valore originale |
Codifica base64 raw_std |
{{ contact.EMAIL | aes_256: "e5a34a481274c776856d04119bed8188, raw_std" }} |
Stamperà una stringa casuale che deve essere decrittografata per poter leggere il valore originale |
Codifica base64 url |
{{ contact.EMAIL | aes_256: "e5a34a481274c776856d04119bed8188, url" }} |
Stamperà una stringa casuale che deve essere decrittografata per poter leggere il valore originale |
Codifica base64 raw_url |
{{ contact.EMAIL | aes_256: "e5a34a481274c776856d04119bed8188, raw_url" }} |
Stamperà una stringa casuale che deve essere decrittografata per poter leggere il valore originale |
🔎 Altri filtri
first
Restituisce il primo elemento di una sequenza, un abbinamento o una stringa.
Ingresso | Richiesta API | Uscita |
{{ params.array|first }} | "params" : { "array" : [ 1,2,3,4 ] } |
1 |
join
Combina gli elementi di una matrice in una singola stringa usando l'argomento come separatore.
Il separatore tra gli elementi è una variabile vuota per impostazione predefinita. Puoi definirlo con il primo parametro facoltativo.
Ingresso | Uscita |
{{ [1, 2, 3]|join }} | 123 |
{{ [1, 2, 3]|join: '|' }} |
1|2|3 |
last
Restituisce l'ultimo elemento di una sequenza, un abbinamento o una stringa.
Ingresso | Uscita |
{{ [1, 2, 3, 4]|last }} | 4 |
length
Restituisce il numero di elementi di una sequenza o di un abbinamento, o la lunghezza di una stringa.
Ingresso | Uscita |
{{ ['a', 'b', 'c', 'd']|length }} | 4 |
safe
Contrassegna una stringa come elemento che non necessita di ulteriore escape HTML prima dell'output.
A |
Richiesta API |
Ingresso | Uscita | |
"params" :{HtmlTest: "<p>This is my test sentence.</p>"} |
{{ params.htmltest|safe }} |
This is my test sentence | ||
B |
Attributo di contatto |
Segnaposto |
Ingresso | Uscita |
EMAIL_SALUTATION | Welcome to <b>Brevo</b>, we're glad to have you here | {{ contact.EMAIL_SALUTATION|safe }} | Welcome to Brevo, we're glad to have you here |
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:
A | Passare a ciclo continuo solo i primi "n" elementi di una matrice. | In entrambi i casi, ricorda che agli elementi di una matrice viene assegnato un numero di posizione unico con "0" come prima posizione (sono "indicizzati a zero"). |
B | Passare a ciclo continuo gli elementi compresi fra due posizioni specificate ("n" e "m") della matrice. | |
C | Passare a ciclo continuo gli elementi compresi fra due elementi specificati di una matrice. |
Per ogni esempio, tieni presente che la matrice contiene quanto segue: ["a","b","c","d","e","f","g","h"...].
|
Ingresso | Uscita |
A |
{% for product in params.products|slice:':5' %} {{ product.name }} - {{ product.price }} {% endfor %} |
Passerà a ciclo continuo le prime 5 posizioni (0-4), che sono: ["a","b","c","d","e"] |
B | {% for product in params.products|slice:'2:3' %} {{ product.name }} - {{ product.price }} {% endfor %} |
Passerà a ciclo continuo le posizioni (2-3), che sono: ["c","d"] |
C | {% for product in params.products|slice:'b:d' %} {{ product.name }} - {{ product.price }} {% endfor %} |
Passerà a ciclo continuo gli elementi specificati, che sono: ["b","c","d"] |
📖 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.
⏩ E adesso?
- Come personalizzare le tue email transazionali
- Disabilitazione di autoescape e visualizzazione delle doppie parentesi graffe nelle email
🤔 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 il giusto partner esperto certificato Brevo.