บล็อก Liquid แบบกำหนดเองสำหรับใบเสร็จที่พิมพ์

โปรดตรวจสอบกฎไวยากรณ์ต่อไปนี้ก่อนที่คุณจะสร้างบล็อก Liquid แบบกำหนดเอง:

• ชื่อตัวแปรใช้ตัวอักษรพิมพ์เล็กและเครื่องหมายขีดล่าง (underscore) ซึ่งเป็นรูปแบบที่เรียกว่า snake_case ตัวอย่างเช่น ใช้ order.total_price, order.customer.display_name และ order.line_items
• มูลค่าเงินเป็นตัวเลขธรรมดา ให้จัดรูปแบบโดยใช้ตัวกรอง money เช่น {{ order.total_price | money }}
• ตรวจสอบค่าตัวเลือกด้วยคำสั่ง if เพื่อไม่ให้พิมพ์บรรทัดว่างออกมา เช่น {% if order.customer.email %}{{ order.customer.email }}{% endif %}
• วนซ้ำรายการด้วยคำสั่ง for เช่น {% for item in order.line_items %} ... {% endfor %}
• แท็ก Liquid บางรายการไม่รองรับการใช้งาน คุณไม่สามารถใช้ assign, capture, include, render, raw, increment หรือ decrement หากบล็อกของคุณใช้แท็กที่ไม่รองรับ ใบเสร็จของคุณก็จะไม่บันทึกและคุณจะพบข้อผิดพลาด
• บล็อก Liquid แบบกำหนดเองสามารถมีโค้ดได้สูงสุด 50 KB

HTML และ CSS

คุณสามารถใช้ HTML พื้นฐานในบล็อก Liquid แบบกำหนดเองเพื่อจัดโครงสร้างเนื้อหาของคุณ เช่น <p>, <br>, <strong>, <em> ส่วนหัว รายการ และลิงก์ เนื้อหาของคุณจะใช้แบบอักษรและขนาดที่มีอยู่ของใบเสร็จ

คุณไม่สามารถใช้ CSS เพื่อเปลี่ยนรูปลักษณ์ของใบเสร็จได้ ไม่รองรับการใช้งานบล็อก <style> และคุณลักษณะ style เพื่อให้บล็อก Liquid แบบกำหนดเองไม่สามารถเปลี่ยนรูปแบบหรือซ่อนเนื้อหาในส่วนอื่นของใบเสร็จได้ นอกจากนี้ยังไม่รองรับการใช้งานแท็ก <script> ตัวจัดการเหตุการณ์ เช่น onclick และลิงก์ javascript: อีกด้วย

หากบล็อกของคุณมี HTML ที่ไม่รองรับ ใบเสร็จของคุณจะไม่บันทึกและคุณจะพบข้อผิดพลาด โปรดลบ HTML ที่ไม่รองรับออกแล้วบันทึกอีกครั้ง

บล็อก Liquid แบบกำหนดเองสามารถอ้างอิงออบเจ็กต์และตัวแปรต่อไปนี้ ค่าบางรายการจะไม่อยู่ในใบเสร็จตามค่าเริ่มต้น ดังนั้นบล็อก Liquid แบบกำหนดเองจึงเป็นวิธีหนึ่งในการเพิ่มค่าดังกล่าว

ตัวแปรระดับบนสุด

ตัวแปรระดับบนสุดต่อไปนี้สามารถใช้งานได้ในบล็อก Liquid แบบกำหนดเอง

order

shop

location

settings

purchased_gift_cards

staff_member_description

locale

is_pickup

pickup_location

ออบเจ็กต์คำสั่งซื้อ

name

created_at

note

subtotal_price

total_price

shipping_price

total_tip_received

balance_due

change_due

taxes_included

receipt_number

barcode_content

qr_code_content

line_items

transactions

discounts

tax_lines

refunds

shipping_address

customer

metafields

อ็อบเจ็กต์ลูกค้า

อ็อบเจ็กต์ order.customer จะมีรายละเอียดของลูกค้า

display_name

first_name

last_name

email

phone

default_address

metafields

อ็อบเจ็กต์สินค้าเฉพาะรายการของคำสั่งซื้อ

แต่ละรายการใน order.line_items จะมีคุณสมบัติดังต่อไปนี้

name

variant_title

sku

vendor

quantity

price

total_price

discounted_total_price

discounted_unit_price

discounts

selling_plan_name

staff_member_description

custom_attributes

product_metafields

variant_metafields

อ็อบเจ็กต์ธุรกรรม

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

name

payment_type

amount

kind

status

credit_card_number

created_at

additional_details

อ็อบเจ็กต์ร้านค้า

อ็อบเจ็กต์ shop จะมีรายละเอียดของร้านค้า

name

domain

currency

id

อ็อบเจ็กต์ตำแหน่งที่ตั้ง

อ็อบเจ็กต์ location จะมีรายละเอียดตำแหน่งที่ตั้งของร้านค้าปลีก

name

address1

address2

city

province

province_code

zip

country

phone

metafields

อ็อบเจ็กต์ที่อยู่

ที่อยู่ เช่น order.shipping_address หรือ order.customer.default_addressจะมีคุณสมบัติดังต่อไปนี้

company

name

address1

address2

city

province

province_code

zip

country

country_code

phone

อ็อบเจ็กต์ส่วนลด

ส่วนลดแต่ละรายการใน order.discounts หรือ item.discounts จะมีคุณสมบัติดังต่อไปนี้

description

amount

percentage

อ็อบเจ็กต์รายการภาษี

รายการภาษีแต่ละรายการใน order.tax_lines จะมีคุณสมบัติดังต่อไปนี้

title

rate

rate_percentage

price

taxable_amount

อ็อบเจ็กต์บัตรของขวัญ

บัตรของขวัญแต่ละใบใน purchased_gift_cards จะมีคุณสมบัติดังต่อไปนี้

code

masked_code

balance

created_at

qr_code_content

เมตาฟิลด์และคุณสมบัติสินค้าเฉพาะรายการมี 2 รูปแบบ

เมตาฟิลด์และคุณสมบัติของสินค้าเฉพาะรายการจะมีการกำหนดคีย์ เข้าถึงค่าได้โดยตรงจากคีย์ ดังนี้

{{ item.product_metafields.care_instructions }}
{{ item.custom_attributes.engraving }}

เมตาฟิลด์คำสั่งซื้อและลูกค้าจะเป็นรายการ ให้ทำการวนซ้ำดังนี้

{% for m in order.metafields %}
  {{ m.namespace }}.{{ m.key }}: {{ m.value }}
{% endfor %}

คีย์จะถูกปรับให้เป็นรูปแบบ snake_case เช่น คีย์ Care Instructions หรือ careInstructions จะถูกเข้าถึงเป็น care_instructions โปรดอ้างอิงค่าที่มีคีย์เป็นอักษรตัวพิมพ์เล็กและมีขีดล่างเสมอ

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

คุณสามารถใช้ตัวกรองเพื่อจัดรูปแบบข้อมูลในบล็อก Liquid ที่กำหนดเองได้ หากต้องการใช้ตัวกรอง ให้เพิ่มเครื่องหมายไปป์ | แล้วตามด้วยตัวกรองภายในเอาต์พุต Liquid เช่น {{ order.total_price | money }}

นอกจากนี้ยังใช้ตัวกรอง Liquid แบบมาตรฐานได้ด้วย หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับตัวกรอง Liquid โปรดดูการอ้างอิงตัวกรอง

money

{{ order.total_price | money }}

date

{{ order.created_at | date: '%B %e, %Y' }}

percent

{{ tax_line.rate | percent }}

t

{{ 'receipt.total' | t }}

barcode

{{ order.barcode_content | barcode }}

qrcode

{{ order.qr_code_content | qrcode }}

ตัวอย่างต่อไปนี้เป็นการเพิ่มเนื้อหาที่ไม่มีอยู่ในเทมเพลตใบเสร็จแบบพิมพ์ที่เป็นค่าเริ่มต้น

หากต้องการเพิ่มหมายเหตุคำสั่งซื้อ (หากมี) ให้ใช้ Liquid ต่อไปนี้

{% if order.note %}<p>Note: {{ order.note }}</p>{% endif %}

หากต้องการเพิ่ม SKU ไว้ถัดจากแต่ละรายการ ให้ใช้ Liquid ต่อไปนี้

{% for item in order.line_items %}
  <p>{{ item.name }} — {{ item.sku }} ×{{ item.quantity }}</p>
{% endfor %}

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

{% for item in order.line_items %}
  {% if item.custom_attributes.engraving %}
    <p>{{ item.name }} — Engraving: {{ item.custom_attributes.engraving }}</p>
  {% endif %}
{% endfor %}

หากต้องการเพิ่มเมตาฟิลด์สินค้า เช่น คำแนะนำในการดูแลรักษา ให้ใช้ Liquid ต่อไปนี้

{% for item in order.line_items %}
  {% if item.product_metafields.care_instructions %}
    <p>{{ item.name }}: {{ item.product_metafields.care_instructions }}</p>
  {% endif %}
{% endfor %}

หากต้องการเพิ่มเมตาฟิลด์ลูกค้า ให้ใช้ Liquid ต่อไปนี้

{% for m in order.customer.metafields %}
  {% if m.key == 'loyalty_tier' %}<p>Loyalty tier: {{ m.value }}</p>{% endif %}
{% endfor %}

หากต้องการเพิ่มคิวอาร์โค้ดที่ลิงก์ไปยังคำสั่งซื้อ ให้ใช้ Liquid ต่อไปนี้

{{ order.qr_code_content | qrcode }}