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 dine basert på variabler.

Støttede Liquid-variabler

Listene nedenfor inneholder alle støttede Liquid-variabler som kan brukes i en blokk med dynamisk innhold eller en blokk med innhold for varelinje. Noen variabler er bare tilgjengelige på bestemte sider i kassen, og andre variabler kan bare inkluderes i bestemte blokktyper.

Se Shopifys dokumentasjon for Liquid-objekter for mer informasjon om hver variabel.

Liquid-variabler for kasse

Følgende Liquid-variabler 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 kunder

Følgende Liquid-variabler støttes for kunder:

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

Liquid-variabler for lokal tilpasning

Følgende Liquid-variabler støttes for markeder:

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

Liquid-variabler for bestilling

Følgende Liquid-variabler støttes for bestillinger:

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

Liquid-variabler for butikk

Følgende Liquid-variabler støttes for butikkinformasjon:

• shop.name
• shop.url

Liquid-variabler for varelinje

Postvariabler er kun tilgjengelige i en innholdsblokk for poster.

Følgende Liquid-variabler støttes for poster:

• 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

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

Sjekk om kassen er B2B

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

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

Analysere JSON

Du kan analysere JSON-verdier, som for eksempel fra postattributter (egenskaper) eller metafelt.

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

Formater valuta

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

{{ checkout.total_price | money }}

Handlekurvnotat

Du kan vise verdien av handlekurvnotatet, for eksempel det som ble lagt inn i handlekurven.

{{ checkout.note }}

Handlekurvattributter

For å vise verdien av et bestemt handlekurvattributt, som for eksempel en leveringsdato, kan du bruke denne kodebiten. Pass på at du endrer nøkkelen Leveringsdato, 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 alt Liquid-innholdet i kassen

Hvis du trenger å se gjennom hvilke verdier som finnes på kasseobjektet, kan du bruke JSON-filteret til å serialisere. Dette bør kun brukes til feilsøking.

{{ checkout | json }}

Metafelt for kassen

Du kan vise egendefinerte felt som er lagret i kassen på takkesiden og statussiden for bestillingen, ved å referere til metafelt for kassen. Finn ut mer om hvordan du får tilgang til metafelt.

Erstatt your-namespace med ditt navneområde og your-custom-field-key med nøkkelen for det egendefinerte feltet, slik de er definert i blokken:

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

Formater en dato

I dette eksempelet oppretter vi en dato fire dager frem i tid (432 000 sekunder) og formaterer den deretter.

Du kan returnere datoen formatert som «02/24/2025»:

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

Alternativt kan du formatere datoen som «Feb 24, 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 postinnhold

Følgende er noen eksempler på Liquid-kodebiter du kan bruke i innholdsblokker for poster.

Vis sammenlign med-prisen betinget

Du kan vise en posts sammenlign med-pris betinget ved hjelp av 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 innhold for poster betinget, basert på produkttagger, som skiller mellom store og små bokstaver.

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

Postattributter (egenskaper)

Du kan iterere over postattributter, også kjent som postegenskaper, 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»

Følgende kode vil inneholde verdien til utløseren.

{{ line_item.trigger }}

Vis løpende totalsum for en post

Hvis du trenger å vise den løpende totalsummen for en abonnementspost før engangsrabatter, 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 -%}