Referencia lógica condicional para plantilla

Objetivos del artículo

Conoce todas las condiciones disponibles que puedes utilizar para mostrar dinámicamente un bloque, sección o contenido personalizado sólo a determinados destinatarios. Para aprender a utilizar estas condiciones en tu plantilla, dirígete a nuestro artículo sobre cómo mostrar u ocultar la plantilla bloque en función de variables dinámicas. 

Aprende a utilizar la lógica condicional:

• Dónde puedes utilizar las condiciones
• Consejos para el éxito
• Estructuras de estado
• Construye condiciones complejas

Dónde puedes utilizar las condiciones

Puedes utilizar condiciones en: 

• Correos electrónicos
  • Crea una lógica de mostrar/ocultar para mostrar dinámicamente bloques o secciones sólo a determinadas personas. 
    • Si prefieres no escribir código, utiliza en su lugar el constructor lógico de mostrar/ocultar. 
  • Escribe condicionales if/else para crear sentencias Django personalizadas.
• Customer Hub
  • Escribe condicionales if/else para crear sentencias Django personalizadas en el bloque de contenido

Consejos para el éxito

Cuando crees 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 tu perfil o evento. 

Además, asegúrate de tener en cuenta a todos los posibles espectadores. Por ejemplo, si muestras un bloque específico sólo a los residentes de un determinado estado, cubre todas las grafías posibles del nombre de ese estado (por ejemplo, Massachusetts, massachusetts, mass, MA). Ten en cuenta también el perfil que puede no tener la propiedad fijada en absoluto.

Una vez que hayas construido el mensaje y aplicado tus condiciones, haz una vista previa utilizando diversos perfiles para confirmar que el mensaje se muestra como pretendías en todos los escenarios. 

Estructuras de estado

Las condiciones deben incluir de 1 a 3 elementos, dependiendo de tu objetivo para el bloque y de los datos que estés utilizando. La condición debe incluir al menos una variable (por ejemplo, persona|lookup:'Color favorito'). También puede incluir una función de comparación, como = (igual) o > (mayor que) y un valor, que especifica el valor de una propiedad que hay que buscar. Además, algunas condiciones empiezan por no, si quieres que el bloque sólo aparezca para los perfiles que no cumplan una condición. 

El cuadro siguiente contiene una lista completa de las posibles estructuras que puede seguir una condición mostrar/ocultar. 

Condiciones para los booleanos

Si haces referencia al almacenamiento de datos como un booleano, tendrás que utilizar 1 y 0 en lugar de "verdadero" y "falso" en la definición de tu condición de mostrar/ocultar. No encierres el 1 o el 0 entre comillas. Utiliza las condiciones de ejemplo que aparecen a continuación como plantilla.

Condiciones para booleanos tienda, comercio como texto

Si tus datos verdadero/falso son tienda, comercio como texto, no como booleano, utiliza las condiciones de ejemplo para propiedades de texto anteriores. Si no estás seguro, o si haces referencia a una propiedad que contiene tanto booleanos como texto, puedes utilizar estas estructuras para cubrir todos los escenarios. Incluye todas las grafías y mayúsculas presentes en tus datos. 

Construye condiciones complejas

Si quieres que tu bloque se muestre a personas que cumplan varios criterios, o si tienes un caso de uso complejo, puedes utilizar varias condiciones de mostrar/ocultar para un bloque. Para ello, conecta una serie de condiciones con Y u O. Por ejemplo, si quieres mostrar un bloque a cualquier persona de Massachusetts, pero Massachusetts se escribe de forma diferente en algunos perfiles, puedes utilizar una condición como ésta: 

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

Si sólo quieres mostrar un bloque a las personas cuyo color favorito es el verde, y que además son VIP, puedes utilizar una condición como ésta: 

persona|lookup:'Color Favorito' == 'verde' y persona|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 las sentencias condicionales, abre el campo Código fuente del bloque de texto. 

Las siguientes etiquetas solo son visibles en el campo Código fuente de un bloque de texto: 

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

Recursos adicionales

• Cómo mostrar u ocultar la plantilla bloque en función de variables dinámicas
• Referencia de personalización del mensaje 
• Guía de perfil en Klaviyo 
• Glosario de filtros variables