Blok Liquid tersuai untuk resit bercetak

Semak peraturan sintaksis yang berikut sebelum anda membina blok Liquid tersuai:

• Nama pemboleh ubah menggunakan huruf kecil dan garis bawah, format yang dikenali sebagai snake_case. Sebagai contoh, gunakan order.total_price, order.customer.display_name dan order.line_items.
• Nilai wang ialah nombor biasa. Formatkan nombor tersebut menggunakan penapis money, seperti {{ order.total_price | money }}.
• Lindungi nilai pilihan dengan penyataan if supaya anda tidak mencetak baris kosong, seperti {% if order.customer.email %}{{ order.customer.email }}{% endif %}.
• Gelung pada senarai dengan penyataan for, seperti {% for item in order.line_items %} ... {% endfor %}.
• Sesetengah tag Liquid tidak disokong. Anda tidak boleh menggunakan assign, capture, include, render, raw, increment, atau decrement. Jika blok anda menggunakan tag yang tidak disokong, maka resit anda tidak akan disimpan dan anda akan melihat ralat.
• Blok Liquid tersuai boleh mengandungi sehingga 50 KB kod.

HTML dan CSS

Anda boleh menggunakan HTML asas dalam blok Liquid tersuai untuk menstrukturkan kandungan anda, seperti <p>, <br>, <strong>, <em>, pengepala, senarai dan pautan. Kandungan anda menggunakan fon dan saiz sedia ada pada resit.

Anda tidak boleh menggunakan CSS untuk mengubah rupa resit. Blok <style> dan atribut style tidak disokong, supaya blok Liquid tersuai tidak boleh menggayakan semula atau menyembunyikan kandungan di tempat lain pada resit. Tag <script>, pengendali acara seperti onclick, dan pautan javascript: juga tidak disokong.

Jika blok anda mengandungi HTML yang tidak disokong, resit anda tidak akan disimpan dan anda akan melihat ralat. Alih keluar HTML yang tidak disokong, kemudian simpan semula.

Blok Liquid tersuai boleh merujuk objek dan pemboleh ubah yang berikut. Sesetengah nilai tiada pada resit lalai, jadi blok Liquid tersuai ialah salah satu cara untuk menambahkan nilai tersebut.

Pemboleh ubah peringkat atas

Pemboleh ubah peringkat atas yang berikut tersedia dalam blok Liquid tersuai.

order

shop

location

settings

purchased_gift_cards

staff_member_description

locale

is_pickup

pickup_location

Objek pesanan

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

Objek pelanggan

Objek order.customer mengandungi butiran pelanggan.

display_name

first_name

last_name

email

phone

default_address

metafields

Objek item baris pesanan

Setiap item dalam order.line_items mengandungi ciri berikut.

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

Objek transaksi

Setiap pembayaran dalam order.transactions mengandungi ciri berikut. Kredit kedai yang dibelanjakan pada pesanan disenaraikan sebagai pembayaran bernama Kredit kedai. Baki kredit kedai pelanggan tidak tersedia sebagai pemboleh ubah.

name

payment_type

amount

kind

status

credit_card_number

created_at

additional_details

Objek kedai

Objek shop mengandungi butiran kedai.

name

domain

currency

id

Objek lokasi

Objek location mengandungi butiran lokasi runcit.

name

address1

address2

city

province

province_code

zip

country

phone

metafields

Objek alamat

Alamat, seperti order.shipping_address atau order.customer.default_address, mengandungi ciri berikut.

company

name

address1

address2

city

province

province_code

zip

country

country_code

phone

Objek diskaun

Setiap diskaun dalam order.discounts atau item.discounts mengandungi ciri berikut.

description

amount

percentage

Objek baris cukai

Setiap baris cukai dalam order.tax_lines mengandungi ciri berikut.

title

rate

rate_percentage

price

taxable_amount

Objek kad hadiah

Setiap kad hadiah dalam purchased_gift_cards mengandungi ciri berikut.

code

masked_code

balance

created_at

qr_code_content

Medan meta dan sifat item baris mempunyai dua bentuk.

Medan meta dan sifat item baris menggunakan kunci. Akses nilai secara langsung dengan kuncinya:

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

Medan meta pesanan dan pelanggan ialah senarai. Buat gelung terhadapnya:

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

Kunci dinormalkan kepada snake_case. Kunci seperti Care Instructions atau careInstructions diakses sebagai care_instructions. Sentiasa rujuk nilai yang menggunakan kunci dalam huruf kecil dengan garis bawah.

Ketersediaan medan meta pesanan dan pelanggan bergantung pada kewujudan medan meta tersebut pada rekod.

Anda boleh menggunakan penapis untuk memformatkan maklumat dalam blok Liquid tersuai anda. Untuk menggunakan penapis, tambahkan aksara paip, |, kemudian penapis tersebut di dalam output Liquid, seperti {{ order.total_price | money }}.

Penapis Liquid standard juga boleh digunakan. Untuk mengetahui lebih lanjut tentang penapis Liquid, rujuk Rujukan penapis.

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

Contoh berikut menambahkan kandungan yang tiada pada templat resit bercetak lalai.

Untuk menambahkan nota pesanan apabila nota tersebut wujud, gunakan Liquid yang berikut:

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

Untuk menambahkan SKU di sebelah setiap item, gunakan Liquid yang berikut:

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

Untuk menambahkan sifat item baris seperti ukiran, gunakan Liquid yang berikut:

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

Untuk menambahkan medan meta produk, seperti arahan penjagaan, gunakan Liquid yang berikut:

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

Untuk menambahkan medan meta pelanggan, gunakan Liquid yang berikut:

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

Untuk menambahkan kod QR yang dipautkan kepada pesanan, gunakan Liquid yang berikut:

{{ order.qr_code_content | qrcode }}