Editor kod resit bercetak untuk Shopify POS anda

Anda boleh menyesuaikan resit bercetak menggunakan editor kod dalam pentadbir Shopify anda. Fail yang membentuk resit anda mengandungi Liquid, bahasa templat Shopify. Dengan editor kod, anda boleh mencipta penyesuaian yang lebih lanjutan menggunakan HTML, CSS dan Liquid berbanding menggunakan editor visual.

Anda boleh menukar templat resit dan templat bahagian yang digunakan pada resit bercetak anda. Fail templat Resit ialah jenis resit yang boleh anda cetak di kedai anda. Bahagian ialah komponen pada resit, seperti pengepala atau pengaki. Bahagian boleh digunakan semula oleh berbilang resit.

Pertimbangan untuk menggunakan editor kod resit

Sebelum anda menggunakan editor kod resit, semak pertimbangan berikut:

Sekatan akses

• Anda hanya boleh menggunakan editor kod daripada pentadbir Shopify anda pada desktop.
• Penyunting kod tidak tersedia untuk mana-mana lokasi POS di Itali.

Tempat perubahan digunakan

• Perubahan kod yang anda buat hanya digunakan pada lokasi yang dipilih.
• Penyesuaian dalam editor kod digunakan hanya pada lokasi POS Pro. Jika anda menggunakan editor kod dan mempunyai lokasi bukan POS Pro, anda boleh menggunakan editor visual untuk menyesuaikan pengepala dan pengaki bagi lokasi tersebut.
• Anda boleh menyesuaikan resit bercetak yang mempunyai templat dalam editor kod seperti resit jualan, resit hadiah, resit kad hadiah serta resit pemulangan dan pertukaran.

Bahasa kod

• Fail yang membentuk resit anda mengandungi Liquid, bahasa templat Shopify. Ketahui lebih lanjut tentang penggunaan Liquid.
• Untuk mengedit templat dalam editor kod resit, anda perlu biasa dengan HTML, CSS dan Liquid. Sokongan Tema Shopify boleh membantu dengan pelarasan kecil dalam skop Dasar Reka Bentuk Shopify.

Had penyesuaian

• Anda tidak boleh mempratonton resit dalam saiz pencetak yang berbeza daripada penyunting kod. Untuk mempratonton mengikut saiz pencetak, gunakan penyunting visual.
• Perihalan produk tidak tersedia sebagai pemboleh ubah dalam templat resit dan tidak boleh ditambahkan pada resit bercetak.

Penyelenggaraan templat

• Jika anda menyesuaikan resit menggunakan penyunting kod resit, maka templat sedia ada anda mungkin kehilangan sifat baharu, seperti selling_plan_name. Untuk menambahkan sifat yang tersedia terkini pada templat anda, anda perlu menetapkan semula templat resit anda kepada lalai. Menetapkan semula templat resit kepada lalai mengalih keluar sebarang penyesuaian yang telah anda buat pada templat tersebut. Buat nota tentang kod tersuai anda sebelum anda menetapkan semula. Selepas anda menetapkan semula templat, anda perlu menggunakan semula penyesuaian anda secara manual.

Akses editor kod

Anda boleh mengedit templat menggunakan editor kod. Anda mesti menukar untuk menggunakan editor kod daripada editor visual lalai terlebih dahulu dan anda boleh bertukar kembali kepada editor visual pada bila-bila masa.

Langkah untuk menukar antara penyunting adalah berbeza sedikit bergantung pada sama ada semua lokasi POS anda layak untuk penyunting kod atau sama ada hanya sebahagian lokasi POS anda layak, sebagai contoh, sebahagian lokasi POS anda tidak menggunakan POS Pro atau berpangkalan di Itali atau Perancis.

Langkah-langkah:

Gunakan fail tersuai dalam templat resit anda

Anda boleh menggunakan fail, seperti aset imej, yang anda muat naik ke pentadbir Shopify untuk menyesuaikan resit bercetak anda.

Fail mesti dimuat naik ke pentadbir Shopify anda sebelum boleh digunakan dalam resit bercetak. Ketahui lebih lanjut tentang muat naik fail.

Langkah-langkah:

1. Daripada pentadbir Shopify anda, pergi ke Kandungan > Fail.

2. Di sebelah fail yang ingin anda sertakan dalam kod resit bercetak anda, klik untuk menyalin pautan tersebut.

3. Navigasi ke editor kod.

4. Sertakan pautan aset dalam templat anda.

Tetap semula templat resit anda kepada lalai

Anda boleh menetapkan semula templat resit kepada versi lalai menggunakan editor kod.

Langkah-langkah:

Pemboleh ubah Liquid yang tersedia dalam editor kod resit

Anda boleh menggunakan Liquid untuk menyesuaikan templat resit bercetak dan jenis resit anda.

Objek data yang berikut tersedia untuk editor kod resit:

Objek resit

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 pemulangan

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 kumpulan pengiriman

destination

products

Objek item baris

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 baris pemulangan

Termasuk semua yang ada dalam objek item baris serta sifat yang berikut:

return_reason

return_reason_note

Penapis Liquid yang tersedia dalam penyunting kod resit

Anda boleh menggunakan penapis Liquid untuk membuat pelarasan pada maklumat dalam templat resit anda. Sebagai contoh, anda boleh mengubah pemformatan mata wang atau penulisan huruf besar pada teks khusus, seperti kod cukai.

Untuk menggunakan penapis, tambahkan aksara paip | kemudian penapis tersebut di dalam blok kod Liquid antara kurungan ikal berganda {{ }}. Penapis hanya boleh digunakan pada blok kod Liquid.

Dalam contoh berikut, penapis tersebut melaraskan kod cukai dari huruf kecil kepada huruf besar.

{{ tax_line.title | upcase }}

Dalam blok kod contoh, product ialah objek tersebut, title ialah sifatnya dan upcase ialah penapis yang digunakan. Penapis upcase menukar bentuk huruf bagi nilai tax_line.title kepada huruf besar. Sebagai contoh, jika tax_line.title mempunyai nilai Hst, maka penapis upcase akan menukar nilainya menjadi HST.

Rujuk bahagian Penapis daripada rujukan Liquid Tema Shopify untuk mendapatkan butiran tentang cara menggunakan penapis Liquid.

Penapis yang berikut tersedia dalam penyunting kod resit:

t

money

escape

barcode

qrcode

Contoh penyesuaian kod templat resit bercetak

Anda boleh menggunakan Liquid untuk menambah pemesejan bersyarat. Kefungsian ini serupa dengan menyimpan ke satu lokasi melalui penyunting visual. Contohnya, perniagaan anda bermula dengan satu lokasi dan anda kini mempunyai beberapa lokasi baharu. Anda ingin menyerlahkan kedai asal anda pada resit bercetak anda.

Anda boleh menambahkan mesej tersuai pada templat header.liquid dalam folder Bahagian bagi penyunting kod, dan gunakan Liquid untuk memaparkan mesej hanya untuk lokasi utama anda.

Kod berikut menyemak nama lokasi, dalam kes ini lokasi asal anda yang dipanggil "Home" dan memaparkan mesej "Welcome to our original store, opened in 1972." (Selamat datang ke kedai asal kami, yang dibuka pada 1972) jika lokasi tersebut sepadan dengan namanya. Sebaliknya, resit yang dicetak daripada lokasi anda yang lain memaparkan mesej "Welcome to our store." (Selamat datang ke kedai kami).

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

Pratonton perubahan kod anda dalam penyunting kod

Anda boleh mempratonton perubahan pada resit bercetak anda di dalam penyunting kod POS dalam pentadbir Shopify.

Bergantung pada fail Liquid mana yang dipilih, tetingkap pratonton menyerlahkan reka bentuk atau bahagian resit yang terkesan oleh fail tersebut. Secara lalai, tetingkap pratonton memaparkan kandungan untuk pesanan POS terbaharu anda. Anda boleh memilih pesanan khusus untuk digunakan sebagai kandungan resit anda dalam tetingkap pratonton untuk semua fail Liquid kecuali untuk fail gift-card.liquid, yang hanya memaparkan lokasi yang berbeza sebagai pilihan pratonton yang boleh dipilih.

Langkah-langkah: