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.

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

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.

Shopify ile satış yapmaya hazır mısınız?

Ücretsiz olarak dene