Checkout Blocks'taki bloklar için desteklenen Liquid söz dizimi

Checkout Blocks, mevcut blok türlerinin birçoğunda değişkenlere göre ödeme kişiselleştirmelerinizi kişiselleştirmek için kullanabileceğiniz bir Liquid söz dizimi alt kümesini destekler.

Bu sayfada

Desteklenen Liquid değişkenleri

Aşağıdaki listeler, Dinamik içerik bloğu veya Satır öğesi içeriği bloğu içinde kullanılabilecek tüm desteklenen Liquid değişkenlerini içerir. Bazı değişkenlere yalnızca ödemenin belirli sayfalarından erişilebilirken diğer değişkenler yalnızca belirli blok türlerine eklenebilir.

Her bir değişkenin özellikleri için Shopify'ın Liquid nesneleri belgelerine bakın.

Ödeme için Liquid değişkenleri

Ödeme için aşağıdaki Liquid değişkenleri desteklenir:

checkout.attributes
checkout.currency
checkout.has_selling_plan
checkout.item_count
checkout.line_items_subtotal_price
checkout.locale
checkout.market
checkout.metafields
checkout.note
checkout.requires_shipping
checkout.shipping_price
checkout.tax_price
checkout.total_price

Müşteri için Liquid değişkenleri

Müşteriler için aşağıdaki Liquid değişkenleri desteklenir:

customer.id
customer.b2b
customer.full_name
customer.first_name
customer.last_name
customer.email
customer.phone

Yerelleştirme için Liquid değişkenleri

Pazarlar için aşağıdaki Liquid değişkenleri desteklenir:

localization.market
- localization.market.id
- localization.market.handle

Sipariş için Liquid değişkenleri

Siparişler için aşağıdaki Liquid değişkenleri desteklenir:

checkout.order.id
checkout.order.legacyResourceId
checkout.order.name

Mağaza için Liquid değişkenleri

Mağaza bilgileri için aşağıdaki Liquid değişkenleri desteklenir:

shop.name
shop.url

Satır öğesi için Liquid değişkenleri

Satır öğesi değişkenlerine yalnızca bir Satır öğesi içerik bloku içinden erişilebilir.

Satır öğeleri için aşağıdaki Liquid değişkenleri desteklenir:

line_item.attributes
line_item.gift_card
line_item.has_selling_plan
line_item.line_price
line_item.line_level_discount_allocations
line_item.line_level_total_discount
line_item.options_with_values
line_item.price
line_item.product
- line_item.product.is_gift_card
- line_item.product.product_type
- line_item.product.requires_selling_plan
- line_item.product.tags
- line_item.product.vendor
line_item.quantity
line_item.requires_shipping
line_item.sku
line_item.subtitle
line_item.title
line_item.trigger
line_item.type
line_item.variant
- line_item.variant.available_for_sale
- line_item.variant.barcode
- line_item.variant.compare_at_price
- line_item.variant.id
- line_item.variant.price
  - line_item.variant.price.amount
  - line_item.variant.price.currency_code
- line_item.variant.requires_shipping
- line_item.variant.sku
- line_item.variant.title
- line_item.variant.unit_price
- line_item.variant.weight
- line_item.variant.weight_unit
line_item.variant_id
line_item.vendor

Liquid kullanılan parçacık örnekleri

Aşağıda, Checkout Blocks tarafından desteklenen bazı örnek Liquid parçacıkları yer almaktadır.

Ödemenin B2B olup olmadığını kontrol etme

İçeriği yalnızca ödeme B2B olduğunda görüntüleyebilirsiniz.

{%- if customer.b2b -%}
B2B
{%- endif -%}

JSON ayrıştırma

Satır öğesi özelliklerinden (properties) veya meta alanlardan gelen JSON değerlerini ayrıştırabilirsiniz.

{%- assign complex_json = checkout.metafields.checkoutblocks.complex | json -%}

Para birimini biçimlendirme

Checkout Blocks, çoklu para birimiyle ödemeyi tamamen destekler. Etkin para birimi biçimini kullanarak parayı ayrıştırmak ve biçimlendirmek için money filtresini kullanmanız yeterlidir. Bu işlem, para birimini otomatik olarak dönüştürmez.

{{ checkout.total_price | money }}

Sepet notu

Sepete girilenler gibi, sepet notunun değerini görüntüleyebilirsiniz.

{{ checkout.note }}

Sepet özellikleri

Teslimat tarihi gibi belirli bir sepet özelliğinin değerini görüntülemek için bu parçacığı kullanabilirsiniz. Delivery date anahtarını kendinizinkine uyacak şekilde değiştirdiğinizden emin olun.

{% assign delivery_date = '' %}
{% for attribute in checkout.attributes %}
  {% if attribute.key == 'Delivery date' %}
    {% assign delivery_date = attribute.value %}
  {% endif %}
{% endfor %}

Delivery Date: {{ delivery_date }}

Tüm ödeme Liquid içeriklerini görüntüleme

Ödeme nesnesinde hangi değerlerin bulunduğunu gözden geçirmeniz gerekirse serileştirmek için JSON filtresini kullanabilirsiniz. Bu, yalnızca hata ayıklama amacıyla kullanılmalıdır.

{{ checkout | json }}

Ödeme meta alanları

Ödeme meta alanlarına referans vererek, ödemeye kaydedilen özel alanları teşekkür ve sipariş durumu sayfalarında görüntüleyebilirsiniz. Meta alanlara erişme hakkında daha fazla bilgi edinin.

Blokta tanımlandığı şekilde, your-namespace yerine kendi ad alanınızı ve your-custom-field-key yerine kendi özel alan anahtarınızı yazın:

{{ checkout.metafields.your-namespace.your-custom-field-key.value }}

Tarih biçimlendirme

Bu örnekte, gelecekte 4 gün sonrasına (432.000 saniye) ait bir tarih oluşturup ardından bu tarihi biçimlendiriyoruz.

Tarihi "02/24/2025" olarak biçimlendirilmiş şekilde döndürebilirsiniz:

{% assign future_date = "now" | date: "%s" | plus: 432000 %}
{{ future_date | date: "%m/%d/%Y" }}

Alternatif olarak tarihi "24 Şubat 2025" olarak da biçimlendirebilirsiniz:

{% assign future_date = "now" | date: "%s" | plus: 432000 %}
{{ future_date | date: "%b %d, %Y" }}

Liquid'de tarihleri biçimlendirme hakkında daha fazla bilgi edinin.

Satır öğesi içeriği özelleştirmeleri

Aşağıda, Satır öğesi içerik bloklarında kullanabileceğiniz bazı örnek Liquid parçacıkları yer almaktadır.

Karşılaştırma fiyatını koşullu olarak gösterme

Bu parçacığı kullanarak bir satır öğesinin karşılaştırma fiyatını koşullu olarak gösterebilirsiniz.

{%- if line_item.variant.compare_at_price.amount -%}
On sale. Originally {{ line_item.variant.compare_at_price.amount | times: line_item.quantity | money }}
{%- endif -%}

Ürün etiketlerine göre içerik görüntüleme

Büyük/küçük harfe duyarlı olan ürün etiketlerine göre satır öğesi içeriğini koşullu olarak görüntüleyebilirsiniz.

{%- if line_item.product.tags contains 'final-sale' -%}
Final sale
{%- endif -%}

Satır öğesi özellikleri (properties)

Satır öğesi özelliklerini (line item properties olarak da bilinir) yineleyebilir ve teslimat tahminleri, ön siparişler ve daha fazlası gibi bilgileri görüntüleyebilirsiniz.

{%- assign first_line_attribute = line_item.attributes | first  -%}
{%- assign first_attribute_value =  first_line_attribute.value | json_parse  -%}
{%- assign message =  first_attribute_value.message -%}
{%- if message -%}
  {{ message }}
{%- endif -%}

"Meta alan tetikleyicisi" değerini görüntüleme

Aşağıdaki kod, tetikleyicinin değerini içerir.

{{ line_item.trigger }}

Bir satır öğesi için yinelenen toplamı gösterme

Bir abonelik satır öğesi için yinelenen toplamı tek seferlik indirimlerden önce göstermeniz gerekiyorsa line_level_total_discount değerini kullanabilirsiniz.

{%- if line_item.line_level_total_discount > 0 and line_item.has_selling_plan -%}
Recurring total: {{ line_item.line_price | plus: line_item.line_level_total_discount | money }}
{%- endif -%}