Bedingte Inhalte in Liquid

Liquid kann einen Teil einer Vorlage nur dann drucken, wenn etwas zutrifft: einen „Bezahlt“-Stempel für bezahlte Bestellungen, eine Geschenknachricht, wenn es eine gibt, Zollangaben für Bestellungen, die ins Ausland gehen. Im visuellen Editor verwenden Sie stattdessen den Tab Sichtbarkeit eines Blocks (siehe Einen Block nur für bestimmte Bestellungen anzeigen). Dieser Artikel gilt für Code-Vorlagen, Blöcke vom Typ Benutzerdefiniertes Liquid und die Option Liquid-Bedingung eines Blocks.

if, elsif und 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 ist das Gegenteil von 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 %}

Vergleiche

Operator	Bedeutung	Beispiel
`==` / `!=`	ist gleich / ist ungleich	`fulfillment_status == 'fulfilled'`
`>` `<` `>=` `<=`	größer / kleiner als	`total_price >= 10000`
`contains`	ein Text enthält etwas oder eine Liste enthält ein Element	`tags contains 'Wholesale'`
`and` / `or`	Bedingungen kombinieren	`pickup_in_store? or shipping_lines.size == 0`
`blank`	leer oder fehlend	`note != blank`

Liquid liest and und or von rechts nach links und kennt keine Klammern. Verschachteln Sie für komplexe Regeln if-Tags.

Häufige Beispiele

Nur wenn die Bestellung eine Notiz hat:

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

Nur für Bestellungen über 100,00 (Beträge sind in Cent angegeben):

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

Nur für Kunden mit dem Tag VIP:

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

Nur für Bestellungen, die außerhalb der EU versendet werden:

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

Nur für Bestellentwürfe:

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

Liquid-Bedingungen in visuellen Blöcken

Die Liquid-Bedingung eines Blocks ist der Teil, der in {% if … %} steht: ein einzelner Ausdruck, ohne Tags. Zum Beispiel total_price >= 10000 and customer.tags contains 'VIP'. Foliant prüft ihn bereits während der Eingabe anhand der Beispielbestellung und meldet Ihnen, wenn Liquid ihn nicht lesen kann.

Gut zu wissen

Textvergleiche unterscheiden zwischen Groß- und Kleinschreibung: 'vip' passt nicht zu 'VIP'. Die Tag-Bedingungen des visuellen Editors mit enthalten den Text ignorieren die Groß- und Kleinschreibung.
financial_status und fulfillment_status werden kleingeschrieben, mit Unterstrichen: paid, partially_refunded, unfulfilled, partially_fulfilled.
Prüfen Sie Bedingungen mit den Beispielbestellungen und Ihren eigenen aktuellen Bestellungen in der Bestellauswahl der Vorschau. Siehe Vorschau, Papierformat und Zoom.

Willkommen

Erste Schritte

Drucken

Vorlagen

Vorlagen-Editor

Designs

PDF-Versand

E-Mail-Vorlagen

Kundenkonten

Exporte

Rechnungen und Nummerierung

Steuern und Recht

Integrationen

Abrechnung und Tarife

Einstellungen

Fehlerbehebung

Rechtliches