Conteúdo condicional em Liquid

O Liquid pode imprimir uma parte do modelo só quando algo é verdadeiro: um carimbo “Pago” para pedidos pagos, uma mensagem de presente quando houver uma, dados alfandegários para pedidos enviados ao exterior. No editor visual, use a aba Visibilidade de um bloco (consulte Mostrar um bloco só para alguns pedidos). Este artigo é para modelos em código, blocos de Liquid personalizado e a 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`	combinam condições	`pickup_in_store? or shipping_lines.size == 0`
`blank`	vazio ou ausente	`note != blank`

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

Exemplos comuns

Só quando o pedido tem uma observação:

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

Só para pedidos acima de 100,00 (os valores estão em centavos):

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

Só para clientes com a tag VIP:

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

Só para pedidos enviados para fora da UE:

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

Só para pedidos 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 tags. Por exemplo, total_price >= 10000 and customer.tags contains 'VIP'. O Foliant verifica a condição enquanto você digita, usando o pedido de exemplo, e avisa se o Liquid não conseguir lê-la.

Bom saber

As comparações de texto diferenciam maiúsculas de minúsculas: 'vip' não corresponde a 'VIP'. As condições de tag do editor visual com contêm o texto ignoram maiúsculas e minúsculas.
financial_status e fulfillment_status ficam em minúsculas, com sublinhados: paid, partially_refunded, unfulfilled, partially_fulfilled.
Teste as condições com os Pedidos de exemplo e com seus próprios pedidos recentes no seletor de pedidos 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 PDFs

Modelos de e-mail

Contas de clientes

Exportações

Faturas e numeração

Impostos e jurídico

Integrações

Cobrança e planos

Configurações

Solução de problemas

Jurídico