รูปแบบภาษา Liquid ที่รองรับบล็อกใน Checkout Blocks

Checkout Blocks รองรับส่วนย่อยของรูปแบบภาษา Liquid ที่คุณสามารถใช้ในประเภทบล็อกที่มีอยู่หลายประเภทเพื่อปรับแต่งการปรับแต่งการชำระเงินของคุณโดยอิงตามตัวแปร

ตัวแปร Liquid ที่รองรับ

รายการต่อไปนี้มีตัวแปร Liquid ที่รองรับทั้งหมดที่สามารถใช้งานภายในบล็อกเนื้อหาแบบไดนามิก หรือบล็อกเนื้อหาสินค้าเฉพาะรายการ สามารถเข้าถึงตัวแปรบางรายการได้ในหน้าการชำระเงินบางหน้าเท่านั้น และตัวแปรอื่นๆ สามารถรวมอยู่ในบล็อกบางประเภทได้เท่านั้น

ดูเอกสารประกอบของอ็อบเจกต์ Liquid ของ Shopify เกี่ยวกับตัวแปรแต่ละตัว

ตัวแปร Liquid ของการชำระเงิน

รองรับตัวแปร Liquid ต่อไปนี้ในการชำระเงิน:

• 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 ของลูกค้า

ตัวแปร Liquid ต่อไปนี้รองรับสำหรับลูกค้า

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

ตัวแปร Liquid ของการแปลเป็นภาษาท้องถิ่น

รองรับตัวแปร Liquid ต่อไปนี้ในตลาด:

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

ตัวแปร Liquid ของคำสั่งซื้อ

หมายเหตุ

สามารถเข้าถึงตัวแปรของคำสั่งซื้อได้บนหน้าสถานะคำสั่งซื้อเท่านั้น

ตัวแปร Liquid ต่อไปนี้รองรับสำหรับคำสั่งซื้อ:

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

ตัวแปร Liquid ของ Shop

รองรับตัวแปร Liquid ต่อไปนี้ในข้อมูลร้านค้า:

• shop.name
• shop.url

ตัวแปร Liquid ของสินค้าเฉพาะรายการ

หมายเหตุ

Creating a line item content block พร้อมให้ใช้งานสำหรับผู้ขายที่ใช้แผน Shopify Plus เท่านั้น

สามารถเข้าถึงตัวแปรสินค้าเฉพาะรายการได้ภายในบล็อกเนื้อหาสินค้าเฉพาะรายการเท่านั้น

รองรับตัวแปร Liquid ต่อไปนี้ในสินค้าเฉพาะรายการ:

• 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

ตัวอย่างของส่วนย่อยที่ใช้ Liquid

ต่อไปนี้คือตัวอย่างส่วนย่อยของ Liquid ที่รองรับโดย Checkout Blocks

ตรวจสอบว่าการชำระเงินเป็นแบบ B2B

คุณสามารถแสดงเนื้อหาได้เฉพาะเมื่อการชำระเงินเป็นแบบ B2B เท่านั้น

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

แจกแจง JSON

คุณสามารถแจกแจงค่า JSON ได้ เช่น จากแอตทริบิวต์ของสินค้าเฉพาะรายการ (คุณสมบัติ) หรือเมตาฟิลด์

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

จัดรูปแบบสกุลเงิน

Checkout Blocks รองรับการชำระเงินหลายสกุลเงินอย่างเต็มรูปแบบ เพียงส่งตัวกรองเงินเพื่อแจกแจงและจัดรูปแบบเงินโดยใช้รูปแบบสกุลเงินที่ใช้งานอยู่ ซึ่งจะไม่แปลงสกุลเงินโดยอัตโนมัติ

{{ checkout.total_price | money }}

หมายเหตุสำหรับตะกร้าสินค้า

คุณสามารถแสดงค่าของหมายเหตุของตะกร้าสินค้าได้ เช่น ค่าที่ป้อนไว้ในตะกร้าสินค้า

{{ checkout.note }}

ลักษณะตะกร้าสินค้า

หากต้องการแสดงค่าของแอตทริบิวต์ตะกร้าสินค้าที่เฉพาะเจาะจง เช่น วันที่จัดส่ง คุณสามารถใช้ส่วนย่อยนี้ได้ อย่าลืมเปลี่ยนวันที่จัดส่งหลักให้ตรงกับวันที่คุณต้องการ

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

Delivery Date: {{ delivery_date }}

แสดงเนื้อหา Liquid ในการชำระเงินทั้งหมด

หากคุณต้องตรวจสอบค่าที่มีอยู่ในออบเจ็กต์การชำระเงิน คุณสามารถใช้ตัวกรอง JSON เพื่อต่อกันเป็นลำดับได้ ควรใช้ตัวกรองนี้เพื่อวัตถุประสงค์ในการแก้ไขจุดบกพร่องเท่านั้น

{{ checkout | json }}

เมตาฟิลด์การชำระเงิน

คุณสามารถแสดงช่องข้อมูลแบบกำหนดเองที่บันทึกในการชำระเงินบนหน้าขอบคุณและหน้าแสดงสถานะคำสั่งซื้อได้โดยอ้างอิงเมตาฟิลด์การชำระเงิน ดูข้อมูลเพิ่มเติมเกี่ยวกับการเข้าถึงเมตาฟิลด์

แทนที่ your-namespace ด้วย_เนมสเปซ_ของคุณและ your-custom-field-key ด้วย_คีย์_ช่องแบบกําหนดเองของคุณตามที่กําหนดไว้ในบล็อก:

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

จัดรูปแบบวันที่

ในตัวอย่างนี้ เราสร้างวันที่ 4 วันในอนาคต (432000 วินาที) จากนั้นจัดรูปแบบ

คุณสามารถส่งข้อมูลผลลัพธ์วันที่ในรูปแบบ “02/24/2025”:

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

หรือคุณสามารถจัดรูปแบบวันที่เป็น “ก.พ. 24 2025”:

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดรูปแบบวันที่ใน Liquid

การปรับแต่งเนื้อหาสินค้าเฉพาะรายการ

หมายเหตุ

Creating a line item content block พร้อมให้ใช้งานสำหรับผู้ขายที่ใช้แผน Shopify Plus เท่านั้น

ต่อไปนี้คือตัวอย่างส่วนย่อยของ Liquid ที่คุณสามารถใช้ได้บนบล็อกเนื้อหาสินค้าเฉพาะรายการ

แสดงราคาเปรียบเทียบตามเงื่อนไข

คุณสามารถแสดงราคาเปรียบเทียบของสินค้าเฉพาะรายการแบบมีเงื่อนไขได้โดยใช้ส่วนย่อยนี้

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

แสดงเนื้อหาโดยอิงจากแท็กสินค้า

คุณสามารถแสดงเนื้อหาสินค้าเฉพาะรายการตามเงื่อนไขโดยอิงจากแท็กสินค้าที่ตัวพิมพ์เล็กพิมพ์ใหญ่มีผล

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

แอตทริบิวต์ของสินค้าเฉพาะรายการ (คุณสมบัติ)

คุณสามารถสร้างแอตทริบิวต์สินค้าเฉพาะรายการหรือที่เรียกว่า_คุณสมบัติของสินค้าเฉพาะรายการ_ และแสดงข้อมูลต่างๆ เช่น การประเมินการจัดส่ง การสั่งซื้อล่วงหน้า และอื่นๆ อีกมากมาย

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

แสดงค่า "ทริกเกอร์เมตาฟิลด์"

รหัสต่อไปนี้จะประกอบด้วยค่าของทริกเกอร์

{{ line_item.trigger }}

แสดงยอดรวมแบบเรียกเก็บต่อเนื่องสำหรับสินค้าเฉพาะรายการ

หากคุณต้องการแสดงยอดรวมแบบเรียกเก็บต่อเนื่องสำหรับสินค้าเฉพาะรายการการสมัครใช้งานก่อนใช้ส่วนลดแบบครั้งเดียว คุณสามารถใช้ค่า 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 -%}