Støttet Liquid-syntaks for blokker i Checkout Blocks

Checkout Blocks støtter et delsett av Liquid-syntaks som du kan bruke i flere av de tilgjengelige blokktypene for å tilpasse kassetilpasningene basert på variabler.

På denne siden

Støttede Liquid-variabler

De følgende listene inkluderer alle støttede Liquid-variabler som kan brukes i en blokk for dynamisk innhold eller innholdsblokk for varelinje. Noen variabler er bare tilgjengelige på enkelte sider i kassen, og andre variabler kan bare inkluderes i bestemte blokktyper.

Se Shopifys dokumentasjon for Liquid-objekter for spesifikasjoner om hver variabel.

Liquid-variabler for kassen

De følgende Liquid-variablene støttes for kassen:

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-variabler for kunde

De følgende Liquid-variablene er tilpasset for kunder:

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

Liquid-variabler for lokal tilpasning

De følgende Liquid-variablene støttes for markeder:

localization.market - localization.market.id - localization.market.handle

Liquid-variabler for bestillinger

De følgende Liquid-variablene støttes for bestillinger:

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

Shop Liquid-variabler

De følgende Liquid-variablene støttes for butikkinformasjon:

shop.name
shop.url

Liquid-variabler for varelinje

Varelinjevariabler er bare tilgjengelig i en Varelinjeinnhold-blokk.

De følgende Liquid-variablene støttes for varelinjer:

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

Eksempler på kodebiter som bruker Liquid

Det følgende er noen eksempler på Liquid-kodebiter som støttes av Checkout Blocks.

Sjekk om kassen er B2B

Du kan bare vise innhold når kassen er B2B.

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

Analyser JSON

Du kan analysere JSON-verdier, for eksempel fra varelinjeattributter (egenskaper) eller metafelter.

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

Formater valuta

Checkout Blocks har full støtte for kasse med multivaluta. Du kan sende pengefilteret for å analysere og formatere penger med det aktive valutaformatet. Dette konverterer ikke automatisk valutaen.

{{ checkout.total_price | money }}

Handlekurvnotat

Du kan vise verdien til handlekurvnotatet, for eksempel hva som ble lagt inn i handlekurven.

{{ checkout.note }}

Handlekurvegenskaper

For å vise verdien til en bestemt handlekurvattributt, for eksempel en leveringsdato, kan du bruke denne kodebiten. Pass på at du endrer Leveringsdato-nøkkelen slik at den samsvarer med din egen.

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

Delivery Date: {{ delivery_date }}

Vis hele Liquid-innhold for kassen

Hvis du må gå gjennom hvilke verdier som finnes i kasseobjektet, kan du bruke JSON-filteret for å serialisere. Dette bør bare brukes til feilsøkingsformål.

{{ checkout | json }}

Metafelter i kassen

Du kan vise egendefinerte felt som er lagret i kassen, på takke- og bestillingsstatussiden ved å henvise til metafeltene for kassen. Finn ut mer om bruk av metafelter.

Erstatt your-namespace med navnefeltet og your-custom-field-key med nøkkelen for egendefinert felt som definert i blokken:

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

Formater en dato

I dette eksempelet oppretter vi en fremtidig dato (432 000 sekunder) og formaterer den.

Du kan returnere datoen formatert som «24.02.2025»:

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

Alternativt kan du formatere datoen som «24. februar 2025»:

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

Finn ut mer om formatering av datoer i Liquid.

Tilpasninger av varelinjeinnhold

Det følgende er noen eksempler på Liquid-kodebiter du kan bruke på innholdsblokker for varelinje.

Vis sammenlign med-pris basert på betingelser

Du kan vise sammenlign med-prisen for en varelinje basert på betingelser med denne kodebiten.

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

Vis innhold basert på produkttagger

Du kan vise varelinjeinnhold basert på produkttagger, som skiller mellom små og store bokstaver.

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

Attributter for varelinje (egenskaper)

Du kan gå gjennom over attributter for varelinjer, også kjent som egenskaper for varelinjen, og vise informasjon som leveringsestimater, forhåndsbestillinger med mer.

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

Vis verdien for «metafeltutløser»

Den følgende koden inneholder verdien til utløseren.

{{ line_item.trigger }}

Vis gjentakende totalsum for en varelinje

Hvis du må vise den gjentakende totalsummen for en abonnementvarelinje før éngangsrabatter, kan du bruke line_level_total_discount-verdien.

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