ไวยากรณ์ 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 สำหรับร้านค้า

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

• shop.name
• shop.url

ตัวแปร Liquid สำหรับสินค้าเฉพาะรายการ

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

ตัวแปร 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 รองรับการชำระเงินหลายสกุลเงินอย่างเต็มรูปแบบ เพียงใช้ตัวกรอง money เพื่อแยกวิเคราะห์และจัดรูปแบบเงินโดยใช้รูปแบบสกุลเงินที่ใช้งานอยู่ ทั้งนี้ ระบบจะไม่คอนเวิร์ทสกุลเงินโดยอัตโนมัติ

{{ checkout.total_price | money }}

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

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

{{ checkout.note }}

แอตทริบิวต์ตะกร้าสินค้า

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

{% 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 ด้วย namespace ของคุณ และ your-custom-field-key ด้วย 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" }}

หรือคุณจะจัดรูปแบบวันที่เป็น Feb 24, 2025 ก็ได้

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

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

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

ต่อไปนี้คือตัวอย่างส่วนย่อย 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 -%}