Utiliza un bucle for para mostrar todos los elementos de una matriz de forma dinámica. Esto resulta especialmente útil cuando se desconoce el número de elementos de la matriz, como en el caso de una lista de publicaciones semanales en un blog o un recibo de productos comprados.

Puedes utilizar un bucle for según diferentes criterios:

• Datos del evento
  Personaliza el contenido en función de las acciones que tus contactos hayan realizado (o no). Por ejemplo, podrías mostrar un bloque promocional solo a los contactos que nunca hayan realizado un pedido.
• Feeds de datos
  Personaliza el contenido utilizando datos en tiempo real de feeds externos. Por ejemplo, puedes mostrar recomendaciones de productos personalizadas, precios en vivo o información localizada de la tienda basada en datos externos.
• Feeds de productos
  Personaliza el contenido utilizando la información del producto de tu sitio web de ecommerce. Por ejemplo, puede mostrar tus productos más vendidos o recomendaciones de productos personalizadas.

¿Qué es un bucle for?

Un bucle for es una estructura de programación que se utiliza para repetir un bloque de código para cada elemento de una matriz. En lugar de hacer referencia manualmente a cada índice, el bucle itera a través de la matriz y muestra cada elemento automáticamente. 

En las plantillas de email, los bucles for te permiten mostrar contenido de forma dinámica, como por ejemplo:

• Un recibo en el que se enumeran todos los artículos que ha comprado un cliente.
• Un recordatorio por email con los artículos que quedan en el carrito de un cliente.
• Una campaña RSS que muestra los últimos artículos del blog.
• Un email personalizado con recomendaciones de productos actualizadas procedentes de un feed de datos externo.

Estructura y sintaxis de un bucle for

La sintaxis de un bucle for puede variar según el tipo de elemento que se repite. En nuestros ejemplos, sustituye placeholder, array y variable con los datos apropiados del elemento que quieres repetir, tal y como se explica en la siguiente tabla:

for, in

Muestra todos los elementos de una matriz como una lista.

{% for placeholder in array %}
 variable
{% endfor %}

Abre la pestaña correspondiente al tipo de datos que quieres mostrar:

{% for item in params.items %}
 {{ item.name }} - {{ item.currency }}{{ item.price }}
{% endfor %}

{% for item in feed.yogaclasses.following_classes %}
 {{ item.class_name }} - {{ item.date }} a las {{ item.time }}
{% endfor %}

{% for item in feed.mats_bestseller.products %}
 {{ item.name }} - {{ item.currency }}{{ item.price }}
{% endfor %}

else

Muestra un bloque de sustitución si una matriz está vacía.

{% for placeholder in array %}
     variable
{% else %}
     Añade aquí tu contenido de sustitución
{% endfor %}

{% for user in params.users %}
     {{ user.username }}
{% else %}
     No se ha encontrado ningún usuario
{% endfor %}

limit

Limita el bucle al número especificado de iteraciones.

{% for placeholder in array limit:# %}
     variable
{% endfor %}

{% for item in params.items limit:2 %}
     {{ item.name }}
{% endfor %}

reversed

Invierte el orden de impresión de los elementos de tu matriz.

{% for placeholder in array reversed %}
{% endfor %}

{% for country in params.countries reversed %}
{% endfor %}

Counter

Se establece un número entero que representa el recuento de iteraciones del bucle, comenzando por 1. Esto resulta útil, por ejemplo, para numerar elementos en un bucle.

{% for placeholder in array %}
     {{ forloop.Counter }}. variable
{% endfor %}

{% for product in params.products %}
     {{ forloop.Counter }}. {{ product.name }}
{% endfor %}

Counter0

Se establece en un número entero que representa el recuento de iteraciones del bucle, comenzando por 0. 

{% for placeholder in array %}
     {{ forloop.Counter0 }}. variable
{% endfor %}

{% for product in params.products %}
     {{ forloop.Counter0 }}. {{ product.name }}
{% endfor %}

Revcounter

Se establece en un número entero que representa la cantidad de elementos que quedan en el bucle. Comienza con el número total de elementos y disminuye hasta 1 en la iteración final.

{% for placeholder in array %}
     {{ forloop.Revcounter }}. variable
{% endfor %}

{% for product in params.products %}
     {{ forloop.Revcounter }}. {{ product.name }}
{% endfor %}

Revcounter0

Se establece en un número entero que representa la cantidad de elementos que quedan en el bucle. Comienza con el número total de elementos y disminuye a 0 en la iteración final.

{% for placeholder in array %}
     {{ forloop.Revcounter0 }}. variable
{% endfor %}

{% for product in params.products %}
     {{ forloop.Revcounter0 }}. {{ product.name }}
{% endfor %}

if

Muestra una lista de elementos basada en condiciones específicas.

{% for placeholder in array %}
     {% if condition}
         variable
     {% endif %}
{% endfor %}

{% for product in params.products %}
     {% if product.price > 50 %}
          {{ product.name }} - ${{ product.price }}
     {% endif %}
{% endfor %}

➡️ Para obtener más información sobre las declaraciones if, consulta nuestro artículo dedicado [Manual] Mostrar u ocultar contenido en tus emails mediante declaraciones if.

forloop.First

Un valor booleano establecido como True en la primera iteración del bucle. Esto resulta útil para gestionar el primer elemento de forma diferente, como aplicar el filtro "superior" solo al primer producto de una lista.

{% for placeholder in array %}
     {{ forloop.Counter }}. 
     {% if forloop.First %} 
          variable1
     {% else %}
          variable2
     {% endif %}
{% endfor %}

{% for product in params.products %}
     {{ forloop.Counter }}. 
     {% if forloop.First %}
          {{ product.name|upper }}
     {% else %}
          {{ product.name }}
     {% endif %}
{% endfor %}

forloop.Last

Un valor booleano establecido como True en la última iteración del bucle.  Esto resulta útil para gestionar el elemento final de forma diferente, como omitir una coma al final de una lista.

{% for placeholder in array %}
     variable{% if not forloop.Last %},{% endif %}
{% endfor %}

{% for product in params.products %}
     {{ product.name }}{% if not forloop.Last %},{% endif %}
{% endfor %}

forloop.Parentloop

Se refiere al objeto forloop del bucle principal en bucles anidados.

{% for placeholder in array %}
     Country #{{ forloop.Counter }}: variable
     {% for placeholder in array %}
          City #{{ forloop.Counter }}: variable
     {% endfor %}
{% endfor %}

{% for country in countries %}
     Country #{{ forloop.Counter }}: {{ country.name }}
     {% for city in country.city_list %}
          City #{{ forloop.Counter }}: {{ city }}
     {% endfor %}
{% endfor %}

⏭️ ¿Qué es lo siguiente?

• [Manual] Personalizar los mensajes con contenido dinámico (lenguaje de plantillas de Brevo)
• [Manual] Mostrar u ocultar contenido en tus emails mediante declaraciones if
• Modificar la salida de una variable mediante filtros

🤔 ¿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.