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 %}

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_name ve order.line_items ifadelerini kullanın.
  • Para değerleri düz sayılardır. Bunları money filtresiyle biçimlendirin, örneğin: {{ order.total_price | money }}.
  • Boş bir satır yazdırmamak için isteğe bağlı değerleri bir if ifadesiyle koruyun, örneğin: {% if order.customer.email %}{{ order.customer.email }}{% endif %}.
  • Listeleri bir for ifadesiyle 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, render veya section etiketlerini 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.

Özel bir Liquid bloku için kullanılabilen üst düzey değişkenlerin açıklaması
DeğişkenAçı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

Sipariş nesnesinin açıklaması
ÖzellikAçı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.

Müşteri nesnesinin açıklaması
ÖzellikAçıklama
display_name
Müşterinin görünen adı.
first_name
Müşterinin adı.
last_name
Müşterinin soyadı.
email
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.

Sipariş satır öğesi nesnesinin açıklaması
ÖzellikAçı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.

İşlem nesnesinin açıklaması
ÖzellikAçı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.

Shop nesnesinin açıklaması
ÖzellikAçı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.

Konum nesnesinin açıklaması
ÖzellikAçı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.

Adres nesnesinin açıklaması
ÖzellikAçı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.

İndirim nesnesinin açıklaması
ÖzellikAçı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.

Vergi satırı nesnesinin açıklaması
ÖzellikAçı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.

Hediye kartı nesnesinin açıklaması
ÖzellikAçı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.

Özel bir Liquid bloğunda kullanılabilecek filtrelerin açıklaması
FiltreÖrnekAçı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 }}