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

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

Auf dieser Seite

Unterstützte Liquid-Variablen

Die folgenden Listen enthalten alle unterstützten Liquid-Variablen, die in einem Block mit dynamischem Inhalt oder einem Block mit Positionsinhalt verwendet werden können. Einige Variablen sind nur auf bestimmten Seiten des Checkouts verfügbar, einige andere Variablen können nur in bestimmten Blocktypen enthalten sein.

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

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 Kunden

Die folgenden Liquid-Variablen werden für Kunden 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 die Position

Positionsvariablen können nur innerhalb eines Blocks mit Positionsinhalt verwendet werden.

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

Hier findest du einige Beispiel-Liquid-Snippets, die von Checkout Blocks unterstützt werden.

Überprüfen, ob der Checkout B2B ist

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

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

JSON analysieren

Du kannst JSON-Werte analysieren, z. B. aus Positionsattributen (Eigenschaften) oder Metafeldern.

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

Währung formatieren

Checkout Blocks unterstützt vollständig den Checkout mit mehreren Währungen. Übergehe einfach den Geldfilter, um Geld mit dem aktiven Währungsformat zu analysieren und zu formatieren. Die Währung wird dadurch nicht automatisch umgerechnet.

{{ checkout.total_price | money }}

Warenkorbanmerkung

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

{{ checkout.note }}

Warenkorbattribute

Um den Wert eines bestimmten Warenkorbattributs, z. B. eines Lieferdatums, anzuzeigen, kannst du dieses Snippet verwenden. Stelle sicher, den Schlüssel Lieferdatum zu ändern, damit er mit deinem eigenen Darum übereinstimmt.

{% 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 Checkout-Liquid-Inhalt anzeigen

Wenn du überprüfen musst, welche Werte im Checkout-Objekt vorhanden sind, kannst du JSON-Filter zum Serialisieren verwenden. Diese Funktion sollte nur zum Debuggen verwendet werden.

{{ checkout | json }}

Checkout-Metafelder

Du kannst benutzerdefinierte Felder, die im Checkout gespeichert sind, auf den Danke- und Bestellstatus-Seiten anzeigen, indem du auf die Checkout-Metafelder verweist. Erfahre mehr über den Zugriff auf Metafelder.

Ersetze your-namespace mit deinem Namensraum und your-custom-field-key mit deinem Schlüssel für das benutzerdefinierte Feld, so wie er im Block definiert ist:

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

Datum formatieren

In diesem Beispiel erstellen wir ein Datum mit 4 Tagen in der Zukunft (432 000 Sekunden) und formatieren es anschließend.

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 "Februar 24, 2025" formatieren:

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

Erfahre mehr über das Formatieren von Daten in Liquid.

Positionsinhaltsanpassungen

Im Folgenden findest du einige Beispiel-Liquid-Snippets, die du für Blöcke mit Positionsinhalt verwenden kannst.

Vergleichspreis bedingt anzeigen

Du kannst mit diesem Snippet unter bestimmten Bedingungen den Vergleichspreis einer Position 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 -%}

Inhalt basierend auf Produkt-Tags anzeigen

Du kannst Positionsinhalt unter bestimmten Bedingungen basierend auf den Produkt-Tags anzeigen, bei denen die Groß- und Kleinschreibung berücksichtigt wird.

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

Positionsattribute (Eigenschaften)

Du kannst über Positionsattribute, die auch als Positionseigenschaften bezeichnet werden, iterieren und Informationen wie z. B. Angaben zur Lieferung, zu Vorbestellungen 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 -%}

Wert für "Metafeld-Trigger" 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 Abonnementposition vor einmaligen Rabatten anzeigen musst, kannst du den Wert line_level_total_discount 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 -%}