Las variables, también conocidas como etiquetas de personalización o etiquetas de fusión, te permiten insertar datos personalizados para cada destinatario, como su nombre o su compra más reciente. Los filtros modifican cómo se muestran estos datos. 

¿Cómo se utilizan los filtros?

Los filtros se utilizan dentro de llaves dobles {{ }} con un símbolo de barra vertical |. Por ejemplo:

Puedes encadenar múltiples filtros, de modo que la salida de un filtro pase al siguiente. Por ejemplo:

Para insertar una variable con filtros en un mensaje, puedes:

• Escribir la variable y los filtros manualmente; o

  

• Seleccionar una variable existente y editar su sintaxis en la pestaña Advanced settings (Configuración Avanzada).

  

💬 Insertar un valor predeterminado

default

Inserta un valor de recuperación si una variable está vacía.

🔠 Formato de mayúsculas de la palabra

capfirst

Escribe en mayúscula el primer carácter.

title

Escribe en mayúscula la primera letra de cada palabra.

upper

Convierte todos los caracteres a mayúsculas.

lower

Convierte todos los caracteres a minúsculas.

truncatechars

Acorta una cadena a N caracteres. Los valores truncados finalizarán con puntos suspensivos (…) incluidos en el recuento de caracteres.

🔢 Formato de números

floatformat

Redondea los valores flotantes a un número específico de decimales.

integer

Convierte un número en formato de cadena o punto flotante en un número entero.

float

Convierte un número en formato de cadena o entero en un número de coma flotante.

lang_format

Da formato a los números según el idioma.

📅 Formato de fecha y hora

time_parse

Convierte una cadena de fecha en una marca de tiempo estándar que se puede utilizar con otros filtros, como date o date_i18n.

Al incluir el formato de fecha como argumento, escribe la fecha y la hora exactamente como se vería la hora de referencia si fuera el valor.

date

Convierte una marca de tiempo o una fecha analizada en un formato especificado. Utilízalo con una fecha analizada mediante time_parse o con la hora actual utilizando time_now.

date_i18n

Convierte una marca de tiempo o fecha analizada a un formato especificado, y muestra la salida en un idioma especificado. Este filtro funciona como date, pero primero debes especificar el idioma, seguido del formato.

Los idiomas admitidos son en, fr, it, es, de y pt.

time_add_date

Añade años, meses y días a una marca de tiempo o fecha analizada. Debes especificar el tiempo que quieres añadir en el orden año, mes y día.

time_in_location

Convierte una marca de tiempo o una fecha analizada a una zona horaria especificada. Debes especificar la zona horaria en el formato ubicación/zona horaria.

time_add_duration

Añade horas, minutos y segundos a una marca de tiempo o fecha analizada. Debes especificar el valor en el formato h, m, s y pasar al menos un valor (hora, minuto o segundo) en el filtro.

time_unix

Convierte un valor temporal a un sello temporal Unix en segundos.

time_unix_nano

Convierte un valor temporal a un sello temporal Unix en nanosegundos.

🧑‍💻 Codificar o encriptar datos

base64_encode o decode

Codifica o descodifica en base64:

• base64_decode descodifica una cadena a un []byte
• base64_encode codifica un []byte a una cadena

Los filtros base64_encode y decode pueden coger un parámetro de codificación adicional:

• std: codificación normal en base64,
• raw_std: codificación normal en base64, sin los caracteres = de relleno,
• url: versión segura de URL de codificación en base64, + y / se sustituyen por - y _ respectivamente,
• raw_url: una combinación de raw y url.

aes_128, 192 o 256

Encripta un valor. Por ejemplo, se puede usar este filtro para enviar información de contacto encriptada en una URL, como una dirección de email o un ID.

La variante AES utilizada depende de la longitud de la clave proporcionada:

Por ejemplo, para la variante AES-256, la variable debe tener el formato {{ contact.ATTRIBUTE | aes_256:'key' }}, donde la clave:

• Debe tener 32 dígitos.
• Debe haber sido generada aleatoriamente.
• Debe persistir en su lado para poder desencriptar el valor original.

De manera predeterminada, si no se añade ningún parámetro de codificación, se utilizará base64 std. Si no, también admite:

• raw_std: codificación normal en base64, sin los caracteres = de relleno,
• url: versión segura de URL de codificación en base64, + y / se sustituyen por - y _ respectivamente,
• raw_url: una combinación de raw y url.

🔎 Otros filtros

first

Devuelve el primer elemento de una secuencia, una asignación o una cadena.

join

Combina los elementos de un conjunto en una sola cadena utilizando el argumento como separador.

El separador entre elementos está vacío por defecto. Puedes definirlo con el primer parámetro opcional.

last

Devuelve el último elemento de una secuencia, un mapeo o una cadena.

length

Devuelve el número de elementos de una secuencia o un mapeo, o la longitud de una cadena.

safe

Marca una cadena para indicar que no requiere caracteres de escape de HTML antes de la salida.

Sin el filtro "safe" la etiqueta HTML aparecería como una cadena normal en el email del destinatario: "<p>Esta es mi frase de prueba</p>" o "Welcome to <b>Brevo</b>, we're glad to have you here".

slice

Extrae un trozo de una frase, mapeo o cadena.

Este filtro se puede configurar para:

En cada ejemplo, imagine que su conjunto contiene: ["a","b","c","d","e","f","g","h"...].

literal

En Brevo, las variables se escriben utilizando llaves dobles, como {{ params.property }}. Cuando incluyes llaves doble como {{ this }} en tu email, Brevo las considera un elemento de plantilla.

Para mostrar {{ }} como texto sin formato en tu email, envuelve el contenido en un bloque {% verbatim %}:

escape automático

De forma predeterminada, Brevo escapa de todo el contenido de la variable, incluidos HTML y JavaScript. Esto significa que si tu variable contiene HTML (por ejemplo, <h1>Mi título</h1>), se mostrará como texto sin formato en lugar de procesarse como HTML.

Para permitir la representación HTML, debes deshabilitar el escape automático mediante la etiqueta {% autoescape off %} . Envuelve la variable en este bloque y ciérralo con {% endautoescape %}:

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

📖 Recursos adicionales

El Lenguaje de Plantillas de Brevo se basa en Pongo2, una reimplementación de Django in Go (un lenguaje de programación).

Todas las etiquetas compatibles

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

Todos los filtros compatibles

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.

Todos los filtros compatibles con algoritmos 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.

🤔 ¿Tiene alguna duda?

Si tiene alguna pregunta, no dude en ponerse en contacto con nuestro equipo de asistencia mediante la creación de un ticket desde su cuenta. Si todavía no tiene una cuenta, puede ponerse en contacto con nosotros aquí.

Si necesitas ayuda con un proyecto usando Brevo, podemos ponerte en contacto con la agencia partner de Brevo adecuada.