Liquid-syntax som stöds för block i Checkout Blocks

Checkout Blocks har stöd för en delmängd av Liquid-syntax som du kan använda i flera av de tillgängliga blocktyperna för att personanpassa dina kassanpassningar baserat på variabler.

På den här sidan

Liquid-variabler som stöds

Följande listor innehåller alla Liquid-variabler som stöds och som kan användas i ett block med dynamiskt innehåll eller ett block med innehåll för enskild post. Vissa variabler är endast tillgängliga på vissa sidor i kassan, och andra variabler kan endast inkluderas i specifika blocktyper.

Se Shopifys dokumentation om Liquid-objekt för detaljer om varje variabel.

Liquid-variabler för kassa

Följande Liquid-variabler stöds för kassan:

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 för kund

Följande Liquid-variabler stöds för kunder:

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

Liquid-variabler för lokalisering

Följande Liquid-variabler stöds för marknader:

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

Liquid-variabler för order

Följande Liquid-variabler stöds för ordrar:

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

Liquid-variabler för butik

Följande Liquid-variabler stöds för butiksinformation:

shop.name
shop.url

Liquid-variabler för post

Postvariabler är endast tillgängliga i ett innehållsblock för post.

Följande Liquid-variabler stöds för 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

Exempel på fragment som använder Liquid

Följande är några exempel på Liquid-fragment som stöds av Checkout Blocks.

Kontrollera om kassan är B2B

Du kan endast visa innehåll när kassan är B2B.

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

Tolka JSON

Du kan tolka JSON-värden, till exempel från postattribut (egenskaper) eller metafält.

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

Formatera valuta

Checkout Blocks har fullt stöd för kassor med flera valutor. Skicka helt enkelt med ”money”-filtret för att tolka och formatera pengar med det aktiva valutaformatet. Valutan konverteras inte automatiskt.

{{ checkout.total_price | money }}

Varukorgsanteckning

Du kan visa värdet på varukorgsanteckningen, till exempel det som angavs i varukorgen.

{{ checkout.note }}

Varukorgsattribut

Använd det här fragmentet för att visa värdet på ett visst varukorgsattribut, till exempel ett leveransdatum. Se till att ändra nyckeln Delivery date så att den matchar 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 }}

Visa hela kassans Liquid-innehåll

Om du behöver granska vilka värden som finns i kassaobjektet kan du använda JSON-filtret för att serialisera. Detta bör endast användas i felsökningssyfte.

{{ checkout | json }}

Metafält för kassan

Du kan visa anpassade fält som sparats i kassan på tack- och orderstatussidorna genom att hänvisa till kassans metafält. Mer information om att komma åt metafält.

Byt ut your-namespace mot din namnrymd och your-custom-field-key mot din anpassade fältnyckel så som det definieras i blocket:

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

Formatera ett datum

I det här exemplet skapar vi ett datum fyra dagar framåt i tiden (432 000 sekunder) och formaterar det sedan.

Du kan returnera datumet formaterat som ”2025-02-24”:

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

Alternativt kan du formatera datumet som ”24 feb 2025”:

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

Mer information om att formatera datum i Liquid.

Anpassningar av postinnehåll

Följande är några exempel på Liquid-fragment som du kan använda i innehållsblock för poster.

Visa ordinarie pris villkorligt

Du kan villkorligt visa en posts ordinarie pris med hjälp av det här fragmentet.

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

Visa innehåll baserat på produkttaggar

Du kan villkorligt visa postinnehåll baserat på produkttaggarna, som är skiftlägeskänsliga.

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

Postattribut (egenskaper)

Du kan iterera över postattribut, även kända som postegenskaper, och visa information som leveransberäkningar, förbeställningar med mera.

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

Visa värdet för ”metafältutlösare”

Följande kod innehåller värdet för utlösaren.

{{ line_item.trigger }}

Visa återkommande totalbelopp för en post

Om du behöver visa det återkommande totalbeloppet för en prenumerationspost före engångsrabatter kan du använda line_level_total_discount värdet.

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