Understøttet Liquid-syntaks for blokke i Checkout Blocks

Checkout Blocks understøtter et delsæt af Liquid-syntaks, som du kan bruge i flere af de tilgængelige bloktyper til at personliggøre dine tilpasninger af betaling baseret på variabler.

På denne side

Understøttede Liquid-variabler

Følgende lister indeholder alle understøttede Liquid-variabler, der kan bruges i en blok af typen Dynamisk indhold eller Indhold for varelinje. Nogle variabler er kun tilgængelige på bestemte sider af betalingssiden, og andre variabler kan kun inkluderes i specifikke bloktyper.

Se Shopifys dokumentation for Liquid-objekter for specifikke oplysninger om hver variabel.

Liquid-variabler for betaling

Følgende Liquid-variabler understøttes for betalingssiden:

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 understøttes for kunder:

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

Liquid-variabler for tilpasning til lokale forhold

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

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

Liquid-variabler for ordrer

Følgende Liquid-variabler understøttes for ordrer:

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

Liquid-variabler for butik

Følgende Liquid-variabler understøttes for butiksoplysninger:

shop.name
shop.url

Liquid-variabler for varelinjer

Variabler for varelinjer er kun tilgængelige i en Indhold for varelinje-blok.

Følgende Liquid-variabler understø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å kodestykker, der bruger Liquid

Følgende er nogle eksempler på Liquid-kodestykker, der understøttes af Checkout Blocks.

Tjek, om betalingssiden er B2B

Du kan kun vise indhold, når betalingssiden er B2B.

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

Analyser JSON

Du kan analysere JSON-værdier, f.eks. fra varelinjeattributter (egenskaber) eller metafelter.

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

Formater valuta

Checkout Blocks understøtter multivalutabetaling fuldt ud. Du skal blot bruge pengefilteret til at analysere og formatere beløb i det aktive valutaformat. Dette konverterer ikke valutaen automatisk.

{{ checkout.total_price | money }}

Bemærkning til indkøbskurv

Du kan vise værdien af bemærkningen til indkøbskurven, f.eks. det, der blev angivet i indkøbskurven.

{{ checkout.note }}

Egenskaber for indkøbskurv

Du kan bruge dette kodestykke til at vise værdien af en bestemt egenskab for indkøbskurven, f.eks. en leveringsdato. Sørg for at ændre nøglen Delivery date, så den matcher 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-indholdet for betalingssiden

Hvis du har brug for at gennemgå, hvilke værdier der findes i betalingssideobjektet, kan du bruge et JSON-filter til at serialisere. Dette bør kun bruges til fejlfinding.

{{ checkout | json }}

Metafelter for betalingsside

Du kan vise tilpassede felter, der er gemt på betalingssiden, på takke- og ordrestatussiderne ved at henvise til metafelterne for betalingssiden. Få mere at vide om at få adgang til metafelter.

Erstat your-namespace med dit navneområde og your-custom-field-key med nøglen til dit tilpassede felt, som defineret i blokken:

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

Formater en dato

I dette eksempel opretter vi en dato, der ligger 4 dage ude i fremtiden (432.000 sekunder), og formaterer den derefter.

Du kan returnere datoen formateret som "02/24/2025":

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

Du kan også formatere datoen som "Feb 24, 2025":

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

Få mere at vide om formatering af datoer i Liquid.

Tilpasninger af indhold for varelinjer

Følgende er nogle eksempler på Liquid-kodestykker, som du kan bruge i indholdsblokke for varelinjer.

Vis sammenligningsprisen betinget

Du kan bruge dette kodestykke til at vise en varelinjes sammenligningspris betinget.

{%- 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 indhold baseret på produkttags

Du kan betinget vise indhold for varelinjer baseret på produkttags, hvor der skelnes mellem store og små bogstaver.

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

Varelinjeattributter (egenskaber)

Du kan iterere over varelinjeattributter, også kendt som egenskaber for varelinjer, og vise oplysninger som f.eks. estimeret levering, forudbestillinger med mere.

{%- 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 værdien for "udløser for metafelt"

Følgende kode vil indeholde værdien af udløseren.

{{ line_item.trigger }}

Vis tilbagevendende total for en varelinje

Hvis du har brug for at vise den tilbagevendende total for en abonnementsvarelinje før engangsrabatter, kan du bruge line_level_total_discount værdien.

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