Shopify POS için basılı makbuz kod düzenleyicisi

Basılı makbuzlarınızı, Shopify yöneticinizdeki kod düzenleyiciyi kullanarak özelleştirebilirsiniz. Makbuzlarınızı oluşturan dosyalar, Shopify'ın şablon dili olan Liquid'i içerir. Kod düzenleyici ile görsel düzenleyiciye kıyasla HTML, CSS ve Liquid'i kullanarak daha gelişmiş özelleştirmeler oluşturabilirsiniz.

Makbuz şablonunu ve basılı makbuzlarınızda kullanılan bölüm şablonlarını değiştirebilirsiniz. Makbuzlar şablon dosyaları, mağazanızda yazdırabileceğiniz makbuz türleridir. Bölümler; üstbilgi veya altbilgi gibi, makbuzların parçalarıdır. Bölümler, birden fazla makbuz tarafından yeniden kullanılabilir.

Makbuz kod düzenleyicisini kullanmayla ilgili dikkat edilmesi gerekenler

Makbuz kod düzenleyicisini kullanmadan önce aşağıdaki önemli noktaları gözden geçirin:

Erişim kısıtlamaları

• Kod düzenleyiciyi yalnızca masaüstündeki Shopify yöneticinizden kullanabilirsiniz.
• Kod düzenleyicisi İtalya'daki hiçbir POS konumu için kullanılamaz.

Değişikliklerin geçerli olduğu yerler

• Yaptığınız kod değişiklikleri yalnızca seçilen konum için geçerli olur.
• Kod düzenleyicisindeki özelleştirmeler yalnızca POS Pro konumları için geçerlidir. Kod düzenleyiciyi kullanıyorsanız ve POS Pro olmayan konumlarınız varsa bu konumlar için üstbilgi ve altbilgiyi özelleştirmek üzere görsel düzenleyiciyi kullanabilirsiniz.
• Satış fişleri, hediye fişleri, hediye kartı fişleri ve iade ve değişim fişleri gibi, kod düzenleyicide şablonu olan basılı fişleri kişiselleştirebilirsiniz.

Kod dilleri

• Makbuzlarınızı oluşturan dosyalar, Shopify'ın şablon dili olan Liquid'i içerir. Liquid kullanımı hakkında daha fazla bilgi edinin.
• Makbuz kodu düzenleyicisindeki şablonları düzenlemek için HTML, CSS ve Liquid'e aşina olmanız gerekir. Shopify Tema Desteği, Shopify Tasarım Politikası kapsamında küçük düzenlemeler konusunda yardımcı olabilir.

Özelleştirme sınırlamaları

• Kod düzenleyicisinden makbuzları farklı yazıcı boyutlarında önizleyemezsiniz. Yazıcı boyutuna göre önizleme yapmak için görsel düzenleyiciyi kullanın.
• Ürün tanımları, makbuz şablonlarında değişken olarak kullanılamaz ve yazdırılan makbuzlara eklenemez.

Şablon bakımı

• Bir makbuzu makbuz kodu düzenleyicisiyle özelleştirirseniz mevcut şablonunuzda selling_plan_name gibi yeni özellikler eksik olabilir. Mevcut en yeni özellikleri şablonunuza eklemek için makbuz şablonunuzu varsayılana sıfırlamanız gerekir. Makbuz şablonlarını varsayılana sıfırlamak, bunlarda yaptığınız tüm özelleştirmeleri kaldırır. Sıfırlamadan önce özelleştirilmiş kodunuzu not edin. Şablonu sıfırladıktan sonra özelleştirmelerinizi manuel olarak yeniden uygulamanız gerekir.

Kod düzenleyiciye erişme

Şablonlarınızı kod düzenleyiciyi kullanarak düzenleyebilirsiniz. Öncelikle, varsayılan görsel düzenleyiciden kod düzenleyiciyi kullanmaya geçmeniz gerekir ve istediğiniz zaman görsel düzenleyiciye geri dönebilirsiniz.

Düzenleyiciler arasında geçiş yapma adımları; tüm POS konumlarınızın kod düzenleyicisi için uygun olup olmamasına veya yalnızca bazı POS konumlarınızın uygun olmasına (örneğin, bazı POS konumlarınızın POS Pro kullanmaması veya İtalya'da ya da Fransa'da bulunması) bağlı olarak biraz farklılık gösterir.

Adımlar:

Fiş şablonunuzda özel dosyalar kullanma

Basılı fişlerinizi kişiselleştirmek için Shopify yöneticinize yüklediğiniz görsel öğeleri gibi dosyaları kullanabilirsiniz.

Bir dosyanın basılı bir makbuzda kullanılabilmesi için Shopify yöneticinize yüklenmesi gerekir. Dosya yüklemeleri hakkında daha fazla bilgi edinin.

Adımlar:

1. Shopify yöneticinizden İçerik > Dosyalar bölümüne gidin.

2. Basılı fiş kodunuza eklemek istediğiniz dosyanın yanındaki simgesine tıklayarak bağlantıyı kopyalayın.

3. Kod düzenleyiciye gidin.

4. Dosya bağlantısını şablonunuza ekleyin.

Fiş şablonunuzu varsayılana sıfırlama

Kod düzenleyiciyi kullanarak bir fiş şablonunu varsayılan sürüme sıfırlayabilirsiniz.

Adımlar:

Fiş kodu düzenleyicisinde kullanılabilen Liquid değişkenleri

Basılı makbuz şablonunuzu ve makbuz türlerinizi özelleştirmek için Liquid'i kullanabilirsiniz.

Aşağıdaki veri nesneleri fiş kodu düzenleyicisinde kullanılabilir:

Fiş nesneleri

shop

location

order

return

gift_card

Sipariş nesnesi

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

İade nesnesi

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

Kargo grubu nesnesi

destination

products

Satır öğesi nesnesi

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

İade satır öğesi nesnesi

Satır öğesi nesnesindeki her şeyi ve ek olarak aşağıdaki özellikleri içerir:

return_reason

return_reason_note

Makbuz kodu düzenleyicisinde bulunan Liquid filtreleri

Makbuz şablonlarınızdaki bilgilerde düzenlemeler yapmak için Liquid filtrelerini kullanabilirsiniz. Örneğin para biriminin biçimlendirmesini veya vergi kodu gibi belirli bir metnin büyük/küçük harf kullanımını değiştirebilirsiniz.

Bir filtre uygulamak için çift küme parantezleri {{ }} arasındaki Liquid kodu bloğuna bir dikey çizgi karakteri (|) ve ardından filtrenin kendisini ekleyin. Filtreler yalnızca Liquid kodu bloklarına uygulanabilir.

Aşağıdaki örnekte filtre, vergi kodunu küçük harften büyük harfe dönüştürür.

{{ tax_line.title | upcase }}

Örnek kod bloğunda product nesne, title onun özelliği ve upcase de uygulanan filtredir. upcase filtresi, tax_line.title değerini büyük harfe dönüştürür. Örneğin tax_line.title öğesinin değeri Hst ise upcase filtresi bu değeri HST olarak değiştirir.

Liquid filtrelerinin nasıl kullanılacağına ilişkin ayrıntılar için Shopify Temaları Liquid referansındaki Filtreler bölümüne bakın.

Makbuz kodu düzenleyicisinde aşağıdaki filtreler mevcuttur:

t

money

escape

barcode

qrcode

Yazdırılan makbuz şablonu kodu kişiselleştirme örneği

Koşullu mesajlar eklemek için Liquid'i kullanabilirsiniz. Bu işlevsellik, görsel düzenleyici ile tek bir konuma kaydetmeye benzer. Örneğin, işletmeniz tek bir konumla başladı ve şimdi birkaç yeni konumunuz var. Basılı makbuzlarınızda orijinal mağazanızı vurgulamak istiyorsunuz.

Kod düzenleyicinin Bölümler klasöründeki header.liquid şablonuna özel bir mesaj ekleyebilir ve bu mesajı yalnızca ana konumunuz için görüntülemek üzere Liquid'i kullanabilirsiniz.

Aşağıdaki kod, bu örnekte "Home" olarak adlandırılan orijinal konumunuzun adını kontrol eder ve konum adla eşleşirse "1972'de açılan orijinal mağazamıza hoş geldiniz." mesajını görüntüler. Diğer konumlarınızdan yazdırılan makbuzlarda bunun yerine "Mağazamıza hoş geldiniz." mesajı görüntülenir.

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

Kod düzenleyicisinde kod değişikliklerinizi önizleme

Shopify yöneticisindeki POS kod düzenleyicisinde basılı makbuzlarınızda yapılan değişiklikleri önizleyebilirsiniz.

Hangi Liquid dosyasının seçildiğine bağlı olarak önizleme penceresi, makbuzun dosyadan etkilenen tasarımını veya bölümünü vurgular. Önizleme penceresi varsayılan olarak en son POS siparişinizin içeriğini görüntüler. gift-card.liquid dosyası hariç tüm Liquid dosyaları için önizleme penceresinde makbuz içeriğiniz olarak kullanılacak belirli bir siparişi seçebilirsiniz. gift-card.liquid dosyasında, seçilebilir önizleme seçenekleri olarak yalnızca farklı konumlar görüntülenir.

Adımlar: