Ondersteunde Liquid-syntaxis voor blokken in Checkout Blocks

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

Ondersteunde Liquid-variabelen

De volgende lijsten bevatten alle ondersteunde Liquid-variabelen die kunnen worden gebruikt in een Dynamisch contentblok of een Orderregelcontentblok. Sommige variabelen zijn alleen toegankelijk op bepaalde pagina's van de checkout en andere variabelen kunnen alleen in specifieke bloktypen worden opgenomen.

Raadpleeg de Liquid-objectdocumentatie van Shopify voor de specifieke kenmerken van elke variabele.

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 ondersteund voor klanten:

• 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 ondersteund voor markten:

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

Liquid-variabelen voor bestellingen

De volgende Liquid-variabelen worden ondersteund voor bestellingen:

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

Liquid-variabelen voor de winkel

De volgende Liquid-variabelen worden ondersteund voor winkelinformatie:

• shop.name
• shop.url

Liquid-variabelen voor orderregels

Orderregelvariabelen zijn alleen toegankelijk binnen een contentblok voor orderregels.

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 Liquid-fragmenten

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

Controleren of de checkout B2B is

Je kunt content alleen weergeven wanneer de checkout B2B is.

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

JSON parsen

Je kunt JSON-waarden parsen, zoals die van orderregelattributen (eigenschappen) of metavelden.

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

Valuta opmaken

Checkout Blocks biedt volledige ondersteuning voor checkouts in meerdere valuta's. Gebruik het geldfilter om geld te parsen en op te maken met de actieve valutaopmaak. De valuta wordt hiermee niet automatisch omgezet.

{{ checkout.total_price | money }}

Notitie voor winkelwagen

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

{{ checkout.note }}

Winkelwagenattributen

Om de waarde van een bepaald winkelwagenattribuut, zoals een leverdatum, weer te geven, kun je dit fragment gebruiken. Zorg ervoor dat je de sleutel Delivery date wijzigt in je eigen sleutel.

{% 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 bestaan, kun je het JSON-filter gebruiken om te serialiseren. Dit mag alleen worden gebruikt voor foutopsporing.

{{ checkout | json }}

Checkout-metavelden

Je kunt aangepaste velden die in de checkout zijn opgeslagen, weergeven op de bedankpagina en de bestelstatuspagina door te verwijzen naar de checkout-metavelden. Meer informatie over toegang tot metavelden.

Vervang your-namespace door je naamruimte en your-custom-field-key door de sleutel van je aangepaste veld, zoals gedefinieerd in het blok:

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

Een datum opmaken

In dit voorbeeld maken we een datum aan die 4 dagen in de toekomst ligt (432.000 seconden) en maken deze vervolgens op.

Je kunt de datum retourneren, opgemaakt als ‘02/24/2025’:

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

Je kunt de datum ook opmaken als ‘Feb 24, 2025’:

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

Meer informatie over datums opmaken in Liquid.

Contentaanpassingen voor orderregels

Hieronder volgen enkele voorbeelden van Liquid-fragmenten die je kunt gebruiken in contentblokken voor orderregels.

De vergelijkingsprijs voorwaardelijk weergeven

Met dit fragment kun je de vergelijkingsprijs van een orderregel voorwaardelijk 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 content voor orderregels voorwaardelijk weergeven op basis van de producttags, die hoofdlettergevoelig zijn.

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

Orderregelattributen (eigenschappen)

Je kunt door orderregelattributen, ook wel eigenschappen van orderregels genoemd, itereren en informatie weergeven zoals geschatte levertijden, pre-orders en 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 ‘metaveld-trigger’ 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 abonnementsorderregel vóór eenmalige kortingen wilt weergeven, kun je de line_level_total_discount waarde 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 -%}