Referencia de lógica condicional para plantillas

Objetivos del artículo

Conoce todas las condiciones disponibles que puedes usar para mostrar de forma dinámica un bloque, una sección o una parte de contenido con código personalizado solo a ciertos destinatarios. Para aprender a usar estas condiciones en las plantillas, consulta nuestro artículo sobre cómo mostrar u ocultar bloques de plantillas según variables dinámicas.

Descubre cómo usar la lógica condicional:

• Dónde puedes usar condiciones
• Consejos para el éxito
• Estructuras de condiciones
• Crea condiciones complejas

Dónde puedes usar condiciones

Puedes usar condiciones en:

• Correos electrónicos
  • Crea lógica de mostrar/ocultar para mostrar bloques o secciones de forma dinámica solo a ciertas personas.
    • Si prefieres no escribir código, usa el generador de lógica de mostrar/ocultar en su lugar.
  • Escribe condicionales if/else para crear declaraciones personalizadas de Django.
• Klaviyo Customer Hub
  • Escribe condicionales if/else para crear sentencias personalizadas de Django en bloques de contenido

Consejos para el éxito

Al crear las condiciones de mostrar/ocultar, presta atención a los detalles. Las condiciones de mostrar/ocultar distinguen entre mayúsculas y minúsculas, y la ortografía debe coincidir exactamente con los datos de perfil o de evento.

Además, asegúrate de considerar a todos los posibles espectadores. Por ejemplo, si muestras un bloque específico solo a residentes de un estado en particular, incluye todas las posibles formas de escribir el nombre de ese estado (p. ej., Massachusetts, massachusetts, mass, MA). También toma en cuenta los perfiles que quizá no tengan configurada la propiedad.

Una vez que hayas creado el mensaje y aplicado las condiciones, previsualízalo con una variedad de perfiles para confirmar que el mensaje se muestre como lo planeaste en todos los escenarios.

Estructuras de condiciones

Las condiciones deben incluir de 1 a 3 elementos, según el objetivo del bloque y los datos que estés usando. La condición debe incluir al menos una variable (p. ej., person|lookup:'Favorite Color'). También puede incluir una función de comparación, como = (igual a) o > (mayor que), y un valor, que especifica un valor de propiedad que se debe buscar. Además, ciertas condiciones empiezan con not, si quieres que el bloque solo aparezca para perfiles que no cumplan una condición.

La siguiente gráfica contiene una lista completa de las posibles estructuras que puede seguir una condición de mostrar/ocultar.

Condiciones para booleanos

Si haces referencia a almacenamiento de datos almacenados como un valor booleano, tendrás que usar 1 y 0 en lugar de “true” y “false” en la definición de la condición de mostrar/ocultar. No pongas el 1 o el 0 entre comillas. Usa las condiciones de ejemplo de abajo como plantilla.

Condiciones para valores booleanos almacenados como texto

Si tus datos de verdadero/falso se almacenan como texto, no como un booleano, usa las condiciones de ejemplo para propiedades de texto de arriba. Si no estás seguro o si estás haciendo referencia a una propiedad que contiene booleanos y texto, puedes usar estas estructuras para abarcar todos los escenarios. Incluye todas las grafías y mayúsculas que estén presentes en los datos.

Crea condiciones complejas

Si quieres que el bloque se muestre a personas que cumplan varios criterios o si tienes un caso de uso complejo, puedes usar varias condiciones para mostrar/ocultar en un mismo bloque. Para hacerlo, conecta una serie de condiciones con AND u OR. Por ejemplo, si quieres mostrar un bloque a cualquier persona en Massachusetts, pero Massachusetts se escribe de forma diferente en algunos perfiles, puedes usar una condición como esta:

person.location.region == 'Massachusetts' or person.location.region == 'massachusetts' or person.location.region == 'mass' or person.location.region == 'MA'

Si solo quieres mostrar un bloque a las personas cuyo color favorito es el verde y que también son VIP, puedes usar una condición como esta:

person|lookup:'Favorite Color' == 'green' and person|lookup:'VIP'== 1

Declaraciones condicionales y editor de texto integrado

Cuando añadas determinadas declaraciones condicionales a un bloque de texto, es posible que desaparezcan del editor de texto integrado. El código seguirá estando allí, pero oculto. Para ver y editar declaraciones condicionales, usa el generador de etiquetas de Django o mueve el contenido a un bloque de HTML dedicado para editar el código directamente.

Las siguientes etiquetas no aparecen en el editor de texto en línea, pero permanecen en el bloque de texto:

• {% for ... %}
• {% endfor %}
• {% if ... %}
• {% elif ... %}
• {% else %}
• {% endif %}
• {% with ... %}
• {% endwith %}

Recursos adicionales