Referência de lógica condicional para modelos

O que você vai aprender

Saiba mais sobre todas as condições disponíveis que você pode usar para exibir dinamicamente um bloco, uma seção ou um conteúdo com código personalizado apenas para determinados destinatários. Para saber como usar essas condições nos seus modelos, acesse nosso artigo sobre como mostrar ou ocultar blocos do modelo com base em variáveis dinâmicas.

Saiba como usar a lógica condicional:

• Onde você pode usar condições
• Dicas para ter sucesso
• Estruturas de condições
• Crie condições complexas

Onde você pode usar condições

Você pode usar condições em:

• E-mails
  • Crie lógica de mostrar/ocultar para exibir blocos ou seções dinamicamente apenas para determinadas pessoas.
    • Se você preferir não escrever código, use o construtor de lógica de mostrar/ocultar.
  • Escreva condicionais if/else para criar instruções personalizadas do Django.
• Customer Hub
  • Escreva condicionais if/else para criar instruções personalizadas do Django em blocos de conteúdo

Dicas para ter sucesso

Ao criar condições de mostrar/ocultar, preste atenção aos detalhes. As condições de mostrar/ocultar diferenciam maiúsculas de minúsculas, e a grafia deve corresponder exatamente aos dados de perfil ou de evento.

Além disso, não se esqueça de considerar todos os possíveis visualizadores. Por exemplo, se você mostrar um bloco específico apenas para residentes de um determinado estado, cubra todas as possíveis grafias do nome desse estado (por exemplo, Massachusetts, massachusetts, mass, MA). Considere também perfis que talvez não tenham a propriedade definida.

Depois de criar a mensagem e aplicar suas condições, visualize a prévia usando vários perfis para confirmar que a mensagem é exibida como você planejou em todos os cenários.

Estruturas de condições

As condições devem incluir de 1 a 3 elementos, dependendo do seu objetivo para o bloco e dos dados que você está usando. A condição deve incluir pelo menos uma variável (por exemplo, person|lookup:'Favorite Color'). Ela também pode incluir uma função de comparação, como = (igual a) ou > (maior que), e um valor, que especifica um valor de propriedade a ser procurado. Além disso, algumas condições começam com not, se você quiser que o bloco apareça apenas para perfis que não atendem a uma condição.

O gráfico abaixo contém uma lista completa de possíveis estruturas que uma condição de mostrar/ocultar pode seguir.

Condições para booleanos

Se você estiver usando dados armazenados como booleano, vai precisar usar 1 e 0, em vez de "true" e "false", na definição da condição de mostrar/ocultar. Não coloque o 1 ou o 0 entre aspas. Use as condições de exemplo abaixo como modelo.

Condições para booleanos armazenados como texto

Se seus dados verdadeiro/falso estiverem armazenados como texto, não como um booleano, use as condições de exemplo para propriedades de texto acima. Se você não tiver certeza ou estiver fazendo referência a uma propriedade que contém tanto booleanos quanto texto, você pode usar essas estruturas para abranger todos os cenários. Inclua todas as grafias e capitalizações que estão presentes nos seus dados.

Crie condições complexas

Se você quiser que seu bloco seja exibido para pessoas que atendam a vários critérios ou se você tiver um caso de uso complexo, você pode usar várias condições de mostrar/ocultar para um bloco. Para fazer isso, conecte uma série de condições com AND ou OR. Por exemplo, se você quiser exibir um bloco para qualquer pessoa em Massachusetts, mas Massachusetts estiver escrito de forma diferente em alguns perfis, você pode usar uma condição como esta:

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

Se você só quiser mostrar um bloco para pessoas cuja cor favorita é verde e que também são VIPs, você pode usar uma condição como esta:

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

Declarações condicionais e editor de texto integrado

Quando você adiciona instruções condicionais a um bloco de texto, elas podem desaparecer do editor de texto integrado. O código ainda está presente, porém oculto. Para ver e editar declarações condicionais, use o Construtor de tags do Django ou mova o conteúdo para um bloco de HTML dedicado para edição direta do código.

As seguintes tags não aparecem no editor de texto em linha, mas continuam no bloco de texto:

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

Recursos adicionais