Editor kode struk cetak untuk POS Shopify Anda

Anda dapat menyesuaikan tanda terima cetak menggunakan editor kode di admin Shopify Anda. File yang menyusun tanda terima Anda berisi Liquid, bahasa templating Shopify. Dengan editor kode, Anda dapat membuat kustomisasi yang lebih canggih menggunakan HTML, CSS, dan Liquid daripada dengan editor visual.

Anda dapat mengubah templat struk dan templat bagian yang digunakan pada struk cetak Anda. File templat Struk adalah jenis struk yang dapat Anda cetak di toko. Bagian adalah bagian dari struk, seperti header atau footer. Bagian dapat digunakan kembali oleh beberapa struk.

Pertimbangan untuk menggunakan editor kode struk

Sebelum menggunakan editor kode struk, tinjau pertimbangan berikut:

Pembatasan akses

• Anda dapat menggunakan editor kode hanya dari admin Shopify Anda di desktop.
• Editor kode tidak tersedia untuk lokasi POS mana pun di Italia.

Tempat perubahan berlaku

• Perubahan kode yang Anda buat hanya berlaku pada lokasi yang dipilih.
• Kustomisasi di editor kode hanya berlaku untuk lokasi POS Pro. Jika Anda menggunakan editor kode dan memiliki lokasi non-POS-Pro, Anda dapat menggunakan editor visual untuk menyesuaikan header dan footer untuk lokasi tersebut.
• Anda dapat menyesuaikan tanda terima cetak yang memiliki templat di editor kode seperti, tanda terima penjualan, tanda terima hadiah, tanda terima kartu hadiah, serta tanda terima pengembalian dan penukaran.

Bahasa kode

• File yang menyusun tanda terima Anda berisi Liquid, bahasa templating Shopify. Pelajari selengkapnya tentang penggunaan Liquid.
• Untuk mengedit templat di editor kode tanda terima, Anda harus familier dengan HTML, CSS, dan Liquid. Dukungan Tema Shopify dapat membantu penyesuaian kecil dalam cakupan Kebijakan Desain Shopify.

Batasan kustomisasi

• Anda tidak dapat mempratinjau tanda terima dalam berbagai ukuran pencetak dari editor kode. Untuk mempratinjau menurut ukuran pencetak, gunakan editor visual.
• Deskripsi produk tidak tersedia sebagai variabel dalam templat tanda terima dan tidak dapat ditambahkan ke tanda terima yang dicetak.

Pemeliharaan templat

• Jika Anda menyesuaikan tanda terima dengan editor kode tanda terima, templat Anda yang ada mungkin tidak memiliki properti baru, seperti selling_plan_name. Untuk menambahkan properti terbaru yang tersedia ke templat Anda, Anda perlu mengatur ulang templat tanda terima ke default. Mengatur ulang templat tanda terima ke default akan menghapus kustomisasi apa pun yang telah Anda buat pada templat tersebut. Buat catatan tentang kode yang disesuaikan sebelum Anda mengatur ulang. Setelah mengatur ulang templat, Anda harus menerapkan ulang kustomisasi Anda secara manual.

Akses editor kode

Anda dapat mengedit templat menggunakan editor kode. Anda harus terlebih dahulu beralih ke penggunaan editor kode dari editor visual default, dan Anda dapat beralih kembali ke editor visual kapan saja.

Langkah-langkah untuk beralih antara editor sedikit berbeda, bergantung pada apakah semua lokasi POS Anda memenuhi syarat untuk menggunakan editor kode, atau apakah hanya beberapa lokasi POS Anda yang memenuhi syarat. Contohnya, beberapa lokasi POS Anda tidak menggunakan POS Pro atau berbasis di Italia atau Prancis.

Langkah-langkah:

Gunakan file kustom di templat tanda terima Anda

Anda dapat menggunakan file, seperti aset gambar, yang diunggah ke admin Shopify untuk menyesuaikan tanda terima cetak Anda.

File harus diunggah ke admin Shopify Anda sebelum dapat digunakan di tanda terima cetak. Pelajari selengkapnya tentang pengunggahan file.

Langkah-langkah:

1. Dari admin Shopify Anda, buka Konten > File.

2. Di samping file yang ingin Anda sertakan dalam kode tanda terima cetak, klik untuk menyalin tautan.

3. Buka editor kode.

4. Sertakan tautan aset di templat Anda.

Atur ulang templat tanda terima Anda ke default

Anda dapat mengatur ulang templat tanda terima ke versi default menggunakan editor kode.

Langkah-langkah:

Variabel Liquid yang tersedia di editor kode tanda terima

Anda dapat menggunakan Liquid untuk menyesuaikan templat tanda terima cetak dan jenis tanda terima Anda.

Objek data berikut tersedia untuk editor kode tanda terima:

Objek tanda terima

shop

location

order

return

gift_card

Objek pesanan

id

created_at

source_identifier

change_due

balance_due

name

note

line_items

subtotal_price

total_price

total_tip_received

discounts

transactions

taxes_included

tax_lines

customer

shipping_address

shipping_groups

Objek pengembalian

name

created_at

is_unverified

is_exchange

exchange_type

return_discount

return_subtotal

return_total

exchange_subtotal

exchange_total

total_cash_rounding_adjustment

total_adjusted_amount

net_total

return_line_items

exchange_line_items

return_tax_lines

exchange_tax_lines

shipping_refund_amount

tip_refund_amount

transactions

Objek grup pengiriman

destination

products

Objek item pesanan

id

name

variant_title

price

is_gift_card

discount

total_price

selling_plan_name

tax_rates

custom_attributes

variant_title

variant_id

variant_metafields

staff_member_description

product_metafields

Objek item pesanan pengembalian

Mencakup semua yang ada di objek item pesanan ditambah properti berikut:

return_reason

return_reason_note

Filter Liquid yang tersedia di editor kode tanda terima

Anda dapat menggunakan filter Liquid untuk melakukan penyesuaian pada informasi di templat tanda terima Anda. Misalnya, Anda dapat mengubah pemformatan mata uang atau kapitalisasi teks tertentu, seperti kode pajak.

Untuk menerapkan filter, tambahkan karakter pipa | lalu filter di dalam blok kode Liquid di antara kurung kurawal ganda {{ }}. Filter hanya dapat diterapkan pada blok kode Liquid.

Dalam contoh berikut, filter menyesuaikan kode pajak dari huruf kecil ke huruf besar.

{{ tax_line.title | upcase }}

Dalam blok kode contoh, product adalah objek, title adalah propertinya, dan upcase adalah filter yang diterapkan. Filter upcase mengubah kapitalisasi nilai tax_line.title menjadi huruf besar. Misalnya, jika tax_line.title memiliki nilai Hst, filter upcase akan mengubah nilai tersebut menjadi HST.

Lihat bagian Filter dari referensi Liquid Tema Shopify untuk detail tentang cara menggunakan filter Liquid.

Filter berikut tersedia di editor kode tanda terima:

t

money

escape

barcode

qrcode

Contoh kustomisasi kode templat tanda terima cetak

Anda dapat menggunakan Liquid untuk menambahkan pesan bersyarat. Fungsionalitas ini mirip dengan menyimpan ke satu lokasi dengan editor visual. Misalnya, bisnis Anda dimulai dengan satu lokasi, dan sekarang Anda memiliki beberapa lokasi baru. Anda ingin menyorot toko asli Anda di tanda terima cetak.

Anda dapat menambahkan pesan kustom ke templat header.liquid di folder Sections pada editor kode, dan menggunakan Liquid untuk menampilkan pesan hanya untuk lokasi utama Anda.

Kode berikut memeriksa nama lokasi, dalam hal ini lokasi asli Anda yang disebut "Home", dan menampilkan pesan "Selamat datang di toko asli kami, dibuka pada tahun 1972." jika lokasi cocok dengan nama tersebut. Tanda terima yang dicetak dari lokasi Anda yang lain akan menampilkan pesan "Selamat datang di toko kami.".

{% if location.name == 'Home' %}
  Welcome to our original store, opened in 1972.
{% else %}
  Welcome to our store.
{% end %}

Pratinjau perubahan kode Anda di editor kode

Anda dapat mempratinjau perubahan pada tanda terima cetak di editor kode POS di admin Shopify.

Tergantung pada file Liquid mana yang dipilih, jendela pratinjau akan menyorot desain atau bagian tanda terima yang terpengaruh oleh file tersebut. Secara default, jendela pratinjau menampilkan konten untuk pesanan POS terbaru Anda. Anda dapat memilih pesanan tertentu untuk digunakan sebagai konten tanda terima di jendela pratinjau untuk semua file Liquid, kecuali file gift-card.liquid, yang hanya menampilkan lokasi yang berbeda sebagai opsi pratinjau yang dapat dipilih.

Langkah-langkah: