İçe aktarılan Order Printer şablonlarınızla ilgili sorunları giderme

Şablonlarınızı eski Order Printer uygulamasından yeni Shopify Order Printer uygulamasına taşıdığınızda, Liquid değişkenleriniz yeni uygulamayla uyumluluğu sağlamak için güncellenir. Nadir durumlarda, içe aktarılan şablonlarınızdaki hataları gidermeniz gerekebilir.

İçe aktarılan şablonlarınız doğru şekilde yazdırılmıyorsa yeni Shopify Order Printer uygulamasında şablonunuzun kodunu manuel olarak düzenlemeniz gerekebilir. Şablonların doğru şekilde içe aktarılamamasının en yaygın nedenlerini aşağıda inceleyin:

Şablonlar özel CSS içeriyor
Şablonlar meta alanlar içeriyor
Liquid değişkenleri doğru güncellenmeyebilir

Bu sayfada, özel şablonlarınızı yeni Shopify Order Printer uygulamasına içe aktarırken karşılaşabileceğiniz olası sorunları nasıl gidereceğinize ilişkin ayrıntılı bilgileri bulabilirsiniz.

Bu sayfada

Yaygın CSS tasarım kişiselleştirmelerini güncelleme

Aktardığınız şablonlar özel CSS içeriyorsa görseller, özel yazı tipleri, logolar veya barkodlar gibi tasarım öğelerini doğru şekilde görüntülemek için şablonlarınızdaki CSS kodunu manuel olarak güncellemeniz gerekebilir.

Meta alan değişkenlerini güncelleme

Bir meta alana erişmek için meta alanın ad alanını belirtmeniz gerekir ve değişkene .value eklemeniz gerekmez. Meta alan tanımları hakkında daha fazla bilgi edinin.

Örneğin, product.metafields.custom.manufacturerid.value değişkeni yerine product.metafields.custom.manufacturerid değişkenini kullanın.

Her bir meta alanın ad alanı değerlerini belirlemek için Shopify yöneticinizdeki Özel veriler sayfasına bakın. Meta alan tanımları; ürünler, varyasyonlar veya siparişler gibi atıfta bulundukları nesnelere göre gruplandırılır.

Yaygın Liquid değişkenlerini güncelleme

Çoğu durumda, Liquid değişkenleriniz geçiş işlemi sırasında otomatik olarak güncellenir. Ancak şablonlarınız doğru şekilde taşınmazsa ve bu bölümde listelenen değişkenlerden herhangi birini kullanıyorsanız eski değişkenlerinizi yenileriyle manuel olarak değiştirmeniz gerekebilir. Shopify Order Printer uygulaması, eski Order Printer uygulamasından farklı değişkenler kullanır.

Örneğin, date değişkenini kullanıyorsanız bunu created_at değişkeniyle değiştirmeniz gerekir.

Sipariş değişkenleri

Sipariş değişkenleri, Shopify Order Printer uygulamasında farklı şekilde kullanılır. Sipariş değişkenlerine erişmek için order. ön ekini eklemeniz gerekir. Örneğin, billing_address değişkenine erişmek için order.billing_address kullanmanız gerekir.

Aşağıdaki yaygın olarak kullanılan sipariş değişkenlerine order. ön eki olmadan erişilebilir:

line_items
tax_lines
fulfillments
transactions
refunds
shipping_methods
customer

Örneğin, satır öğeleri değişkenine erişmek isterseniz line_items veya order.line_items kullanabilirsiniz.

Şablonunuz için kendi takma adlarınızı da oluşturabilirsiniz. Örneğin, {% assign fulfillments_count = order.fulfillments | size %} Liquid söz dizimini kullanabilir ve ardından kodunuzda {{ fulfillments_count }} kullanarak buna başvurabilirsiniz.

Sipariş değişkeni
Eski Order Printer uygulamasındaki değişken	Yeni Shopify Order Printer uygulamasındaki değişken
`line_items`	Para iadesi yapılmış satır öğeleri kapsamına dahil değildir `line_items` değişkenine dahil değildir. Aşağıdaki ayrıntıları inceleyin: Para iadesi yapılan satır öğelerine `refunds.<each>.refund_line_items` değişkenini kullanarak erişebilirsiniz. Aşağıdaki örneği inceleyin. `{% assign refunded_line_items = refunds \| map: "refund_line_items" \| map: "line_item" %}` İsterseniz para iadesi yapılan satır öğelerini `line_items` koleksiyonuna birleştirebilirsiniz. Aşağıdaki örneği inceleyin. `{% 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 %}` Para iadesi yapılmış satır öğelerinin yinelenmesini önlemek için `\| uniq` filtresini eklediğinizden emin olun. Bahşiş satır öğeleri kapsamına dahil değildir `line_items` değişkenine dahil değildir. Aşağıdaki ayrıntıları inceleyin: Bahşiş satır öğelerine `tip_line_items` değişkenini kullanarak erişebilirsiniz. İsterseniz `tip_line_items` koleksiyonunu `line_items` koleksiyonuyla birleştirebilirsiniz. Aşağıdaki örneği inceleyin. `{% assign line_items_with_tips = order.line_items \| concat: order.tip_line_items %}` Eski Order Printer `line_items` koleksiyonunu taklit etmek için aşağıdaki örnek kodu kullanabilirsiniz. `{% 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`	Siparişteki her bir işlemin ödeme ayrıntıları için `transactions.<each>.payment_details` değişkenini kullanın.
`current_shipping_price`	`shipping_price`
`date`	`created_at` değişkenini kullanın. Zaman damgasını biçimlendirmek için `date` filtresini kullanın. Örneğin: `{{ order.created_at \| date: "%B %e, %Y" }}`.
`gateways`	`unique_gateways` veya `transactions.<each>.gateway`
`order_currency`	`currency`
`processed_at`	`created_at` değişkenini kullanın. Bu değişken, siparişin Shopify'a aktarıldığı zamanı değil, işlendiği gerçek zamanı ifade eden GraphQL API'deki `order.processed_at` değerini içerir. Eski Order Printer uygulamasındaki `order.processed_at` ile aynıdır. Zaman damgasını biçimlendirmek için `date` filtresini, örneğin `{{ order.created_at \| date: "%B %e, %Y" }}` şeklinde kullanabilirsiniz.
`payment_transactions`	Liquid söz diziminde, where ile veya bir döngü ve içinde `if` ifadesi kullanarak `order.transactions` öğelerini `kind` durumuna göre filtreleyin. Aşağıdaki örnekleri inceleyin. `{% 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" %} İşlem ID'si: {{ transaction.id }} Tür: {{ transaction.kind }} Tutar: {{ 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`	`order.transactions` üzerinden `kind` durumunu where ile Liquid söz diziminde filtreleyin veya aşağıdaki örnekte olduğu gibi döngü ve içinde bir `if` kullanın. `{% 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`. Şablonun başında bunu bir değişken olarak tanımlayabilir ve aşağıdaki örnekte olduğu gibi bu değişkene birden fazla kez başvurabilirsiniz. `{% 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`

Satır öğesi değişkenleri

Satır öğesi değişkeni
Eski Order Printer uygulamasındaki değişken	Yeni Shopify Order Printer uygulamasındaki değişken
`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`

Gönderim değişkenleri

Gönderim değişkeni
Eski Order Printer uygulamasındaki değişken	Yeni Shopify Order Printer uygulamasındaki değişken
`date`	`created_at`

Mağaza değişkenleri

Mağaza değişkeni
Eski Order Printer uygulamasındaki değişken	Yeni Shopify Order Printer uygulamasındaki değişken
`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`

Adres değişkenleri

Adres değişkeni
Eski Order Printer uygulamasındaki değişken	Yeni Shopify Order Printer uygulamasındaki değişken
`latitude`	`address` değişkenine `location` özelliğinden referans verildiyse enlem ve boylam doğrudan `location` nesnesinde bulunur.
`longitude`	`address` değişkenine `location` özelliğinden referans verildiyse enlem ve boylam doğrudan `location` nesnesinde bulunur.

Para iadesi değişkenleri

Para iadesi değişkeni
Eski Order Printer uygulamasındaki değişken	Yeni Shopify Order Printer uygulamasındaki değişken
`date`	`created_at` değişkenini kullanın. Zaman damgasını biçimlendirmek için `date` filtresini kullanın. Örneğin: `{{ order.created_at \| date: "%B %e, %Y" }}`.

Kargo satırı değişkenleri

Kargo satırı değişkeni
Eski Order Printer uygulamasındaki değişken	Yeni Shopify Order Printer uygulamasındaki değişken
`current_price`	`price`
`price`	`original_price`

İşlem değişkenleri

Aşağıdaki işlem değişkenleri, Shopify Order Printer uygulamasından kaldırılmıştır ve değiştirilemezler:

authorization
message
test

Varyasyon değişkenleri

varyasyon değişkeni
Eski Order Printer uygulamasındaki değişken	Yeni Shopify Order Printer uygulamasındaki değişken
`grams`	`weight`

Meta alan değişkenleri

Bir meta alana erişmek için meta alanın Ad Alanı'nı belirtmeniz gerekir ve değişkene .value eklemeniz gerekmez. Meta alan tanımları hakkında daha fazla bilgi edinin.

Örneğin, product.metafields.manufacturerid.value değişkeni yerine product.metafields.custom.manufacturerid değişkenini kullanın.

Her bir meta alan için Ad Alanı değerlerini belirlemek üzere Shopify yöneticinizdeki Özel veriler sayfasına bakın. Meta alan tanımları, ürünler, varyasyonlar veya siparişler gibi, referans verdikleri nesnelere göre gruplandırılır.

Filtre eşlemesi

Filtre eşlemesi
Eski Order Printer uygulamasındaki filtre adı	Yeni Shopify Order Printer uygulamasındaki filtre adı
`files_url`	`file_url`
`payment_method` ve `payment_methods`	Sipariş işlemlerinde transaction.gateway_display_name alanını kullanın. Ödeme yöntemleri artık `{kredi kartı, banka kartı, banka havalesi}` gibi belirli türler altında kategorize edilmemektedir. Eski Order Printer uygulaması, şu anda çalışan ödeme ağ geçitlerinin yalnızca küçük bir alt kümesini bu kategorilerle eşliyordu. Ödeme ağ geçidi sağlayıcıları, müşteriler tarafından kullanılan ödeme yöntemi türlerini kendi taraflarında yönetir.