Khối Liquid tùy chỉnh cho biên lai in

Xem xét các quy tắc cú pháp sau trước khi xây dựng khối Liquid tùy chỉnh:

• Tên biến sử dụng chữ thường và dấu gạch dưới, một định dạng được gọi là snake_case. Ví dụ: sử dụng order.total_price, order.customer.display_name và order.line_items.
• Giá trị tiền là số thuần túy. Hãy định dạng bằng bộ lọc money, ví dụ như {{ order.total_price | money }}.
• Bảo vệ các giá trị tùy chọn bằng câu lệnh if để không in ra dòng trống, ví dụ như {% if order.customer.email %}{{ order.customer.email }}{% endif %}.
• Lặp qua các danh sách bằng câu lệnh for, ví dụ như {% for item in order.line_items %} ... {% endfor %}.
• Một số thẻ Liquid không được hỗ trợ. Không thể sử dụng assign, capture, include, render, raw, increment hoặc decrement. Nếu khối sử dụng thẻ không được hỗ trợ, biên lai sẽ không được lưu và hiển thị lỗi.
• Khối Liquid tùy chỉnh có thể chứa tối đa 50 KB mã.

HTML và CSS

Có thể dùng HTML cơ bản trong khối Liquid tùy chỉnh để cấu trúc nội dung, chẳng hạn như <p>, <br>, <strong>, <em>, tiêu đề, danh sách và liên kết. Nội dung sử dụng phông chữ và kích thước hiện có của biên lai.

Không thể dùng CSS để thay đổi giao diện biên lai. Các khối <style> và thuộc tính style không được hỗ trợ, do đó, khối Liquid tùy chỉnh không thể tạo kiểu lại hoặc ẩn nội dung ở nơi khác trên biên lai. Các thẻ <script>, trình xử lý sự kiện như onclick và liên kết javascript: cũng không được hỗ trợ.

Nếu khối chứa HTML không được hỗ trợ, biên lai sẽ không được lưu và hiển thị lỗi. Hãy xóa HTML không được hỗ trợ rồi lưu lại.

Khối Liquid tùy chỉnh có thể tham chiếu các đối tượng và biến sau đây. Một số giá trị không có trên biên lai mặc định, do đó, dùng khối Liquid tùy chỉnh là một cách để thêm các giá trị đó.

Biến cấp cao nhất

Các biến cấp cao nhất sau đây có sẵn trong khối Liquid tùy chỉnh.

order

shop

location

settings

purchased_gift_cards

staff_member_description

locale

is_pickup

pickup_location

Đối tượng đơn hàng

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

Đối tượng khách hàng

Đối tượng order.customer chứa thông tin chi tiết của khách hàng.

display_name

first_name

last_name

email

phone

default_address

metafields

Đối tượng mục hàng trong đơn hàng

Mỗi mục trong order.line_items có chứa các thuộc tính sau.

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

Đối tượng giao dịch

Mỗi khoản thanh toán trong order.transactions chứa các thuộc tính sau. Khoản tín dụng cửa hàng đã dùng cho đơn hàng được liệt kê dưới dạng khoản thanh toán có tên là Tín dụng cửa hàng. Số dư tín dụng cửa hàng còn lại của khách hàng không có sẵn dưới dạng biến.

name

payment_type

amount

kind

status

credit_card_number

created_at

additional_details

Đối tượng shop

Đối tượng shop chứa thông tin chi tiết của cửa hàng.

name

domain

currency

id

Đối tượng địa điểm

Đối tượng location chứa thông tin chi tiết của địa điểm bán lẻ.

name

address1

address2

city

province

province_code

zip

country

phone

metafields

Đối tượng địa chỉ

Một địa chỉ, ví dụ như order.shipping_address hoặc order.customer.default_address, có chứa các thuộc tính sau.

company

name

address1

address2

city

province

province_code

zip

country

country_code

phone

Đối tượng giảm giá

Mỗi khoản giảm giá trong order.discounts hoặc item.discounts có chứa các thuộc tính sau.

description

amount

percentage

Đối tượng dòng thuế

Mỗi dòng thuế trong order.tax_lines có chứa các thuộc tính sau.

title

rate

rate_percentage

price

taxable_amount

Đối tượng thẻ quà tặng

Mỗi thẻ quà tặng trong purchased_gift_cards có chứa các thuộc tính sau.

code

masked_code

balance

created_at

qr_code_content

Trường siêu dữ liệu và thuộc tính mục hàng có hai dạng.

Trường siêu dữ liệu và thuộc tính mục hàng được gắn khóa. Truy cập trực tiếp giá trị bằng khóa tương ứng:

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

Trường siêu dữ liệu đơn hàng và khách hàng là các danh sách. Chạy vòng lặp qua các danh sách này:

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

Các khóa được chuẩn hóa về dạng snake_case. Một khóa như Care Instructions hoặc careInstructions được truy cập bằng dạng care_instructions. Luôn tham chiếu các giá trị có khóa ở dạng chữ thường và dấu gạch dưới.

Tính khả dụng của trường siêu dữ liệu đơn hàng và khách hàng phụ thuộc vào việc các trường này có tồn tại trong bản ghi hay không.

Bạn có thể dùng bộ lọc để định dạng thông tin trong khối Liquid tùy chỉnh. Để áp dụng bộ lọc, hãy thêm ký tự gạch đứng |, rồi thêm bộ lọc vào bên trong kết quả đầu ra Liquid, ví dụ như {{ order.total_price | money }}.

Bạn cũng có thể dùng các bộ lọc Liquid tiêu chuẩn. Để tìm hiểu thêm về các bộ lọc Liquid, hãy tham khảo Tài liệu tham khảo về bộ lọc.

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

Các ví dụ sau bổ sung nội dung không có trên mẫu biên lai in mặc định.

Để thêm ghi chú đơn hàng nếu có, hãy dùng mã Liquid sau:

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

Để thêm SKU bên cạnh mỗi mặt hàng, hãy dùng mã Liquid sau:

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

Để thêm một thuộc tính mục hàng, chẳng hạn như thông tin khắc chữ, hãy dùng mã Liquid sau:

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

Để thêm trường siêu dữ liệu sản phẩm, chẳng hạn như hướng dẫn bảo quản, hãy dùng mã Liquid sau:

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

Để thêm trường siêu dữ liệu khách hàng, hãy dùng mã Liquid sau:

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

Để thêm mã QR liên kết với đơn hàng, hãy dùng mã Liquid sau:

{{ order.qr_code_content | qrcode }}