Voorwaardelijke inhoud in Liquid

Liquid kan een deel van een sjabloon alleen printen als iets waar is: een stempel ‘Betaald’ voor betaalde bestellingen, een cadeauboodschap als die er is, douanegegevens voor bestellingen die naar het buitenland gaan. Gebruik in de visuele editor in plaats daarvan het tabblad Zichtbaarheid van een blok (zie Een blok alleen voor sommige bestellingen tonen). Dit artikel gaat over codesjablonen, Aangepaste Liquid-blokken en de optie Liquid-voorwaarde van een blok.

if, elsif en 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 is het tegenovergestelde van 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 %}

Vergelijkingen

Operator	Betekenis	Voorbeeld
`==` / `!=`	is gelijk aan / is niet gelijk aan	`fulfillment_status == 'fulfilled'`
`>` `<` `>=` `<=`	groter / kleiner dan	`total_price >= 10000`
`contains`	een tekst bevat, of een lijst omvat	`tags contains 'Wholesale'`
`and` / `or`	voorwaarden combineren	`pickup_in_store? or shipping_lines.size == 0`
`blank`	leeg of ontbrekend	`note != blank`

Liquid leest and en or van rechts naar links en kent geen haakjes. Nest if-tags voor complexe regels.

Veelgebruikte voorbeelden

Alleen als de bestelling een notitie heeft:

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

Alleen voor bestellingen boven 100,00 (bedragen zijn in centen):

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

Alleen voor klanten met de tag VIP:

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

Alleen voor bestellingen die buiten de EU worden verzonden:

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

Alleen voor conceptbestellingen:

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

Liquid-voorwaarden op visuele blokken

De Liquid-voorwaarde van een blok is het deel dat binnen {% if … %} komt: één expressie, zonder tags. Bijvoorbeeld total_price >= 10000 and customer.tags contains 'VIP'. Foliant controleert de voorwaarde terwijl je typt, tegen de voorbeeldbestelling, en laat het je weten als Liquid hem niet kan lezen.

Goed om te weten

Tekstvergelijkingen zijn hoofdlettergevoelig: 'vip' komt niet overeen met 'VIP'. Tagvoorwaarden met bevatten de tekst in de visuele editor negeren hoofdletters.
financial_status en fulfillment_status zijn in kleine letters, met underscores: paid, partially_refunded, unfulfilled, partially_fulfilled.
Controleer voorwaarden met de Voorbeeldbestellingen en je eigen recente bestellingen in de bestellingskiezer van de voorvertoning. Zie Voorvertoning, papierformaat en zoom.

Welkom

Aan de slag

Afdrukken

Sjablonen

Sjablooneditor

Ontwerpen

PDF-levering

E-mailtemplates

Klantaccounts

Exports

Facturen en nummering

Belasting en juridisch

Integraties

Facturering en abonnementen

Instellingen

Problemen oplossen

Juridisch