Yazdırılan makbuz kodu düzenleyicisi

Yazdırılan makbuzlarınızı, Shopify yöneticinizde kod düzenleyicisini kullanarak kişiselleştirebilirsiniz. Kod düzenleyicisinde HTML, CSS ve Liquid kullanarak görsel düzenleyicisine göre daha gelişmiş kişiselleştirmeler oluşturabilirsiniz.

Yazdırılan makbuzlarınızda kullanılan makbuz şablonunu ve bölüm şablonlarını değiştirebilirsiniz. Makbuz şablonu dosyaları, mağazanızda yazdırabileceğiniz makbuz türleridir. Bölümler, makbuzların üstbilgi veya altbilgi gibi kısımlarıdır. Bölümler, birden fazla makbuzda yeniden kullanılabilir.

Bu sayfada

Makbuz kod düzenleyicisini kullanmayla ilgili önemli hususlar

Makbuz kodu düzenleyicisini kullanmadan önce aşağıdaki hususları gözden geçirin:

Kod düzenleyicisini yalnızca masaüstü bir cihazda Shopify yöneticinizden kullanabilirsiniz.
Yaptığınız kod değişiklikleri tüm POS Pro konumlarında geçerli olur. Bununla birlikte, belirli konumlara özgü kişiselleştirmeleri göstermek için koşullar ekleyebilirsiniz. Liquid ile denetim akışı etiketlerini kullanma hakkında daha fazla bilgi edinin.
Kod düzenleyicisine geçiş yaptığınızda, makbuz şablonunuzda kişiselleştirmeler yapmak için Shopify POS uygulamasını kullanamazsınız. POS Pro abonelik planına sahip konumlarda, Shopify POS uygulamasından Yazdırma Seçeneklerinizi düzenlemeye devam edebilirsiniz.
Kod düzenleyicisinde yapılan kişiselleştirmeler yalnızca POS Pro konumlarına uygulanır. Kod düzenleyicisini kullanıyorsanız ve POS Lite konumlarına sahipseniz Lite konumlarınızın üstbilgi ve altbilgi bölümlerini kişiselleştirmek için görsel düzenleyicisini kullanabilirsiniz.
Makbuzlarınızı oluşturan dosyalar, Shopify'ın şablon dili olan Liquid'i içerir. Liquid'i kullanma hakkında daha fazla bilgi edinin.
Şablonları makbuz kod düzenleyicisinde düzenlemek 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.
Bazı yazdırılan makbuz türleri kişiselleştirilemez.
Kod düzenleyicisi, İtalya'daki konumlarda kullanılamaz.

Makbuz türlerinin uyumsuzluğuyla ilgili önemli hususları

Bazı yazdırılan makbuz türleri, makbuz kodu düzenleyicisinde kişiselleştirilemez. Kod düzenleyicisinde şablonu olmayan makbuz türleri kişiselleştirme için uyumlu değildir.

Aşağıdaki yazdırılan makbuz türlerini kişiselleştirebilirsiniz:

Satış makbuzları
Hediye kartı makbuzları
Hediye kartı makbuzları

Aşağıdaki makbuzları kişiselleştiremezsiniz:

İade makbuzları
Değişim makbuzları

Ayrıca, İtalya'daki tüm konumlar için tüm makbuz türleri kişiselleştirmeye uygun değildir.

Kod düzenleyicisine erişme

Şablonlarınızı, kod düzenleyicisini kullanarak düzenleyebilirsiniz.

Adımlar:

Shopify yöneticinizde, Ayarlar > Uygulamalar ve satış kanalları'na tıklayın.
Uygulamalar ve satış kanalları sayfasından Point of sale seçeneğine tıklayın.
Satış kanalını aç'a tıklayın.
Ayarlar > Makbuz Özelleştirme'ye tıklayın.
Makbuzları özelleştirin'e tıklayın.
... > Kodu düzenle'ye tıklayın.
Kodu düzenleyin iletişim kutusunda Kodu düzenle'ye tıklayın.

Makbuz şablonunuzda özel dosyaları kullanma

Makbuzlarınızı kişiselleştirmek için, yüklediğiniz dosyaları kullanabilirsiniz. Makbuzların üzerine yazdırmak istediğiniz özel görseller varsa bunları Shopify yöneticinize yükleyebilir ve kişiselleştirilmiş makbuzlarınızda kullanabilirsiniz. Dosya yükleme hakkında daha fazla bilgi edinin.

Adımlar:

Shopify yöneticinizde, Ayarlar > Uygulamalar ve satış kanalları'na tıklayın.
Uygulamalar ve satış kanalları sayfasından Point of sale seçeneğine tıklayın.
Satış kanalını aç'a tıklayın.
Ayarlar > Makbuz Özelleştirme'ye tıklayın.
Makbuzları özelleştirin'e tıklayın.
İçerik sayfasına tıklayın.
Makbuz şablonunuzda kullanmak istediğiniz dosyanın yanındaki bağlantıyı kopyalayın.
Bağlantıyı şablonunuza ekleyin.

Makbuz şablonunuzu varsayılana sıfırlama

Kod düzenleyicisini kullanarak bir makbuz şablonunu varsayılan sürümüne sıfırlayabilirsiniz.

Adımlar:

Shopify yöneticinizde, Ayarlar > Uygulamalar ve satış kanalları'na tıklayın.
Uygulamalar ve satış kanalları sayfasından Point of sale seçeneğine tıklayın.
Satış kanalını aç'a tıklayın.
Ayarlar > Makbuz Özelleştirme'ye tıklayın.
Sıfırlamak istediğiniz şablona tıklayın.
Sıfırlama simgesine tıklayın.
Dosyayı varsayılana sıfırla modunda, onaylamak için Sıfırla'ya tıklayın.

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

Yazdırılan makbuz şablonlarınızı ve makbuz türlerinizi kişiselleştirmek için Liquid'i kullanabilirsiniz.

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

Makbuz veri nesnelerinin açıklamaları
Nesne	Açıklama
shop	Mağaza adı gibi mağaza bilgilerini içerir.
location	Perakende satış konumunun, adres ve telefon numarası gibi bilgilerini içerir.
order	Satır öğeleri, indirimler, vergiler ve işlem bilgileri de dahil olmak üzere sipariş verilerini içerir.
gift_card	Yalnızca `gift_card.liquid` şablonu içinde kullanılabilir. Bakiye, alfasayısal kod ve POS uygulaması tarafından taranabilecek bir QR kodunun içeriği de dahil olmak üzere, hediye kartı verilerini içerir.

Makbuz kodu düzenleyicisinde kullanılabilecek Liquid filtreleri

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

Filtre uygulamak için bir dikey çizgi karakterinin | ardından, liquid kodu bloğunun içinde, iki adet kıvrımlı parantez arasında filtreyi ekleyin {{ }}. Filtreler yalnızca liquid kodunun bloklarına uygulanabilir.

Aşağıdaki örnekte filtre, küçük harf olan vergi kodunu büyük harf olarak değiştirir.

{{ tax_line.title | upcase }}

Örnek kod bloğunda product nesne, title nesnenin özelliği, upcase ise filtredir. upcase filtresi, küçük harf olan tax_line.title değerini büyük harfle değiştirir. Örneğin, tax_line.title için mevcut değer Hst ise upcase filtresi, bu değeri HST olarak değiştirir.

Liquid filtrelerinin nasıl kullanılacağıyla ilgili ayrıntılı bilgi için Shopify Temaları Liquid referansının filtreler bölümüne bakın.

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

Makbuz filtrelerinin açıklaması
Özellik	Açıklama
t	Önceden tanımlanmış etiketleri, konumunuza atanan dile çevirir.
money	Fiyatı, konumunuzun para birimine göre biçimlendirir.
escape	HTML'de bulunan özel karakterlerden (ör. `<>`, `'`, ve `&`) kaçar ve karakterleri kaçış dizilerine dönüştürür.
barcode	1D barkod SVG dosyası üretir.
qrcode	2D barkod SVG dosyası üretir.

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

Koşullu mesajlar eklemek için Liquid'i kullanabilirsiniz. Bu işlev, görsel düzenleyicisinde tek bir konuma kaydetmeye benzer. Örneğin, işletmeniz tek bir konumla faaliyete başladı ve artık birkaç yeni konumunuz var. Yazdırılan makbuzlarda, orijinal mağazanızı vurgulamak istiyorsunuz.

Kod düzenleyicisinin Bölümler klasöründeki header.liquid şablonuna özel bir mesaj ekleyebilir ve Liquid'i kullanarak mesajı yalnızca ana konumunuzda gösterebilirsiniz.

Aşağıdaki kod, konumun adını (bu durumda, "Home" adlı orijinal konumunuzdur) kontrol eder ve konum bu adla eşleşiyorsa "Welcome to our original store, opened in 1972." (1972'de açılan orijinal mağazamıza hoş geldiniz) mesajı görünür. Diğer konumlardan yazdırılan makbuzlarda, bunun yerine "Welcome to our store." (Mağazamıza hoş geldiniz) mesajı görünür.

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