Menyelesaikan masalah untuk templat Order Printer anda yang diimport

Apabila anda memigrasikan templat anda daripada aplikasi Order Printer legasi ke aplikasi Shopify Order Printer baharu, pemboleh ubah Liquid anda dikemas kini untuk memastikan keserasian dengan aplikasi baharu tersebut. Dalam keadaan yang jarang berlaku, anda mungkin perlu menyelesaikan masalah untuk templat anda yang diimport.

Jika templat anda yang diimport tidak dicetak dengan betul, anda mungkin perlu mengedit kod templat anda secara manual dalam aplikasi Shopify Order Printer baharu. Semak sebab paling biasa berikut tentang kemungkinan templat tidak diimport dengan betul:

Templat menyertakan CSS tersuai
Templat mengandungi medan meta
Pemboleh ubah Liquid mungkin tidak dikemas kini dengan betul

Pada halaman ini, anda boleh menemui maklumat terperinci tentang cara menyelesaikan masalah yang berpotensi timbul apabila mengimport templat tersuai anda ke aplikasi Shopify Order Printer baharu.

Pada halaman ini

Mengemas kini penyesuaian reka bentuk CSS biasa

Jika templat yang anda pindahkan menyertakan CSS tersuai, anda mungkin perlu mengemas kini kod CSS secara manual dalam templat anda untuk memaparkan elemen reka bentuk dengan betul, seperti imej, fon tersuai, logo atau kod bar.

Mengemas kini pemboleh ubah medan meta

Untuk mengakses medan meta, anda perlu menentukan ruang nama medan meta dan anda tidak perlu menambahkan .value pada pemboleh ubah tersebut. Ketahui lebih lanjut tentang definisi medan meta.

Contohnya, bukannya pemboleh ubah product.metafields.custom.manufacturerid.value, gunakan pemboleh ubah product.metafields.custom.manufacturerid.

Untuk mengenal pasti nilai ruang nama bagi setiap medan meta, rujuk halaman Data tersuai dalam pentadbir Shopify anda. Definisi medan meta dikumpulkan mengikut objek yang dirujuk, seperti produk, varian atau pesanan.

Mengemas kini pemboleh ubah Liquid biasa

Dalam kebanyakan kes, pemboleh ubah Liquid anda dikemas kini secara automatik semasa proses migrasi. Walau bagaimanapun, jika templat anda tidak berjaya dimigrasi dengan betul dan anda menggunakan mana-mana pemboleh ubah yang disenaraikan dalam bahagian ini, anda mungkin perlu menggantikan pemboleh ubah lama anda dengan pemboleh ubah baharu secara manual. Aplikasi Shopify Order Printer menggunakan pemboleh ubah yang berbeza daripada aplikasi Order Printer legasi.

Contohnya, jika anda menggunakan pemboleh ubah date, maka anda perlu menggantikannya dengan pemboleh ubah created_at.

Pemboleh ubah pesanan

Pemboleh ubah pesanan digunakan secara berbeza dalam aplikasi Shopify Order Printer. Untuk mengakses pemboleh ubah pesanan, anda perlu menambah awalan order.. Contohnya, untuk mengakses pemboleh ubah billing_address, anda perlu menggunakan order.billing_address.

Pemboleh ubah pesanan berikut yang biasa digunakan boleh diakses tanpa awalan order.:

line_items
tax_lines
fulfillments
transactions
refunds
shipping_methods
customer

Contohnya, jika anda ingin mengakses pemboleh ubah item baris, anda boleh menggunakan line_items atau order.line_items.

Anda juga boleh membuat alias sendiri untuk templat anda. Contohnya, anda boleh menggunakan sintaks Liquid {% assign fulfillments_count = order.fulfillments | size %} dan merujuk padanya dengan menggunakan {{ fulfillments_count }} dalam kod anda.

Pemboleh ubah pesanan
Pemboleh ubah dalam aplikasi Order Printer legasi	Pemboleh ubah dalam aplikasi Shopify Order Printer baharu
`line_items`	Item baris dibayar balik tidak disertakan dalam pemboleh ubah `line_items` . Semak butiran berikut: Anda boleh mengakses item baris bayaran balik dengan menggunakan pemboleh ubah `refunds.<each>.refund_line_items`. Semak contoh berikut. `{% assign refunded_line_items = refunds \| map: "refund_line_items" \| map: "line_item" %}` Anda boleh menggabungkan item baris bayaran balik dengan koleksi `line_items` jika anda mahu. Semak contoh berikut. `{% assign refunded_line_items = order.refunds \| map: "refund_line_items" \| map: "line_item" %} {% assign line_items_with_refunded = order.line_items \| concat: refunded_line_items \| uniq %}` Anda perlu memastikan bahawa anda menyertakan penapis `\| uniq` bagi mengelakkan penduaan item baris dibayar balik. Item baris tip tidak disertakan dalam pemboleh ubah `line_items` . Semak butiran berikut: Anda boleh mengakses item baris tip menggunakan pemboleh ubah `tip_line_items`. Anda boleh menggabungkan `tip_line_items` dengan koleksi `line_items` jika anda mahu. Semak contoh berikut. `{% assign line_items_with_tips = order.line_items \| concat: order.tip_line_items %}` Untuk meniru koleksi `line_items` Order Printer legasi, anda boleh menggunakan contoh kod berikut. `{% assign refunded_line_items = refunds \| map: "refund_line_items" \| map: "line_item" %} {% assign all_line_items = order.line_items \| concat: refunded_line_items \| concat: order.tip_line_items \| uniq %} {% for line_item in all_line_items %} ... {% endfor %}`
`credit_card`	Gunakan butiran pembayaran berdasarkan setiap transaksi pesanan dengan pemboleh ubah `transactions.<each>.payment_details`.
`current_shipping_price`	`shipping_price`
`date`	Gunakan pemboleh ubah `created_at`. Gunakan penapis `date` untuk memformatkan cap masa, contohnya dengan `{{ order.created_at \| date: "%B %e, %Y" }}`.
`gateways`	`unique_gateways` atau `transactions.<each>.gateway`
`order_currency`	`currency`
`processed_at`	Gunakan pemboleh ubah `created_at`. Pemboleh ubah ini memegang nilai `order.processed_at` daripada API GraphQL, yang bermaksud masa sebenar pesanan diproses, bukannya masa pesanan diimport ke Shopify. Perkara ini sama seperti `order.processed_at` daripada aplikasi Order Printer legasi. Anda boleh menggunakan penapis `date` untuk memformatkan cap masa, contohnya dengan `{{ order.created_at \| date: "%B %e, %Y" }}`.
`payment_transactions`	Tapis melalui `order.transactions` untuk mendapatkan status `kind` dalam sintaks Liquid dengan where, atau dengan membuat gelungan yang mempunyai `if` di dalamnya. Semak contoh berikut. `{% assign sale_transactions = order.transactions \| where: "kind", "sale" %} {% assign capture_transactions = order.transactions \| where: "kind", "capture" %} {% for transaction in transactions %} {% if transaction.kind == "sale" or transaction.kind == "capture" %} Transaction ID: {{ transaction.id }} Kind: {{ transaction.kind }} Amount: {{ transaction.amount \| money }} {% endif %} {% endfor %}` `{% assign sale_transactions = order.transactions \| where: "kind", "sale" %} {% assign capture_transactions = order.transactions \| where: "kind", "capture" %} {% assign payment_transactions = sale_transactions \| concat: capture_transactions %}`
`refund_transactions`	Tapis `order.transactions` untuk mencari status `kind` dalam sintaks Liquid menggunakan where, atau dengan menggunakan gelung yang mengandungi `if` di dalamnya, seperti contoh berikut. `{% assign refund_transactions = order.transactions \| where: "kind", "refund" %}`
`shipping_line`	`shipping_methods \| first`
`shipping_lines`	`shipping_methods`
`show_line_item_taxes`	`tax_lines.size > 0`. Anda boleh mentakrifkannya sebagai pemboleh ubah pada permulaan templat dan merujuk kepadanya beberapa kali, seperti contoh berikut. `{% if tax_lines.size > 0 %} {% assign show_line_item_taxes = true %} {% else %} {% assign show_line_item_taxes = false %} {% endif %}`
`total_tax`	`tax_price`
`total_paid`	`net_payment`

Pemboleh ubah LineItem

Pemboleh ubah LineItem
Pemboleh ubah dalam aplikasi Order Printer legasi	Pemboleh ubah dalam aplikasi Shopify Order Printer baharu
`fulfillable_quantity`	`quantity - successfully_fulfilled_quantity`
`fulfilled`	`quantity == successfully_fulfilled_quantity`
`name`	`title`
`product_title`	`product.title`
`unit_discount`	`quantity ? line_level_total_discount / quantity : 0`
`variant_title`	`variant.title`
`weight`	`grams`

Pemboleh ubah pemenuhan

pemboleh ubah pemenuhan
Pemboleh ubah dalam aplikasi Order Printer legasi	Pemboleh ubah dalam aplikasi Shopify Order Printer baharu
`date`	`created_at`

Pemboleh ubah Shop

Pemboleh ubah Shop
Pemboleh ubah dalam aplikasi Order Printer legasi	Pemboleh ubah dalam aplikasi Shopify Order Printer baharu
`owner`	`account_owner.name`
`address`	`shop.address.address1`
`address2`	`shop.address.address2`
`city`	`shop.address.city`
`country`	`shop.address.country`
`country_code`	`shop.address.country_code`
`province`	`shop.address.province`
`province_code`	`shop.address.province_code`
`zip`	`shop.address.zip`

Pemboleh ubah alamat

Pemboleh ubah alamat
Pemboleh ubah dalam aplikasi Order Printer legasi	Pemboleh ubah dalam aplikasi Shopify Order Printer baharu
`latitude`	Jika pemboleh ubah `address` telah dirujuk daripada atribut `location`, maka latitud dan longitud tersedia pada objek `location` itu sendiri.
`longitude`	Jika pemboleh ubah `address` telah dirujuk daripada atribut `location`, maka latitud dan longitud tersedia pada objek `location` itu sendiri.

Pemboleh ubah bayaran balik

Pemboleh ubah bayaran balik
Pemboleh ubah dalam aplikasi Order Printer legasi	Pemboleh ubah dalam aplikasi Shopify Order Printer baharu
`date`	Gunakan pemboleh ubah `created_at`. Gunakan penapis `date` untuk memformatkan cap masa, contohnya dengan `{{ order.created_at \| date: "%B %e, %Y" }}`.

Pemboleh ubah ShippingLine

Pemboleh ubah ShippingLine
Pemboleh ubah dalam aplikasi Order Printer legasi	Pemboleh ubah dalam aplikasi Shopify Order Printer baharu
`current_price`	`price`
`price`	`original_price`

Pemboleh ubah transaksi

Pemboleh ubah transaksi yang berikut telah dialih keluar dan tidak boleh digantikan dalam aplikasi Shopify Order Printer:

authorization
message
test

Pemboleh ubah varian

pemboleh ubah varian
Pemboleh ubah dalam aplikasi Order Printer legasi	Pemboleh ubah dalam aplikasi Shopify Order Printer baharu
`grams`	`weight`

Pemboleh ubah medan meta

Untuk mengakses medan meta, anda perlu menentukan Ruang Nama medan meta dan tidak perlu menambahkan .value pada pemboleh ubah tersebut. Ketahui lebih lanjut tentang takrifan medan meta.

Sebagai contoh, gunakan pemboleh ubah product.metafields.custom.manufacturerid dan bukannya pemboleh ubah product.metafields.manufacturerid.value.

Untuk mengenal pasti nilai Ruang Nama bagi setiap medan meta, rujuk halaman Data tersuai dalam pentadbir Shopify anda. Takrifan medan meta dikumpulkan mengikut objek yang dirujuknya, seperti produk, varian atau pesanan.

Pemetaan penapis

Pemetaan penapis
Nama penapis dalam aplikasi Order Printer legasi	Nama penapis dalam aplikasi Shopify Order Printer yang baharu
`files_url`	`file_url`
`payment_method` dan `payment_methods`	Gunakan medan transaction.gateway_display_name pada transaksi pesanan. Kaedah pembayaran tidak lagi dikategorikan kepada jenis tertentu, seperti `{kad kredit, kad debit, pindahan bank}`. Aplikasi Order Printer legasi memetakan hanya sebahagian kecil gerbang pembayaran yang sedang berfungsi kepada kategori ini. Penyedia gerbang pembayaran mengurus jenis kaedah pembayaran yang digunakan oleh pelanggan di pihak mereka.