Yazdırılan makbuzlar için özel Liquid blokları

Özel bir Liquid bloğu oluşturmadan önce aşağıdaki söz dizimi kurallarını inceleyin:

• Değişken adları küçük harfler ve alt çizgiler kullanır. Bu formata snake_case denir. Örneğin, order.total_price, order.customer.display_name ve order.line_items kullanın.
• Para değerleri düz sayılardır. Bunları {{ order.total_price | money }} gibi money filtresiyle biçimlendirin.
• İsteğe bağlı değerleri if ifadesiyle koruma altına alarak boş bir satır yazdırmayı önleyin, örneğin: {% if order.customer.email %}{{ order.customer.email }}{% endif %}.
• for ifadesiyle listeler üzerinde döngü oluşturun, örneğin: {% for item in order.line_items %} ... {% endfor %}.
• Bazı Liquid etiketleri desteklenmez. assign, capture, include, render, raw, increment veya decrement kullanamazsınız. Bloğunuz desteklenmeyen bir etiket kullanıyorsa makbuzunuz kaydedilmez ve bir hata görürsünüz.
• Özel bir Liquid bloğu en fazla 50 KB kod içerebilir.

HTML ve CSS

İçeriğinizi yapılandırmak için özel bir Liquid bloğunda <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.

Makbuzun görünümünü değiştirmek için CSS kullanamazsınız. <style> blokları ve style özellikleri desteklenmez, bu nedenle özel bir Liquid bloğu makbuzun başka bir yerindeki içeriğin stilini değiştiremez veya içeriği gizleyemez. <script> etiketleri, onclick gibi olay işleyicileri ve javascript: bağlantıları da desteklenmez.

Bloğunuz desteklenmeyen bir HTML içeriyorsa makbuzunuz kaydedilmez ve bir hata görürsünüz. Desteklenmeyen HTML'yi kaldırın ve tekrar kaydedin.

Özel bir Liquid bloğu aşağıdaki nesnelere ve değişkenlere başvurabilir. Bazı değerler varsayılan makbuzda yer almaz, bunları eklemenin bir yolu özel bir Liquid bloğu kullanmaktır.

Üst düzey değişkenler

Aşağıdaki üst düzey değişkenler özel bir Liquid bloğunda kullanılabilir.

order

shop

location

settings

purchased_gift_cards

staff_member_description

locale

is_pickup

pickup_location

Sipariş nesnesi

name

created_at

note

subtotal_price

total_price

shipping_price

total_tip_received

balance_due

change_due

taxes_included

receipt_number

barcode_content

qr_code_content

line_items

transactions

discounts

tax_lines

refunds

shipping_address

customer

metafields

Müşteri nesnesi

​ order.customer nesnesi, müşterinin bilgilerini içerir.

display_name

first_name

last_name

email

phone

default_address

metafields

Sipariş satır öğesi nesnesi

Şu kısımdaki her bir öğe: order.line_items içindeki her bir öğe aşağıdaki özellikleri içerir.

name

variant_title

sku

vendor

quantity

price

total_price

discounted_total_price

discounted_unit_price

discounts

selling_plan_name

staff_member_description

custom_attributes

product_metafields

variant_metafields

İşlem nesnesi

Şu kısımdaki her bir ödeme: order.transactions içindeki her bir ödeme 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, bir değişken olarak kullanılamaz.

name

payment_type

amount

kind

status

credit_card_number

created_at

additional_details

Mağaza nesnesi

​ shop nesnesi, mağazanın bilgilerini içerir.

name

domain

currency

id

Konum nesnesi

​ location nesnesi, perakende satış konumunun bilgilerini içerir.

name

address1

address2

city

province

province_code

zip

country

phone

metafields

Adres nesnesi

Örneğin order.shipping_address veya order.customer.default_addressgibi bir adres aşağıdaki özellikleri içerir.

company

name

address1

address2

city

province

province_code

zip

country

country_code

phone

İndirim nesnesi

Şu kısımdaki her bir indirim: order.discounts veya item.discounts içindeki her bir öğe aşağıdaki özellikleri içerir.

description

amount

percentage

Vergi satırı nesnesi

Şu kısımdaki her bir vergi satırı: order.tax_lines içindeki her bir öğe aşağıdaki özellikleri içerir.

title

rate

rate_percentage

price

taxable_amount

Hediye kartı nesnesi

Şu kısımdaki her bir hediye kartı: purchased_gift_cards içindeki her bir öğe aşağıdaki özellikleri içerir.

code

masked_code

balance

created_at

qr_code_content

Meta alanlar ve satır öğesi özellikleri iki şekilde gelir.

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

Anahtarlar snake_case yapısına normalleştirilir. Care Instructions veya careInstructions gibi bir anahtara care_instructions şeklinde erişilir. Anahtarlı değerlere her zaman küçük harflerle ve alt çizgi ile başvurun.

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.

Özel Liquid bloğunuzdaki bilgileri biçimlendirmek için filtreleri kullanabilirsiniz. Bir filtre uygulamak için Liquid çıkışının içine dikey çizgi (|) ve ardından filtreyi ekleyin. Örneğin: {{ order.total_price | money }}.

Standart Liquid filtreleri de kullanılabilir. Liquid filtreleri hakkında daha fazla bilgi edinmek için Filtreler referansı bölümüne bakın.

money

{{ order.total_price | money }}

date

{{ order.created_at | date: '%B %e, %Y' }}

percent

{{ tax_line.rate | percent }}

t

{{ 'receipt.total' | t }}

barcode

{{ order.barcode_content | barcode }}

qrcode

{{ order.qr_code_content | qrcode }}

Aşağıdaki örnekler, varsayılan bir basılı makbuz şablonunda bulunmayan içerikler ekler.

Mevcut olduğunda sipariş notunu eklemek için aşağıdaki Liquid'i 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'i kullanın:

{% for item in order.line_items %}
  <p>{{ item.name }} — {{ item.sku }} ×{{ item.quantity }}</p>
{% endfor %}

Oyma gibi bir satır öğesi özelliği eklemek için aşağıdaki Liquid'i 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'i 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'i kullanın:

{% for m in order.customer.metafields %}
  {% if m.key == 'loyalty_tier' %}<p>Loyalty tier: {{ m.value }}</p>{% endif %}
{% endfor %}

Siparişe bağlanan bir QR kodu eklemek için aşağıdaki Liquid'i kullanın:

{{ order.qr_code_content | qrcode }}