Bantuan
Log masuk

Sintaks Liquid yang disokong untuk blok dalam Checkout Blocks

Checkout Blocks menyokong subset sintaks Liquid yang boleh anda gunakan dalam beberapa jenis blok yang tersedia untuk memperibadikan penyesuaian pembayaran anda berdasarkan pemboleh ubah.

Pada halaman ini

Pemboleh ubah Liquid yang disokong

Senarai berikut merangkumi semua pemboleh ubah Liquid yang disokong yang boleh digunakan dalam blok Kandungan dinamik atau blok Kandungan item baris. Sesetengah pemboleh ubah hanya boleh diakses pada halaman pembayaran tertentu dan pemboleh ubah lain hanya boleh disertakan dalam jenis blok khusus.

Rujuk Dokumentasi objek Liquid Shopify untuk butiran khusus bagi setiap pemboleh ubah.

Pemboleh ubah Liquid pembayaran

Pemboleh ubah Liquid berikut disokong untuk pembayaran:

  • 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

Pemboleh ubah Liquid pelanggan

Pemboleh ubah Liquid berikut disokong untuk pelanggan:

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

Pemboleh ubah Liquid penyetempatan

Pemboleh ubah Liquid berikut disokong untuk pasaran:

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

Pemboleh ubah Liquid pesanan

Pemboleh ubah Liquid berikut disokong untuk pesanan:

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

Pemboleh ubah Liquid Shop

Pemboleh ubah Liquid berikut disokong untuk maklumat kedai:

  • shop.name
  • shop.url

Pemboleh ubah Liquid item baris

Pemboleh ubah item baris hanya boleh diakses dalam blok Kandungan item baris.

Pemboleh ubah Liquid berikut disokong untuk item baris:

  • 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 cebisan kod menggunakan Liquid

Berikut ialah beberapa contoh cebisan kod Liquid yang disokong oleh Checkout Blocks.

Semak sama ada pembayaran ialah B2B

Anda hanya boleh memaparkan kandungan apabila pembayaran ialah B2B.

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

Huraikan JSON

Anda boleh menghuraikan nilai JSON, seperti daripada atribut item baris (sifat) atau medan meta.

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

Formatkan mata wang

Checkout Blocks menyokong sepenuhnya pembayaran berbilang mata wang. Hanya gunakan penapis wang untuk menghuraikan dan memformatkan wang menggunakan format mata wang yang aktif. Proses ini tidak menukar mata wang secara automatik.

{{ checkout.total_price | money }}

Nota troli

Anda boleh memaparkan nilai nota troli, seperti maklumat yang dimasukkan pada troli.

{{ checkout.note }}

Atribut troli

Untuk memaparkan nilai atribut troli tertentu, seperti tarikh penghantaran, anda boleh menggunakan cebisan kod ini. Pastikan anda menukar kunci Delivery date agar sepadan dengan kunci 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 }}

Papar seluruh kandungan Liquid pembayaran

Jika anda perlu menyemak nilai yang wujud pada objek pembayaran, anda boleh menggunakan penapis JSON untuk membuat penyirian. Ini harus digunakan untuk tujuan penyahpepijatan sahaja.

{{ checkout | json }}

Medan meta pembayaran

Anda boleh memaparkan medan tersuai yang disimpan pada pembayaran dalam halaman terima kasih dan status pesanan dengan merujuk pada medan meta pembayaran. Ketahui lebih lanjut tentang mengakses medan meta.

Gantikan your-namespace dengan ruang nama anda dan your-custom-field-key dengan kunci medan tersuai anda seperti yang ditakrifkan pada blok:

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

Formatkan tarikh

Dalam contoh ini, kami mencipta tarikh 4 hari pada masa hadapan (432000 saat) dan kemudian memformatkannya.

Anda boleh mengembalikan tarikh yang diformatkan sebagai "02/24/2025":

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

Secara alternatif, anda boleh memformatkan tarikh sebagai "Feb 24, 2025":

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

Ketahui lebih lanjut tentang memformatkan tarikh dalam Liquid.

Penyesuaian kandungan item baris

Berikut ialah beberapa contoh cebisan kod Liquid yang boleh anda gunakan pada Blok kandungan item baris.

Tunjukkan bandingkan pada harga secara bersyarat

Anda boleh menunjukkan bandingkan pada harga item baris secara bersyarat menggunakan cebisan kod 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 -%}

Papar kandungan berdasarkan tag produk

Anda boleh memaparkan kandungan item baris secara bersyarat berdasarkan tag produk, yang membezakan huruf besar dan kecil.

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

Atribut item baris (sifat)

Anda boleh melelar melalui atribut item baris, juga dikenali sebagai sifat item baris dan memaparkan maklumat seperti anggaran penghantaran, prapesanan dan pelbagai lagi.

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

Papar nilai "pencetus medan meta"

Kod berikut akan mengandungi nilai pencetus.

{{ line_item.trigger }}

Tunjukkan jumlah berulang untuk item baris

Jika anda perlu menunjukkan jumlah berulang untuk item baris langganan sebelum diskaun satu masa, anda boleh menggunakan nilai line_level_total_discount .

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