Shopify Order Printer için Liquid değişkenleri ve filtreler referansı

Shopify Order Printer uygulamasıyla kendi özel şablonlarınızı oluşturmak için Liquid'i kullanabilirsiniz. Liquid ile metin şablonları oluşturabilir ve bunları her bir siparişin benzersiz verilerine göre işleyebilirsiniz.

Bu sayfada listelenen Liquid referansları, Liquid'in açık kaynak sürümünün bir uzantısıdır ve Shopify Order Printer uygulamasında kullanım amaçlıdır. order ve shop özelliklerine dayanan bilgileri işlemek için şablonlarınızı, bu referansta yer alan nesnelerin, etiketlerin ve filtrelerin listesini kullanarak kişiselleştirebilirsiniz. Nesne alanları hakkında bilgi edinmek için Admin GraphQL API belgelerini de kullanabilirsiniz.

Bu sayfada

Değişkenleri ve özellikleri kullanma

Shopify Order Printer şablonlarındaki temel veri nesneleri şunlardır: order ve shop. Sipariş özelliklerine erişmek için order.variable_name öğesini kullanabilirsiniz.

Yaygın olarak kullanılan aşağıdaki sipariş özelliklerine, order. ön eki olmadan erişilebilir:

line_items
tax_lines
fulfillments
transactions
discounts
refunds
shipping_methods
customer

Örneğin, satır öğeleri değişkenine erişmek istiyorsanız line_items veya order.line_items kullanabilirsiniz.

Shopify Order Printer'da kullanılabilen Liquid değişkenleri

Aşağıdaki sınıflar kullanılabilir. Özellikler alfabetik sırada listelenmiştir.

Sipariş

Shopify Order Printer'da aşağıdaki Sipariş özellikleri kullanılabilir:

attributes
b2b
billing_address
cancel_reason
cancel_reason_label
cancelled
cancelled_at
cart_level_discount_applications
checkout_id
checkout_payment_collection_url
company
company_location
confirmation_number
created_at. Siparişin işlendiği zaman. Bu, GraphQL API'deki order.processed_at değerine eşittir. Zaman damgasını biçimlendirmek için date filtresini kullanın (örneğin, {{ order.created_at | date: "%B %e, %Y" }} ile).
customer
discounts. Tüm indirim türleri ve ayrıntıları kaydedilemediği için kullanımdan kaldırıldı. order.discounts özelliği, order.discount_applications ile değiştirildi.
discounts_amount. Tüm indirim türleri ve ayrıntıları kaydedilemediği için kullanımdan kaldırıldı. order.discounts özelliği, order.total_discounts ile değiştirildi.
discount_applications
discounts_savings. Tüm indirim türleri ve ayrıntıları kaydedilemediği için kullanımdan kaldırıldı. order.discounts özelliği, - ile değiştirildi.
email
fees
financial_status
financial_status_label
fulfilled_line_items
fulfillment_aborted
fulfillment_status
fulfillments
gateway
id
item_count
landing_site
landing_site_ref
line_items
line_items_subtotal_price
location
metafields
name
net_payment
note
order_name
order_number
order_status_url
payment
payment_details
po_number
refunds
requires_shipping
shipping_address
shipping_method
shipping_methods
shipping_price
shop
shop_name
subtotal_price
tags
tax_lines
tax_price
tip_line_items
total_discounts
total_duties
total_landed_cost_additional_fees
total_net_amount
total_outstanding
total_price
total_refunded_amount
total_tip
transactions
unacceptable_risks
unfulfilled_line_items
unique_gateways
user
void_transactions

Shop

Aşağıdaki listede, Shopify Order Printer'da kullanılabilen Mağaza özelliklerini gözden geçirin:

accepts_gift_cards
account_owner
allows_discounts
checkout
checkout_requires_confirmation_step
collections_count
contact_information
currency
customer_accounts_enabled
customer_accounts_optional
description
domain
email
email_accent_color
email_logo_url
email_logo_width
email_marketing
enabled_currencies
enabled_locales
enabled_payment_types
features
id
latitude
legal_notice
longitude
metafields
money_format
money_with_currency_format
name
password_message
permanent_domain
phone
policies
privacy_policy
products_count
refund_policy
secure_url
shipping_policy
subscription_policy
terms_of_sale
terms_of_service
types
url

LineItem

Aşağıdaki listede, Shopify Order Printer'da kullanılabilen Satır Öğesi özelliklerini gözden geçirin:

aggregated_update
applied_discounts. Tüm indirim türleri ve ayrıntıları kullanılamadığından kullanımdan kaldırıldı. line_item.discounts özelliği, line_item.discount_allocations ile değiştirildi.
current_quantity
discount_allocations
discounts. Tüm indirim türleri ve ayrıntıları kullanılamadığından kullanımdan kaldırıldı. line_item.discounts özelliği, line_item.discount_allocations ile değiştirildi.
final_line_price
final_price
fulfillment
fulfillment_service
gift_card
grams
groups
id
image
index
item_updates
json_filter
key
line_level_discount_allocations
line_level_total_discount
line_price. Otomatik indirimlerle ve indirim kodlarıyla yapılan indirimler dahil edilmediğinden kullanımdan kaldırıldı. line_item.line_price özelliği, line_item.final_line_price ile değiştirildi.
message
options_with_values
original_line_price
original_price
price. Otomatik indirimlerle ve indirim kodlarıyla yapılan indirimler dahil edilmediğinden kullanımdan kaldırıldı. line_item.price özelliği, line_item.final_price ile değiştirildi.
product
product_id
properties
quantity
refunded_quantity
requires_shipping
selling_plan_allocation
sku
successfully_fulfilled_quantity
tax_lines
taxable
title
total_discount. Otomatik indirimlerle ve indirim kodlarıyla yapılan indirimler dahil edilmediğinden kullanımdan kaldırıldı. line_item.total_discount özelliği, line_item.line_level_total_discount ile değiştirildi.
unit_price
unit_price_measurement
url
url_to_remove
variant
variant_id
vendor

Gönderim

Aşağıdaki listede, Shopify Order Printer'da kullanılabilen Gönderim özelliklerini gözden geçirin:

created_at. Zaman damgasını biçimlendirmek için date filtresini kullanın (örneğin, {{ fulfillment.created_at | date: "%B %e, %Y" }} ile).
estimated_delivery_at
fulfillment_line_items
item_count
line_items
requires_shipping
tracking_company
tracking_number
tracking_numbers
tracking_url
tracking_urls
updated_at

Adres

Aşağıdaki listede, Shopify Order Printer'da kullanılabilen Adres özelliklerini gözden geçirin:

address1
address2
city
company
country
country_code
country_upper
errors
first_name
id
last_name
name
phone
province
province_code
street
summary
translated_country_name
translated_province_name
url
zip

Müşteri

Aşağıdaki listede, Shopify Order Printer'da kullanılabilen Müşteri özelliklerini gözden geçirin:

accepts_marketing
account_activation_url
addresses
addresses_count
b2b?
default_address
email
first_name
has_account
id
last_name
last_order
metafields
name
new_address
orders
orders_count
payment_methods
phone
reset_password_url
subscribe_url
tags
tax_exempt
total_spent

DiscountApplication

Aşağıdaki listede, Shopify Order Printer'da kullanılabilen DiscountApplication özelliklerini gözden geçirin:

target_selection
target_type
title
total_allocated_amount
type
value_type
value

İndirimleri yazdırma

İndirimler, siparişin tamamına veya belirli satır öğelerine uygulanabilir:

Sipariş düzeyi indirimleri: Bu indirimler siparişin tamamına uygulanır. Sipariş faturanızı yazdırırken bu indirimleri ayrı olarak, alt kısımda gösterebilirsiniz.
Satır öğesi düzeyi indirimleri: Ayrı ürünlere uygulanır. Satır öğesi bölümünde ürün ayrıntılarını tek tek yazdırırken bu indirimlerden bahsedebilirsiniz.

İndirim bilgilerine, aşağıdaki değişkenleri kullanarak erişebilirsiniz:

Siparişe veya satır öğelerinden herhangi birine uygulanan tüm indirimlere , order.total_discounts değeri ve order.discount_applications koleksiyonuyla erişebilirsiniz.
Satır öğesi indirimlerine line_item.line_level_total_discount değeri veya line_item.line_level_discount_allocations koleksiyonuyla erişebilirsiniz.
- Satır öğesinin, herhangi bir indirim uygulanmadan önceki fiyatına line_item.original_price değeriyle erişebilirsiniz.
- İlgili tüm satır öğesi düzeyi indirimleri uygulandıktan sonraki satır öğesi sonuç fiyatına line_item.final_price değeriyle erişebilirsiniz.
- line_item.original_line_price ve line_item.final_line_price değerleri, line_item.original_price ve line_item.final_price değerlerinin line_item.quantity ile çarpımına eşittir.
Sipariş düzeyi indirimlerine order.cart_level_discount_applications koleksiyonuyla erişebilirsiniz.

Satır öğesi düzeyi indirimlerini yazdırmak için örnek kod bloğu:

{% for line_item in order.line_items %}
  <tr>
    <td>{{ line_item.quantity }}</td>
    <td>{{ line_item.title }}
    {% if line_item.line_level_discount_allocations.size > 0 %}
      <span class="subduedText">
        {% for discount_allocation in line_item.line_level_discount_allocations %}
        <br>{{ discount_allocation.discount_application.title }} (-{{ discount_allocation.amount | money }})
        {% endfor %}
      </span>
    {% endif %}
    </td>
    <td style="text-align: right;">
      {% if line_item.original_price != line_item.final_price %}
        <span class="subduedText"><s>{{ line_item.original_price | money }}</s></span>
      {% endif %}
      {{ line_item.final_price | money }}
    </td>
  </tr>
{% endfor %}

Sipariş düzeyindeki indirimleri yazdırmak için örnek kod bloğu:

{% for discount_application in order.cart_level_discount_applications %}
<tr>
  <td colspan="2" style="text-align: right;">{% if discount_application.title %}<span class="subduedText">{{ discount_application.title }}</span>{% endif %}</td>
  <td style="text-align: right;">-{{ discount_application.total_allocated_amount | money }}</td>
</tr>
{% endfor %}

İndirim türleri ve Liquid'de indirimlerle çalışma hakkında daha fazla bilgi edinin.

DiscountAllocation

Aşağıdaki listede, Shopify Order Printer'da kullanılabilen DiscountAllocation özelliklerini gözden geçirin:

amount
discount_application

İndirim

Aşağıdaki listede, Shopify Order Printer'da kullanılabilen İndirim özelliklerini gözden geçirin:

amount
code
free_shipping_discount
id
savings
title
total_amount
total_savings

Ürün

Aşağıdaki listede, Shopify Order Printer'da kullanılabilen Ürün özelliklerini gözden geçirin:

as_json
available
collections
compare_at_price
compare_at_price_max
compare_at_price_min
compare_at_price_varies
content
created_at
description
featured_image
featured_media
first_available_variant
gift_card?
handle
has_only_default_variant
id
images
json_filter
media
metafields
object_type
options
options_by_name
options_with_values
price
price_max
price_min
price_varies
published_at
requires_selling_plan
selected_or_first_available_selling_plan_allocation
selected_or_first_available_variant
selected_selling_plan
selected_selling_plan_allocation
selected_variant
selling_plan_groups
tags
template_suffix
title
type
url
variants
vendor

Variant

Aşağıdaki listede, Shopify Order Printer'da kullanılabilen Varyasyon özelliklerini gözden geçirin:

as_json
available
barcode
compare_at_price
featured_image
featured_media
id
image
incoming
inventory_management
inventory_policy
inventory_quantity
json_filter
metafields
next_incoming_date
option1
option2
option3
options
price
product
requires_selling_plan
requires_shipping
selected_selling_plan_allocation
selling_plan_allocations
sku
store_availabilities
taxable
title
unit_price
unit_price_measurement
url
weight
weight_in_unit
weight_unit

Para iadesi

Aşağıdaki listede, Shopify Order Printer'da kullanılabilen Para İadesi özelliklerini gözden geçirin:

amount
created_at
id
note
refund_line_items
restock
transactions

Kargo Satırı

Aşağıdaki listede, Shopify Order Printer'da kullanılabilen Kargo Satırı özelliklerini gözden geçirin:

handle
id
original_price
tax_lines
title

Vergi Satırı

Aşağıdaki listede, Shopify Order Printer'da kullanılabilen Vergi Satırı özelliklerini gözden geçirin:

price
rate
rate_percentage
title

İşlem

Aşağıdaki listede, Shopify Order Printer'da kullanılabilen İşlem özelliklerini gözden geçirin:

amount
buyer_pending_payment_instructions
buyer_pending_payment_notice
created_at
gateway
gateway_display_name
id
kind
name
payment_details
receipt
show_buyer_pending_payment_instructions
status
status_label

Meta alan

Bir üst nesneye ekli meta alan. Belirli bir nesnedeki meta alana erişme hakkında bilgi edinmek için Meta alanlara erişme bölümüne bakın.

Meta alanlar, meta alanda saklanan bilgi türünü belirleyen birden fazla veri türünü destekler. Meta alanlara erişmek için kullanılan meta alan erişim yolları iki katmandan oluşur:

Ad alanı: Çakışmaları önlemek için meta alanlardan oluşan bir grup,
Anahtar - Meta alan adı.

Bu göz önüne alındığında, meta alan nesnesine şu sözdizimini kullanarak erişebilirsiniz: {{ resource.metafields.namespace.key }}.

Adlandırma: <object>.metafields.<namespace>.<key>. Örneğin, order.metafields.shipping.express_delivery_status.

Türler:

String
Array - Dizin oluşturmak için [] kullanın. Örneğin, order.metafield.shipping.express_delivery_status[0]
Integer
Boolean
Date

Metaobject türünün desteklenmediğini unutmayın.

Meta alanları destekleyen nesneler:

Order
Customer
Product
Variant
Location

Shopify Order Printer'da kullanılabilen Liquid filtreleri

Kullanım

Bir çıktıya filtre uygulamak için, filtreyi ve varsa filtre parametrelerini, öncesinde bir dikey çizgi karakteri | olacak şekilde, çıktının küme parantezi sınırlayıcılarının arasına {{ }} ekleyin. Aşağıdaki örnekte ürün nesnedir, başlık nesnenin özelliğidir ve uygulanan filtre büyük harftir:

{{ product.title | upcase }}

product.title, Health potion değerine sahipse upcase filtresinin çıktısı HEALTH POTION olur.

Liquid filtrelerinin nasıl kullanılacağıyla ilgili ayrıntı bilgi için Shopify Temaları Liquid referansının Filtreler bölümüne bakın.

Adres nesnelerine uygulanan filtreler

format_address

Kullanım örnekleri için format_address ile ilgili Shopify Temaları Liquid belgesine bakın.

Herhangi bir metne/dizeye uygulanan filtreler

camelcase
camelize
encode_url_component
format_code
handle
highlight
pad_spaces
paragraphize
pluralize
url_escape
url_param_escape

Kullanım örnekleri için dize filtreleri ile ilgili Shopify Temaları Liquid belgelerine bakın.

Para anlamına gelen sayılara uygulanan filtreler

money
money_with_currency
money_without_currency
money_without_trailing_zeros

Shopify Order Printer, para biçimlendirmesi için Shopify yöneticisinde yapılandırılan, e-posta bildirimlerine yönelik para birimi biçimlendirme seçeneklerini kullanır. Para birimi biçimlendirmesini değiştirebilirsiniz. Shopify Order Printer'da para filtreleri biçimlendirmesini değiştirmek için Shopify yöneticisinde Email with currency ve Email without currency değerlerini ayarlayın.

Kullanım örnekleri için para filtreleri ile ilgili Shopify Temaları Liquid belgesine bakın.

Nesneleri json'a dönüştürmek için uygulanan filtreler

json

Kullanım örnekleri için json filtreleri ile ilgili Shopify Temaları Liquid belgesine bakın.

Ağırlık anlamına gelen sayılara uygulanacak filtreler

weight
weight_with_unit

Kullanım örnekleri için birime sahip ağırlık ile ilgili Shopify Temaları Liquid belgelerine bakın.

Etiketlere uygulanacak filtreler

highlight_active_tag
link_to_add_tag
link_to_remove_tag
link_to_tag

Kullanım örnekleri için etiket filtreleri ile ilgili Shopify Temaları Liquid belgesine bakın.

URL'lere uygulanan filtreler

article_img_url
asset_img_url
asset_url
cdn_asset_url
collection_img_url
file_img_url
file_url
global_asset_url
image_url
img_tag
img_url
link_to
payment_icon_png_url
payment_type_img_url
payment_type_svg_tag
placeholder_svg_tag
product_img_url
script_tag
shopify_asset_url
stylesheet_tag

Kullanım örnekleri için medya ve html filtreleriyle ilgili Shopify Temaları Liquid belgelerine bakın.

Koleksiyonlara uygulanan filtreler

link_to_type
link_to_vendor
sort_by
url_for_type
url_for_vendor
within

Kullanım örnekleri için koleksiyon filtreleri ile ilgili Shopify Temaları Liquid belgesine bakın.