Unterstützte Liquid-Syntax für Blöcke in Checkout Blocks

Checkout Blocks unterstützt eine Teilmenge der Liquid-Syntax, die du in verschiedenen der verfügbaren Blocktypen verwenden kannst, um deine Checkout-Anpassungen basierend auf Variablen zu personalisieren.

Unterstützte Liquid-Variablen

Die folgenden Listen enthalten alle unterstützten Liquid-Variablen, die in einem dynamischen Inhaltsblock oder einem Inhaltsblock für Positionen verwendet werden können. Einige Variablen sind nur auf bestimmten Seiten des Checkouts zugänglich und andere Variablen können nur in bestimmten Blocktypen verwendet werden.

Spezifische Informationen zu den einzelnen Variablen findest du in der Dokumentation zu Liquid-Objekten von Shopify.

Liquid-Variablen für den Checkout

Die folgenden Liquid-Variablen werden für den Checkout unterstützt:

• checkout.attributes
• checkout.currency
• checkout.has_selling_plan
• checkout.item_count
• checkout.line_items_subtotal_price
• checkout.locale
• checkout.market
• checkout.metafields
• checkout.note
• checkout.requires_shipping
• checkout.shipping_price
• checkout.tax_price
• checkout.total_price

Liquid-Variablen für Kund:innen

Die folgenden Liquid-Variablen werden für Kund:innen unterstützt:

• customer.id
• customer.b2b
• customer.full_name
• customer.first_name
• customer.last_name
• customer.email
• customer.phone

Liquid-Variablen für die Lokalisierung

Die folgenden Liquid-Variablen werden für Märkte unterstützt:

• localization.market
  • localization.market.id
  • localization.market.handle

Liquid-Variablen für Bestellungen

Die folgenden Liquid-Variablen werden für Bestellungen unterstützt:

• checkout.order.id
• checkout.order.legacyResourceId
• checkout.order.name

Liquid-Variablen für den Shop

Die folgenden Liquid-Variablen werden für Shop-Informationen unterstützt:

• shop.name
• shop.url

Liquid-Variablen für Positionen

Variablen für Positionen sind nur innerhalb eines Inhaltsblocks für Positionen zugänglich.

Die folgenden Liquid-Variablen werden für Positionen unterstützt:

• line_item.attributes
• line_item.gift_card
• line_item.has_selling_plan
• line_item.line_price
• line_item.line_level_discount_allocations
• line_item.line_level_total_discount
• line_item.options_with_values
• line_item.price
• line_item.product
  • line_item.product.is_gift_card
  • line_item.product.product_type
  • line_item.product.requires_selling_plan
  • line_item.product.tags
  • line_item.product.vendor
• line_item.quantity
• line_item.requires_shipping
• line_item.sku
• line_item.subtitle
• line_item.title
• line_item.trigger
• line_item.type
• line_item.variant
  • line_item.variant.available_for_sale
  • line_item.variant.barcode
  • line_item.variant.compare_at_price
  • line_item.variant.id
  • line_item.variant.price
    • line_item.variant.price.amount
    • line_item.variant.price.currency_code
  • line_item.variant.requires_shipping
  • line_item.variant.sku
  • line_item.variant.title
  • line_item.variant.unit_price
  • line_item.variant.weight
  • line_item.variant.weight_unit
• line_item.variant_id
• line_item.vendor

Beispiele für Snippets mit Liquid

Im Folgenden findest du einige Beispiele für Liquid-Snippets, die von Checkout Blocks unterstützt werden.

Prüfen, ob der Checkout B2B ist

Du kannst Inhalte nur dann anzeigen, wenn der Checkout B2B ist.

{%- if customer.b2b -%}
B2B
{%- endif -%}

JSON parsen

Du kannst JSON-Werte parsen, zum Beispiel aus Positionsattributen (Eigenschaften) oder Metafeldern.

{%- assign complex_json = checkout.metafields.checkoutblocks.complex | json -%}

Währung formatieren

Checkout Blocks unterstützt Checkouts mit mehreren Währungen vollständig. Verwende einfach den Geld-Filter, um Geldbeträge im Format der aktiven Währung zu parsen und zu formatieren. Die Währung wird dadurch nicht automatisch umgewandelt.

{{ checkout.total_price | money }}

Warenkorbanmerkung

Du kannst den Wert der Warenkorbanmerkung anzeigen, z. B. was im Warenkorb eingegeben wurde.

{{ checkout.note }}

Warenkorbattribute

Mit diesem Snippet kannst du den Wert eines bestimmten Warenkorbattributs anzeigen, z. B. ein Lieferdatum. Achte darauf, den Schlüssel Delivery date so zu ändern, dass er deinem eigenen entspricht.

{% assign delivery_date = '' %}
{% for attribute in checkout.attributes %}
  {% if attribute.key == 'Delivery date' %}
    {% assign delivery_date = attribute.value %}
  {% endif %}
{% endfor %}

Delivery Date: {{ delivery_date }}

Gesamten Liquid-Inhalt des Checkouts anzeigen

Wenn du überprüfen musst, welche Werte im Checkout-Objekt vorhanden sind, kannst du den JSON-Filter zur Serialisierung verwenden. Dies sollte nur zu Debugging-Zwecken verwendet werden.

{{ checkout | json }}

Checkout-Metafelder

Du kannst benutzerdefinierte Felder, die im Checkout gespeichert sind, auf der Dankesseite und der Bestellstatus-Seite anzeigen, indem du auf die Checkout-Metafelder verweist. Mehr Informationen über den Zugriff auf Metafelder.

Ersetze your-namespace durch deinen Namespace und your-custom-field-key durch den Schlüssel deines benutzerdefinierten Feldes, wie im Block definiert:

{{ checkout.metafields.your-namespace.your-custom-field-key.value }}

Datum formatieren

In diesem Beispiel erstellen wir ein Datum, das 4 Tage in der Zukunft liegt (432.000 Sekunden), und formatieren es dann.

Du kannst das Datum im Format „02/24/2025“ zurückgeben:

{% assign future_date = "now" | date: "%s" | plus: 432000 %}
{{ future_date | date: "%m/%d/%Y" }}

Alternativ kannst du das Datum als „Feb 24, 2025“ formatieren:

{% assign future_date = "now" | date: "%s" | plus: 432000 %}
{{ future_date | date: "%b %d, %Y" }}

Mehr Informationen zur Formatierung von Datumsangaben in Liquid.

Anpassungen von Positionsinhalten

Im Folgenden findest du einige Beispiele für Liquid-Snippets, die du in Inhaltsblöcken für Positionen verwenden kannst.

Vergleichspreis bedingt anzeigen

Mit diesem Snippet kannst du den Vergleichspreis einer Position bedingt anzeigen.

{%- if line_item.variant.compare_at_price.amount -%}
On sale. Originally {{ line_item.variant.compare_at_price.amount | times: line_item.quantity | money }}
{%- endif -%}

Inhalte basierend auf Produkt-Tags anzeigen

Du kannst Inhalte von Positionen basierend auf den Produkt-Tags bedingt anzeigen. Dabei muss die Groß- und Kleinschreibung beachtet werden.

{%- if line_item.product.tags contains 'final-sale' -%}
Final sale
{%- endif -%}

Positionsattribute (Eigenschaften)

Du kannst Positionsattribute, auch als Positionseigenschaften bekannt, durchlaufen und Informationen wie z. B. Lieferschätzungen, Vorabbestellungen und mehr anzeigen.

{%- assign first_line_attribute = line_item.attributes | first  -%}
{%- assign first_attribute_value =  first_line_attribute.value | json_parse  -%}
{%- assign message =  first_attribute_value.message -%}
{%- if message -%}
  {{ message }}
{%- endif -%}

Den Wert des „Metafeld-Triggers“ anzeigen

Der folgende Code enthält den Wert des Triggers.

{{ line_item.trigger }}

Wiederkehrende Gesamtsumme für eine Position anzeigen

Wenn du die wiederkehrende Gesamtsumme für eine Abonnement-Position vor einmaligen Rabatten anzeigen musst, kannst du den line_level_total_discount Wert verwenden.

{%- if line_item.line_level_total_discount > 0 and line_item.has_selling_plan -%}
Recurring total: {{ line_item.line_price | plus: line_item.line_level_total_discount | money }}
{%- endif -%}