Conteúdo condicional em Liquid

O Liquid pode imprimir parte de um modelo apenas quando algo é verdadeiro: um carimbo “Pago” para encomendas pagas, uma mensagem de oferta quando existe, dados aduaneiros para encomendas enviadas para o estrangeiro. No editor visual, use antes o separador Visibilidade de um bloco (consulte Mostrar um bloco apenas para algumas encomendas); este artigo destina-se a modelos em código, blocos Liquid personalizado e à opção Condição Liquid de um bloco.

if, elsif e else

{% if financial_status == 'paid' %}
  <p class="stamp">PAID</p>
{% elsif financial_status == 'partially_paid' %}
  <p>Partly paid. {{ 'total_due' | t }}: {{ total_price | minus: total_paid | money }}</p>
{% else %}
  <p>Payment pending</p>
{% endif %}

unless

unless é o oposto de if:

{% unless customer.tax_exempt %}
  {% include 'vat_breakdown' %}
{% endunless %}

case

{% case shipping_address.country_code %}
  {% when 'US', 'CA' %}
    <p>Ships within North America</p>
  {% when 'GB' %}
    <p>Ships within the UK</p>
  {% else %}
    <p>International shipment</p>
{% endcase %}

Comparações

Operador	Significado	Exemplo
`==` / `!=`	igual a / diferente de	`fulfillment_status == 'fulfilled'`
`>` `<` `>=` `<=`	maior / menor que	`total_price >= 10000`
`contains`	um texto contém, ou uma lista inclui	`tags contains 'Wholesale'`
`and` / `or`	combinar condições	`pickup_in_store? or shipping_lines.size == 0`
`blank`	vazio ou em falta	`note != blank`

O Liquid lê and e or da direita para a esquerda e não tem parênteses. Para regras complexas, aninhe etiquetas if.

Exemplos comuns

Apenas quando a encomenda tem uma nota:

{% if note != blank %}<p>{{ note | escape }}</p>{% endif %}

Apenas para encomendas acima de 100,00 (os valores estão em cêntimos):

{% if total_price >= 10000 %}<p>Free gift included</p>{% endif %}

Apenas para clientes com a etiqueta VIP:

{% if customer.tags contains 'VIP' %}<p>Thank you for being a VIP!</p>{% endif %}

Apenas para encomendas enviadas para fora da UE:

{% unless shipping_address.member_of_eu %}…customs details…{% endunless %}

Apenas para encomendas preliminares:

{% if is_draft_order? %}…{% endif %}

Condições Liquid em blocos visuais

A Condição Liquid de um bloco é a parte que fica dentro de {% if … %}: uma única expressão, sem etiquetas. Por exemplo, total_price >= 10000 and customer.tags contains 'VIP'. O Foliant verifica-a à medida que escreve, com base na encomenda de exemplo, e avisa-o se o Liquid não a conseguir ler.

Bom saber

As comparações de texto distinguem maiúsculas de minúsculas: 'vip' não corresponde a 'VIP'. As condições de etiqueta do editor visual com contêm o texto ignoram maiúsculas e minúsculas.
financial_status e fulfillment_status estão em minúsculas, com underscores: paid, partially_refunded, unfulfilled, partially_fulfilled.
Verifique as condições com as Encomendas de exemplo e com as suas encomendas recentes no seletor de encomendas da pré-visualização. Consulte Pré-visualização, tamanho do papel e zoom.

Boas-vindas

Primeiros passos

Impressão

Modelos

Editor de modelos

Designs

Envio de PDF

Modelos de email

Contas de cliente

Exportações

Faturas e numeração

Impostos e jurídico

Integrações

Faturação e planos

Definições

Resolução de problemas

Jurídico