Order Printer uygulamasından Shopify Order Printer uygulamasına geçiş yapma

Eski Order Printer uygulamasında özel şablonlarınız varsa şablonlarınızı Shopify Order Printer uygulamasına taşımanız gerekir.

Şablonlarınızı taşımak için, mevcut şablonlarınızı Shopify Order Printer uygulamasına aktarabilirsiniz. Ancak yeni Shopify Order Printer uygulamasında kodlar, eski Order Printer uygulamasından biraz farklı bir şekilde çalışır. Bu, mevcut şablonlardan bazılarının başlangıçta çalışmayabileceği ve şablon kodunda bazı düzenlemeler yapmanız gerekebileceği anlamına gelir.

Şablonlarınızın yeni uygulamada çalışması için eski değişkenleri yeni değişkenlerle değiştirmeniz gerekir. Örneğin, date değişkenini kullanıyorsanız bunu created_at ile değiştirmeniz gerekir.

Bu sayfada, Shopify Order Printer uygulamasında yenileriyle değiştirmeniz gereken değişkenlerin listesi bulabilirsiniz.

Mevcut şablonlarınızı taşımayla ilgili önemli hususlar

Mevcut şablonlarınızı Shopify Order Printer uygulamasına taşımadan önce aşağıdaki hususları gözden geçirin:

• Mevcut şablonlarınızı taşımak için HTML, CSS ve Liquid hakkında bilgi sahibi olmanız gerekir. Shopify Tema Desteği ekibi, Shopify Tasarım Politikası dahilinde ufak düzenlemeler konusunda size yardımcı olabilir.
• Desteklenen tüm şablon kişiselleştirmeleri için Shopify Order Printer için Liquid değişkenleri ve filtreler referansı sayfasına bakın.
• Mevcut şablonlarınızda özel CSS kullanılıyorsa kodu manuel olarak aktararak yeni uygulamada düzenlemeniz gerekir.
• Shopify Order Printer uygulamasında sipariş değişkenlerine erişmek için order (sipariş) ön ekini eklemeniz gerekir.
• Mevcut şablonlar içe aktarılırken meta alanlar aktarılmaz. Meta alan içeren şablonları manuel olarak taşımanız gerekebilir.

Mevcut şablonlarınızı Shopify Order Printer uygulamasına taşıma

Eski Order Printer uygulamasında mevcut şablonlarınız varsa bunları Shopify Order Printer uygulamasına aktarabilirsiniz. Belirli şablonları içe aktaramazsınız; tüm şablonları aynı anda içe aktarmanız gerekir.

Adımlar:

1. Shopify yöneticinizde, Ayarlar > Uygulamalar ve satış kanalları'na tıklayın.
2. Order Printer seçeneğine tıklayın.

3. Uygulamayı aç'a tıklayın.

4. Şablonlar'a tıklayın.

5. İçe aktar'a tıklayın.

6. İletişim kutusunda İçe Aktar'a tıklayın.

7. Şablonlarınızda eski değişkenlerden herhangi birinin olup olmadığını gözden geçirip bunları yeni değişkenlerle değiştirin.

8. Şablonlarınızın önizlemesini gözden geçirip doğru şekilde göründüklerinden emin olun.

9. İsteğe bağlı: Test belgeleri yazdırın.

Shopify Order Printer uygulamasında sipariş değişkenlerini kullanma

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 kullanmanız gerekir. Örneğin, billing_address değişkenine erişmek için order.billing_address ifadesini kullanmanız gerekir.

Yaygın olarak kullanılan aşağıdaki 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 istiyorsanız 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özdizimini kullanabilir ve buna, kodunuzda {{ fulfillments_count }} ifadesini kullanarak referans verebilirsiniz.

Değişken eşleştirme

Shopify Order Printer uygulamasında, eski Order Printer uygulamasından farklı değişkenler kullanılır. Mevcut şablonlarınızda, bu bölümde listelenen değişkenlerden herhangi biri kullanılıyorsa eski değişkenlerinizi yeni değişkenlerle değiştirmeniz gerekir.

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

Sipariş değişkenleri

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ılan satır öğeleri, line_items değişkenine dahil edilmez. Aşağıdaki ayrıntıları gözden geçirin: Para iadesi yapılan satır öğelerine refunds.<each>.refund_line_items değişkenini kullanarak erişebilirsiniz. Aşağıdaki örneği gözden geçirin. {% assign refunded_line_items = refunds | map: "refund_line_items" | map: "line_item" %} İsterseniz para iadesi yapılan satır öğelerini line_items koleksiyonuna ekleyebilirsiniz. Aşağıdaki örneği gözden geçirin. {% 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ılan satır öğelerinin çoğaltılmaması için | uniq filtresini siparişe dahil etmeniz gerekir. Bahşiş satır öğeleri, line_items değişkenine dahil edilmez. Aşağıdaki ayrıntıları gözden geçirin: Bahşiş satır öğelerine, tip_line_items değişkenini kullanarak erişebilirsiniz. İsterseniz tip_line_items öğesini line_items koleksiyonuna ekleyebilirsiniz. Aşağıdaki örneği gözden geçirin. {% 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şleme göre ödeme ayrıntılarını kullanmak için transactions.<each>.payment_details değişkenini kullanın.
current_shipping_price	shipping_price
tarih	created_at değişkenini kullanın. Zaman damgasını biçimlendirmek için date (tarih) filtresini kullanın (örneğin, {{ order.created_at | date: "%B %e, %Y" }} ile).
ağ geçitleri	unique_gateways veya transactions.<each>.gateway
order_currency	para birimi
processed_at	created_at değişkeni kullanın. Bu, GraphQL API'deki order.processed_at değerini tutar ve Shopify'a aktarıldığı saat yerine siparişin işlendiği gerçek zamanı ifade eder. Eski Order Printer uygulamasındaki order.processed_at ile aynıdır. Zaman damgasını biçimlendirmek için date (tarih) filtresini kullanabilirsiniz (örneğin, {{ order.created_at | date: "%B %e, %Y" }} ile).
payment_transactions	Liquid söz diziminde order.transactions'ı, where veya bir döngü içinde if kullanarak, kind (tür) durumu için filtreleyin. Aşağıdaki örnekleri gözden geçirin. {% 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 Kimliği: {{ 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	Liquid söz diziminde order.transactions'ı, aşağıdaki örnekte olduğu gibi where veya döngü içinde if kullanarak, kind (tür) durumu için filtreleyin. {% 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. Aşağıdaki örnekte olduğu gibi bunu şablonun başında bir değişken olarak tanımlayabilir ve bir defadan fazla 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

LineItem değişkenleri

LineItem 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
gönderildi	quantity == successfully_fulfilled_quantity
ad	title
product_title	product.title
unit_discount	quantity ? line_level_total_discount / quantity : 0
variant_title	variant.title
ağırlık	gram

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
tarih	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
sahip	account_owner.name
adres	shop.address.address1
address2	shop.address.address2
city	shop.address.city
ülke	shop.address.country
country_code	shop.address.country_code
province	shop.address.province
province_code	shop.address.province_code
posta kodu	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	location özelliğinde address değişkenine referans verilmişse enlem ve boylam, konum nesnesinin üzerinde bulunur.
longitude	location özelliğinde address değişkenine referans verilmişse enlem ve boylam, konum nesnesinin üzerinde 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
tarih	created_at değişkenini kullanın. Zaman damgasını biçimlendirmek için date (tarih) filtresini kullanın (örneğin, {{ order.created_at | date: "%B %e, %Y" }} ile).

ShippingLine değişkenleri

ShippingLine değişkeni

Eski Order Printer uygulamasındaki değişken	Yeni Shopify Order Printer uygulamasındaki değişken
current_price	fiyat
fiyat	original_price

İşlem değişkenleri

Aşağıdaki işlem değişkenleri kaldırılmıştır ve Shopify Order Printer uygulamasında bir başka değişkenle değiştirilemez:

• 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
gram	ağırlık

Meta alan değişkenleri

Bir meta alana erişmek için meta alanın Ad alanına ihtiyacınız vardır 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 tanımlamak amacıyla Shopify yöneticinizdeki Özel veriler sayfasına bakın. Meta alan tanımları yönlendirdikleri nesnelere (ör. ürünler, varyasyonlar veya siparişler) göre gruplandırılır.

Filtre eşleştirme

Filtre eşleştirme

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ürlerle kategorize edilmemektedir. Eski Order Printer uygulaması, şu anda çalışmakta olan ödeme ağ geçitlerinin yalnızca küçük bir alt kümesini bu kategorilerle eşleştiriyordu. Ödeme ağ geçidi sağlayıcıları, müşteriler tarafından kendi taraflarında kullanılan ödeme yöntemi türlerini yönetir.