Bantuan
Masuk

Sintaks Liquid yang didukung untuk blok di Checkout Blocks

Checkout Blocks mendukung subset sintaks Liquid yang dapat Anda gunakan di beberapa jenis blok yang tersedia untuk mempersonalisasi penyesuaian checkout Anda berdasarkan variabel.

Di halaman ini

Variabel Liquid yang didukung

Daftar berikut mencakup semua variabel Liquid yang didukung yang dapat digunakan dalam blok Konten dinamis atau blok Konten item pesanan. Beberapa variabel hanya dapat diakses di halaman checkout tertentu, dan variabel lain hanya dapat disertakan dalam jenis blok tertentu.

Lihat dokumentasi objek Liquid Shopify untuk detail tentang setiap variabel.

Variabel Liquid checkout

Variabel Liquid berikut didukung untuk 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

Variabel Liquid pelanggan

Variabel Liquid berikut didukung untuk pelanggan:

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

Variabel Liquid pelokalan

Variabel Liquid berikut didukung untuk pasar:

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

Variabel Liquid pesanan

Variabel Liquid berikut didukung untuk pesanan:

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

Variabel Liquid toko

Variabel Liquid berikut didukung untuk informasi toko:

  • shop.name
  • shop.url

Variabel Liquid item pesanan

Variabel item pesanan hanya dapat diakses di dalam Line item content block.

Variabel Liquid berikut didukung untuk item pesanan:

  • 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

Contoh cuplikan yang menggunakan Liquid

Berikut adalah beberapa contoh cuplikan Liquid yang didukung oleh Checkout Blocks.

Memeriksa apakah checkout adalah B2B

Anda dapat menampilkan konten hanya ketika checkout adalah B2B.

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

Mengurai JSON

Anda dapat mengurai nilai JSON, seperti dari atribut item pesanan (properti) atau bidang meta.

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

Memformat mata uang

Checkout Blocks sepenuhnya mendukung checkout multi-mata uang. Cukup gunakan filter uang untuk mengurai dan memformat uang menggunakan format mata uang aktif. Tindakan ini tidak mengonversi mata uang secara otomatis.

{{ checkout.total_price | money }}

Catatan pesanan

Anda dapat menampilkan nilai catatan pesanan, seperti yang dimasukkan di keranjang.

{{ checkout.note }}

Atribut keranjang

Untuk menampilkan nilai atribut keranjang tertentu, seperti tanggal penyerahan, Anda dapat menggunakan cuplikan ini. Pastikan untuk mengubah kunci Tanggal penyerahan agar sesuai dengan milik Anda.

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

Delivery Date: {{ delivery_date }}

Menampilkan seluruh konten Liquid checkout

Jika Anda perlu meninjau nilai apa saja yang ada pada objek checkout, Anda dapat menggunakan filter JSON untuk melakukan serialisasi. Ini sebaiknya hanya digunakan untuk tujuan debug.

{{ checkout | json }}

Bidang meta checkout

Anda dapat menampilkan kolom kustom yang disimpan ke checkout di halaman ucapan terima kasih dan status pesanan dengan mereferensikan bidang meta checkout. Pelajari selengkapnya tentang accessing metafields.

Ganti your-namespace dengan namespace Anda dan your-custom-field-key dengan kunci kolom kustom Anda seperti yang ditentukan di blok:

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

Memformat tanggal

Dalam contoh ini, kami membuat tanggal 4 hari ke depan (432.000 detik), lalu memformatnya.

Anda dapat menampilkan tanggal yang diformat sebagai "02/24/2025":

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

Atau, Anda dapat memformat tanggal sebagai "Feb 24, 2025":

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

Pelajari selengkapnya tentang formatting dates in Liquid.

Kustomisasi konten item pesanan

Berikut adalah beberapa contoh cuplikan Liquid yang dapat Anda gunakan di Line item content blocks.

Menampilkan harga "bandingkan dengan" secara kondisional

Anda dapat menampilkan harga "bandingkan dengan" item pesanan secara kondisional menggunakan cuplikan ini.

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

Menampilkan konten berdasarkan tag produk

Anda dapat menampilkan konten item pesanan secara kondisional berdasarkan tag produk, yang peka huruf besar/kecil.

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

Atribut item pesanan (properti)

Anda dapat melakukan iterasi pada atribut item pesanan, yang juga dikenal sebagai properti item pesanan, dan menampilkan informasi seperti estimasi pengiriman, pre-order, dan lainnya.

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

Menampilkan nilai "pemicu metafield"

Kode berikut akan berisi nilai pemicu.

{{ line_item.trigger }}

Menampilkan total berulang untuk item pesanan

Jika Anda perlu menampilkan total berulang untuk item pesanan langganan sebelum diskon sekali pakai, Anda dapat menggunakan line_level_total_discount nilai.

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