Basılı makbuzlar için özel Liquid blokları
Sipariş bilgileri, müşteri bilgileri, ürün özellikleri, meta alanlar ve barkodlar gibi kendi içeriklerinizi basılı bir makbuzun üstbilgisine veya altbilgisine eklemek için özel bir Liquid bloku kullanabilirsiniz.
Özel Liquid blokları, tamamlanan online siparişlere ve Point of Sale siparişlerine ait basılı makbuzlarda işlenir. Offline ödeme kullanılan siparişlerde işlenmezler.
Shopify yöneticinizdeki görsel makbuz düzenleyicisinden özel bir Liquid bloğu ekleyebilirsiniz. Makbuz yazdırılırken makbuz verilerinde başvurduğunuz değerler kullanılır. Örneğin aşağıdaki Liquid kodu, bir sipariş notu varsa bu notu makbuza ekler:
{% if order.note %}
<p>Order note: {{ order.note }}</p>
{% endif %}Bu sayfada
Liquid söz dizimi kuralları
Özel bir Liquid bloku oluşturmadan önce aşağıdaki söz dizimi kurallarını inceleyin:
- Değişken adlarında, snake_case olarak bilinen bir biçim olan küçük harfler ve alt çizgiler kullanılır. Örneğin,
order.total_price,order.customer.display_nameveorder.line_itemsifadelerini kullanın. - Para değerleri düz sayılardır. Bunları
moneyfiltresiyle biçimlendirin, örneğin:{{ order.total_price | money }}. - Boş bir satır yazdırmamak için isteğe bağlı değerleri bir
ififadesiyle koruyun, örneğin:{% if order.customer.email %}{{ order.customer.email }}{% endif %}. - Listeleri bir
forifadesiyle döngüye alın, örneğin:{% for item in order.line_items %} ... {% endfor %}. - Bazı Liquid etiketleri desteklenmez.
assign,capture,cycle,decrement,ifchanged,include,increment,layout,raw,renderveyasectionetiketlerini kullanamazsınız. Blokunuz desteklenmeyen bir etiket kullanıyorsa makbuzunuz kaydedilmez ve bir hata görüntülenir. - Özel bir Liquid bloku en fazla 50 KB kod içerebilir.
Özel bir Liquid blokundaki hatalar Liquid kodu alanında vurgulanır. Bir blokta hata varken Kaydet'e tıklarsanız düzenleyici, hatayı düzeltebilmeniz için hatanın bulunduğu bloku açar.
HTML ve CSS
İçeriğinizi yapılandırmak için özel bir Liquid blokunda <p>, <br>, <strong>, <em>, başlıklar, listeler ve bağlantılar gibi temel HTML'leri kullanabilirsiniz. İçeriğiniz, makbuzun mevcut yazı tiplerini ve boyutlarını kullanır.
Bir makbuzun görünümünü değiştirmek için CSS kullanamazsınız. Özel bir Liquid blokunun makbuzun başka bir yerindeki içeriği yeniden biçimlendirmemesi veya gizlememesi için <style> blokları ve style öznitelikleri desteklenmez. <script> etiketleri, onclick gibi olay işleyicileri ve javascript: bağlantıları da desteklenmez.
Blokunuz desteklenmeyen HTML içeriyorsa makbuzunuz kaydedilmez ve bir hata görüntülenir. Desteklenmeyen HTML'yi kaldırın ve tekrar kaydedin.
Değişkenler ve nesneler
Özel bir Liquid bloku aşağıdaki nesnelere ve değişkenlere başvurabilir. Bazı değerler varsayılan makbuzda bulunmaz, bu nedenle özel bir Liquid bloku bunları eklemenin bir yoludur.
Üst düzey değişkenler
Aşağıdaki üst düzey değişkenler özel bir Liquid blokunda kullanılabilir.
| Değişken | Açıklama |
|---|---|
order | Yazdırılan sipariş. |
shop | Mağaza. |
location | Perakende satış konumu. |
settings | Makbuzun görünüm ayarları; bunlar düzenleyicide yapılandırılan açma/kapatma düğmeleridir. |
purchased_gift_cards | Bu siparişte satın alınan hediye kartları. |
staff_member_description | Personel gösterimi açık olduğunda ilgili personel. |
locale | Makbuz yerel ayarı (ör. en). |
is_pickup | Siparişin bir teslim alım siparişi olup olmadığı. |
pickup_location | Geçerli olduğunda teslim alım konumu. |
Sipariş nesnesi
| Özellik | Açıklama |
|---|---|
name | Sipariş adı (ör. #1001). |
created_at |
Sipariş zaman damgası. date filtresi ile kullanın.
|
note | Sipariş notu. |
subtotal_price |
Alt toplam. money filtresiyle biçimlendirin.
|
total_price |
Toplam. money filtresiyle biçimlendirin.
|
shipping_price |
Tahsil edilen kargo ücreti. money filtresiyle biçimlendirin.
|
total_tip_received |
Bahşiş toplamı. money filtresiyle biçimlendirin.
|
balance_due |
Hâlâ ödenmesi gereken tutar. money filtresiyle biçimlendirin.
|
change_due |
Verilen para üstü. money filtresiyle biçimlendirin.
|
taxes_included | Verginin fiyatlara dâhil olup olmadığı. |
receipt_number | Makbuz numarası. |
barcode_content | Bir barkodda kodlanacak içerik. |
qr_code_content |
Bir QR kodunda kodlanacak içerik. qrcode filtresi ile kullanın.
|
line_items | Satın alınan ürünler. Her bir ürünün özellikleri sipariş satır öğesi nesnesinde listelenir. |
transactions | Ödemeler. Her bir ödemenin özellikleri işlem nesnesinde listelenir. |
discounts | Sipariş düzeyindeki indirimler. Her bir indirimin özellikleri indirim nesnesinde listelenir. |
tax_lines | Vergi satırları. Her bir vergi satırının özellikleri vergi satırı nesnesinde listelenir. |
refunds | Siparişteki para iadeleri. |
shipping_address | Kargo adresi. Adres özellikleri adres nesnesinde listelenir. |
customer | Müşteri nesnesinde listelenen müşteri bilgileri. |
metafields | Sipariş meta alanları. |
Müşteri nesnesi
order.customer nesnesi müşterinin bilgilerini içerir.
| Özellik | Açıklama |
|---|---|
display_name | Müşterinin görünen adı. |
first_name | Müşterinin adı. |
last_name | Müşterinin soyadı. |
| Müşterinin e-posta adresi. | |
phone | Müşterinin telefon numarası. |
default_address | Müşterinin varsayılan adresi. |
metafields | Müşteri meta alanları. |
Sipariş satır öğesi nesnesi
Şunun içindeki her bir ürün: order.line_items aşağıdaki özellikleri içerir.
| Özellik | Açıklama |
|---|---|
name | Ürün veya satır adı. |
variant_title | Varyasyon (örneğin: Büyük/Mavi). |
sku | SKU. |
vendor | Satıcı. |
quantity | Miktar. |
price |
Birim fiyatı. money filtresiyle biçimlendirin.
|
total_price |
Satır toplamı. money filtresiyle biçimlendirin.
|
discounted_total_price |
İndirimlerden sonraki satır toplamı. money filtresiyle biçimlendirin.
|
discounted_unit_price |
İndirimlerden sonraki birim fiyatı. money filtresiyle biçimlendirin.
|
discounts | Satıra uygulanan indirimler. |
selling_plan_name | Varsa abonelik veya satış planı adı. |
staff_member_description | Satırla ilişkilendirilmiş personel. |
custom_attributes | Tam adlarıyla erişilen satır öğesi özellikleri. |
product_metafields | Anahtarla erişilen ürün meta alanları. |
variant_metafields | Anahtarla erişilen varyasyon meta alanları. |
İşlem nesnesi
Şunun içindeki her bir ödeme: order.transactions aşağıdaki özellikleri içerir. Siparişte harcanan mağaza kredisi, Mağaza kredisi adlı bir ödeme olarak listelenir. Müşterinin kalan mağaza kredisi bakiyesi değişken olarak kullanılamaz.
| Özellik | Açıklama |
|---|---|
name | Visa, nakit veya mağaza kredisi gibi ödeme adı. |
payment_type | Ödeme türü kodu. |
amount |
Tutar. money filtresiyle biçimlendirin.
|
kind | İşlem türü. |
status | İşlem durumu. |
credit_card_number | Geçerli olduğunda maskelenmiş kart numarası. |
created_at | İşlem zaman damgası. |
additional_details | Ek ödeme bilgisi satırları. |
Shop nesnesi
shop nesnesi mağazanın bilgilerini içerir.
| Özellik | Açıklama |
|---|---|
name | Mağaza adı. |
domain | Mağaza alan adı. |
currency | Mağaza para birimi. |
id | Mağaza kimliği. |
Konum nesnesi
location nesnesi perakende konumunun bilgilerini içerir.
| Özellik | Açıklama |
|---|---|
name | Konum adı. |
address1 | Birinci adres satırı. |
address2 | İkinci adres satırı. |
city | Şehir. |
province | İl veya eyalet. |
province_code | İl veya eyalet kodu. |
zip | Posta kodu. |
country | Ülke. |
phone | Telefon numarası. |
metafields | Konum meta alanları. |
Adres nesnesi
Şunun gibi bir adres: order.shipping_address veya order.customer.default_address, aşağıdaki özellikleri içerir.
| Özellik | Açıklama |
|---|---|
company | Şirket adı. |
name | Alıcının adı. |
address1 | Birinci adres satırı. |
address2 | İkinci adres satırı. |
city | Şehir. |
province | İl veya eyalet. |
province_code | İl veya eyalet kodu. |
zip | Posta kodu. |
country | Ülke. |
country_code | Ülke kodu. |
phone | Telefon numarası. |
İndirim nesnesi
Şunun içindeki her bir indirim: order.discounts veya item.discounts aşağıdaki özellikleri içerir.
| Özellik | Açıklama |
|---|---|
description | İndirim açıklaması. |
amount | İndirim tutarı. money filtresiyle biçimlendirin. |
percentage | İndirim yüzdesi. |
Vergi satırı nesnesi
Şunun içindeki her bir vergi satırı: order.tax_lines aşağıdaki özellikleri içerir.
| Özellik | Açıklama |
|---|---|
title | Vergi başlığı. |
rate | Ondalık sayı olarak vergi oranı. |
rate_percentage | Yüzde olarak vergi oranı. |
price | Vergi tutarı. money filtresiyle biçimlendirin. |
taxable_amount | Vergiye tabi tutar. money filtresiyle biçimlendirin. |
Hediye kartı nesnesi
Şunun içindeki her bir hediye kartı: purchased_gift_cards aşağıdaki özellikleri içerir.
| Özellik | Açıklama |
|---|---|
code | Hediye kartı kodu. |
masked_code | Maskelenmiş hediye kartı kodu. |
balance | Hediye kartı bakiyesi. money filtresiyle biçimlendirin. |
created_at | Hediye kartı zaman damgası. |
qr_code_content | QR koduna kodlanacak içerik. |
Meta alanlar ve özellikler
Meta alanlar ve satır öğesi özellikleri iki şekilde bulunur.
Satır öğesi meta alanları ve özellikleri anahtarlıdır. Bir değere doğrudan anahtarı üzerinden erişin:
{{ item.product_metafields.care_instructions }}
{{ item.custom_attributes['Engraving'] }}Sipariş ve müşteri meta alanları listedir. Bunların üzerinde döngü oluşturun:
{% for m in order.metafields %}
{{ m.namespace }}.{{ m.key }}: {{ m.value }}
{% endfor %}Meta alan anahtarları snake_case biçimine normalleştirilir. Care Instructions veya careInstructions gibi bir anahtara care_instructions şeklinde erişilir. Meta alan anahtarlarına her zaman alt çizgi içeren küçük harflerle referans verin.
Satır öğesi özellik adları normalleştirilmez. Bir özelliğe köşeli ayraçlar ve tırnak işaretleri içindeki tam adıyla erişin. Örneğin, Gift wrap adlı bir özelliğe item.custom_attributes['Gift wrap'] şeklinde erişilir.
Sipariş ve müşteri meta alanlarının kullanılabilirliği, söz konusu meta alanların kayıtta mevcut olmasına bağlıdır.
Liquid filtreleri
Özel Liquid bloğunuzdaki bilgileri biçimlendirmek için filtreleri kullanabilirsiniz. Bir filtre uygulamak için Liquid çıktısının içine bir dikey çubuk (|) ve ardından {{ order.total_price | money }} örneğinde olduğu gibi filtreyi ekleyin.
Standart Liquid filtreleri de çalışır. Liquid filtreleri hakkında daha fazla bilgi edinmek için Filtreler referansı bölümüne bakın.
| Filtre | Örnek | Açıklama |
|---|---|---|
money | {{ order.total_price | money }} | Bir tutarı makbuzun para biriminde biçimlendirir. |
date | {{ order.created_at | date: '%B %e, %Y' }} | Bir tarih veya saati biçimlendirir. |
percent | {{ tax_line.rate | percent }} | Ondalık bir sayıyı yüzde olarak biçimlendirir (ör. 0.2'yi %20 olarak). |
t | {{ 'receipt.total' | t }} | Çevrilmiş bir etiket döndürür. |
barcode | {{ order.barcode_content | barcode }} | Bir barkod oluşturur. |
qrcode | {{ order.qr_code_content | qrcode }} | Bir QR kodu oluşturur. |
Özel Liquid bloğu örnekleri
Aşağıdaki örnekler, varsayılan bir basılı makbuz şablonunda bulunmayan içerikleri ekler.
Mevcut olduğunda sipariş notu eklemek için aşağıdaki Liquid kodunu kullanın:
{% if order.note %}<p>Note: {{ order.note }}</p>{% endif %}Her ürünün yanına SKU eklemek için aşağıdaki Liquid kodunu kullanın:
{% for item in order.line_items %}
<p>{{ item.name }} — {{ item.sku }} ×{{ item.quantity }}</p>
{% endfor %}Özel işleme gibi bir satır öğesi özelliği eklemek için aşağıdaki Liquid kodunu kullanın:
{% for item in order.line_items %}
{% if item.custom_attributes['Engraving'] %}
<p>{{ item.name }} — Engraving: {{ item.custom_attributes['Engraving'] }}</p>
{% endif %}
{% endfor %}Bakım talimatları gibi bir ürün meta alanı eklemek için aşağıdaki Liquid kodunu kullanın:
{% for item in order.line_items %}
{% if item.product_metafields.care_instructions %}
<p>{{ item.name }}: {{ item.product_metafields.care_instructions }}</p>
{% endif %}
{% endfor %}Bir müşteri meta alanı eklemek için aşağıdaki Liquid kodunu kullanın:
{% for m in order.customer.metafields %}
{% if m.key == 'loyalty_tier' %}<p>Loyalty tier: {{ m.value }}</p>{% endif %}
{% endfor %}Siparişe yönlendiren bir QR kodu eklemek için aşağıdaki Liquid kodunu kullanın:
{{ order.qr_code_content | qrcode }}