En este artículo explicaremos cómo utilizar el Lenguaje de Plantillas de Brevo para modificar los marcadores de posición en sus emails mediante filtros.

🤔 ¿Qué son los filtros?

Los filtros cambian el resultado de un marcador de posición. Se utilizan con llaves dobles
{{ }} y están separados por una barra vertical |, por ejemplo: {{ contact.NAME|upper }}. Se pueden encadenar varios filtros y el resultado de un filtro se aplicará al siguiente. 

Si quiere añadir un filtro a un marcador de posición en una campaña de email o plantilla, deberá añadirlo de forma manual. En el editor Drag & Drop, también tiene que escribir el marcador de posición de forma manual, ya que no se puede añadir un filtro a un marcador de posición que se añadió mediante la opción de Personalization (Personalización).

Agregar un marcador de posición simple con la opción Personalization (Personalización)
Agregar un marcador de posición con filtros manualmente

💬 Insertar un valor predeterminado

default

Inserta un valor de recuperación predeterminad oen caso de que el valor de la variable esté vacío.

🔠 Formato de mayúsculas de la palabra

capfirst

Haga que el primer carácter de una variable aparezca en mayúsculas.

title

Devuelve una versión con las mayúsculas del título del valor. Cada palabra empezará con mayúsculas y el resto de caracteres serán minúsculas.

upper

Convierte cada carácter de una variable en mayúscula.

lower

Convierte cada carácter de una variable en minúscula.

truncatechars

Acorta una variable si supera el número de caracteres especificados. La variables truncadas acabarán con una elipsis (…) incluida en el recuento de caracteres.

🔢 Formato de números

floatformat

Redondea el resultado de los valores flotantes de sus variables a un decimal especificado.

Para que funcione correctamente, los valores deben incluirse como número, en lugar de como cadena, y los valores no deben incluirse entre comillas como “valor”.

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

Cambia el formato del número según el idioma del destinatario.

Nota:

• Para forzar 2 decimales, añada ,%.2f después del idioma de la variable.
• En francés, el separador de enteros es un espacio de no separación.

📅 Formato de fecha y hora

time_parse

Convierte el formato de su fecha (incluido como una cadena) a un formato de fecha estándar que puede utilizarse con otros filtros.

Para incluir el formato de fecha actual como un argumento, utilice el mismo formato de fecha/hora con el que se mostraría la hora de referencia si este fuera el valor.

Nota: Si el formato de su cadena utiliza RFC3339 puede utilizar el parse específico time_parse_rfc3339 sin argumento.

date

Convierte la fecha a un formato concreto.

Obtendrá una fecha de una cadena utilizando el filtro time_parse o la hora actual utilizando el filtro date en el marcador de posición time_now.

date_i18n

Convierte una fecha a un formato específico, pero la salida estaría en otros idiomas.

Actualmente, los idiomas admitidos son en, fr, it, es, de y pt. Este filtro es similar al filtro "date", y la única diferencia es que primero se debe especificar el idioma en el filtro y luego el formato.

time_add_date

Añade el número de días a un sello temporal o a una cadena de fecha. Es obligatorio incluir todos los valores en este filtro en este orden: "año, mes, día".

time_in_location

Convierte un sello temporal o una cadena de fecha según la zona horaria incluida en el filtro. Es obligatorio incluir la zona horaria en el filtro con este formato: "ubicación/zona horaria”.

time_add_duration

Añade la duración a un sello temporal o a una cadena de fecha. Es obligatorio incluir al menos un valor (hora, minuto o segundo) al 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, el marcador de posición 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, un mapeo o una cadena.

join

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

El separador entre elementos es una variable vacía de forma predeterminada. Puede 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"...].

📖 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.

⏩ ¿Qué es lo siguiente?

• Cómo personalizar los emails transaccionales
• Desactive el escape automático para mostrar llaves dobles en sus emails

🤔 ¿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 un socio certificado de Brevo.