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

Checkout Blocks, Liquid söz diziminin, ödeme sayfasında yaptığınız özelleştirmeleri değişkenlere göre kişiselleştirmek için çeşitli blok türlerinde kullanabileceğiniz bir alt kümesini destekler.

Desteklenen Liquid değişkenleri

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

Her bir değişkenle ilgili ayrıntılar için Shopify'ın Liquid nesneleriyle ilgili belgelerine bakın.

Ödeme Liquid değişkenleri

Ödeme sayfalarında, 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 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 Liquid değişkenleri

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

• localization.market
  • localization.market.id
  • localization.market.handle

Sipariş Liquid değişkenleri

Not

Sipariş değişkenlerine yalnızca sipariş durumu sayfasından erişilebilir.

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

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

Mağaza Liquid değişkenleri

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

• shop.name
• shop.url

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

Plan gerekliliği

Creating a line item content block, yalnızca Shopify Plus planı kapsamındaki satıcıların kullanımına sunulmuştur.

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 kod parçacığı örnekleri

Aşağıdaki bölümde, Checkout Blocks tarafından desteklenen bazı örnek Liquid kod parçacıkları yer almaktadır.

Ödemenin B2B olup olduğunu kontrol etme

İçeriği yalnızca ödeme B2B olduğunda gösterebilirsiniz.

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

JSON ayrıştırma

Satır öğesinin özellikleri (nitelikler) veya meta alanları gibi JSON değerlerini ayrıştırabilirsiniz.

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

Para birimini biçimlendirme

Checkout Blocks, çoklu para biriminde ödemeleri tamamen destekler. Etkin para birimi biçimini kullanarak parayı ayrıştırmak ve biçimlendirmek için para filtresini geçirmeniz yeterlidir. Bu, para birimini otomatik olarak dönüştürmez.

{{ checkout.total_price | money }}

Sepet notu

Sepet notlarının değerini (ör. sepete girilenler) görüntüleyebilirsiniz.

{{ checkout.note }}

Sepet özellikleri

Belirli bir sepet özelliğinin değerini (ör. teslimat tarihi) görüntülemek için bu kod parçacığını kullanabilirsiniz. Delivery date (Teslim tarihi) anahtarını kendi anahtarınızla değiştirmeyi unutmayın.

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

Delivery Date: {{ delivery_date }}

Ödemedeki tüm Liquid içeriklerini görüntüleme

Ödeme nesnesinde hangi değerlerin bulunduğunu gözden geçirmeniz gerekirse öğeleri seri hale getirmek 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, teşekkür ve sipariş durumu sayfalarında ödemeye kaydedilen özel alanları görüntüleyebilirsiniz. Meta alanlara erişme hakkında daha fazla bilgi edinin.

your-namespace ifadesini kendi ad alanınızla, your-custom-field-key ifadesini ise blokta tanımlanan özel alan anahtarınızla değiştirin:

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

Tarihleri biçimlendirme

Bu örnekte, 4 gün (432000 saniye) sonraki bir tarihi oluşturup biçimlendireceğiz.

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

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

Alternatif olarak, tarihi "24 Şubat 2025" olarak 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çeriklerini kişiselleştirme

Plan gerekliliği

Creating a line item content block, yalnızca Shopify Plus planı kapsamındaki satıcıların kullanımına sunulmuştur.

Aşağıdaki bölümde, Satır öğesi içerik bloklarında kullanabileceğiniz bazı örnek Liquid kod parçacıkları yer almaktadır.

Karşılaştırma fiyatını koşula bağlı olarak gösterme

Bu kod parçacığını kullanarak bir satır öğesinin karşılaştırma fiyatını koşula bağlı 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 bağlı olarak içerik görüntüleme

Satır öğesi içeriklerini, büyük/küçük harf duyarlı ürün etiketlerini temel alan bir koşula bağlı olarak görüntüleyebilirsiniz.

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

Satır öğesi özellikleri (nitelikleri)

Satır öğesi özellikleri (satır öğesi nitelikleri olarak da adlandırılır) üzerinde yineleme yapabilir ve teslimat tarihi tahminlerini, ön siparişleri ve benzeri 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

Tek seferlik indirimlerden önce bir abonelik satır öğesi için yinelenen toplamı göstermeniz gerekirse 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 -%}