Ondersteunde Liquid-syntaxis voor blokken in Checkout Blocks

Checkout Blocks ondersteunt een subset Liquid-syntaxis die je in verschillende beschikbare bloktypen kunt gebruiken om checkoutaanpassingen te personaliseren op basis van variabelen.

Ondersteunde Liquid-variabelen

De volgende lijsten bevatten alle ondersteunde Liquid-variabelen die je kunt gebruiken in een blok Dynamische content of Orderregelcontent. Sommige variabelen zijn alleen toegankelijk op bepaalde checkoutpagina's en andere variabelen kunnen alleen in specifieke bloktypen worden opgenomen.

Zie de documentatie bij Liquid-objecten voor meer informatie.

Liquid-variabelen voor de checkout

De volgende Liquid-variabelen worden ondersteund voor de checkout:

• 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-variabelen voor klanten

De volgende Liquid-variabelen worden voor klanten ondersteund:

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

Liquid-variabelen voor lokalisatie

De volgende Liquid-variabelen worden voor markten ondersteund:

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

Liquid-variabelen voor bestellingen

Opmerking

Variabelen voor bestellingen zijn alleen toegankelijk via de bestelstatuspagina.

De volgende Liquid-variabelen worden voor bestellingen ondersteund:

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

Liquid-variabelen voor winkels

De volgende Liquid-variabelen worden ondersteund voor winkelgegevens:

• shop.name
• shop.url

Liquid-variabelen voor orderregels

Abonnementvereiste

Creating a line item content block is alleen beschikbaar voor merchants met een Shopify Plus-abonnement.

Variabelen voor orderregels zijn alleen toegankelijk binnen een blok voor orderregelcontent.

De volgende Liquid-variabelen worden ondersteund voor orderregels:

• 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

Voorbeelden van fragmenten met Liquid

Hieronder volgen enkele voorbeelden van Liquid-fragmenten die worden ondersteund door Checkout Blocks.

Controleren of checkout B2B is

Je kunt content alleen weergeven wanneer de checkout B2B is.

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

JSON parseren

Je kunt JSON-waarden parseren, zoals uit kenmerken (eigenschappen) van orderregels of metavelden.

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

Valutanotatie

Checkout Blocks biedt volledige ondersteuning voor checkout met meerdere valuta's. Geef het geldfilter door om geld te parseren en in de actieve valutanotatie weer te geven. De valuta wordt hiermee niet automatisch omgerekend.

{{ checkout.total_price | money }}

Notitie voor winkelwagen

Je kunt de waarde van de notitie voor winkelwagen weergeven, bijvoorbeeld wat in de winkelwagen is ingevoerd.

{{ checkout.note }}

Winkelwagenattributen

Als je de waarde van een bepaald winkelwagenkenmerk wil weergeven, zoals een bezorgdatum, kun je dit fragment gebruiken. Vergeet niet de Bezorgdatum van de sleutel overeen te laten komen met die van jou.

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

Delivery Date: {{ delivery_date }}

Volledige Liquid-content van checkout weergeven

Als je wilt controleren welke waarden er in het checkout-object staan, kun je het JSON-filter gebruiken om te serialiseren. Gebruik dit alleen voor debuggen.

{{ checkout | json }}

Checkout-metavelden

Je kunt aangepaste velden weergeven die bij de checkout zijn opgeslagen op de bedankt- en bestelstatuspagina door te verwijzen naar de checkout-metavelden. Hier vind je meer informatie over toegang tot metavelden.

Vervang your-namespace door je naamruimte en your-custom-field-key door je aangepaste veldsleutel zoals gedefinieerd in het blok:

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

Datumindeling

In dit voorbeeld maken we een datum die vier dagen in de toekomst ligt (432.000 seconden) en delen we deze in.

Je kunt de datum retourneren die als volgt is ingedeeld: '02/24/2025':

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

Je kunt de datum ook als volgt indelen: '24 februari 2025':

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

Lees meer over datumindeling in Liquid.

Aanpassingen van orderregelcontent

Abonnementvereiste

Creating a line item content block is alleen beschikbaar voor merchants met een Shopify Plus-abonnement.

Hieronder volgen enkele voorbeelden van Liquid-fragmenten die je kunt gebruiken in blokken voor orderregelcontent.

Onder voorwaarden de vergelijkingsprijs weergeven

Met dit fragment kun je onder voorwaarden de vergelijkingsprijs van een orderregel weergeven.

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

Content weergeven op basis van producttags

Je kunt orderregelcontent onder voorwaarden weergeven op basis van producttags. Deze zijn hoofdlettergevoelig.

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

Orderregelkenmerken (eigenschappen)

Je kunt iteraties uitvoeren over orderregelkenmerken, ook wel orderregeleigenschappen genoemd, en gegevens weergeven als inschatting van levertijden, pre-orders, en nog veel meer.

{%- 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 -%}

De waarde van de 'metaveldtrigger' weergeven

De volgende code bevat de waarde van de trigger.

{{ line_item.trigger }}

Terugkerend totaal voor een orderregel weergeven

Als je het terugkerende totaal voor een orderregel van een abonnement wil laten zien exclusief eenmalige kortingen, kun je de waarde line_level_total_discount gebruiken.

{%- 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 -%}