Liquid ცვლადებისა და ფილტრების ცნობარი Shopify Order Printer-ისთვის

შეგიძლია გამოიყენო Liquid საკუთარი, მორგებული შაბლონების შესაქმნელად Shopify Order Printer აპით. Liquid-ის საშუალებით, შეგიძლია შექმნა ტექსტური შაბლონები და გამოიტანო ისინი თითოეული შეკვეთის უნიკალური მონაცემების საფუძველზე.

ამ გვერდზე მოცემული Liquid-ის ცნობარები Liquid-ის ღია კოდის მქონე ვერსიის გაფართოებაა და განკუთვნილია Shopify Order Printer აპში გამოსაყენებლად. order და shop ატრიბუტებზე დაფუძნებული ინფორმაციის გამოსატანად, შეგიძლია გამოიყენო ამ ცნობარში მოცემული ობიექტების, თეგებისა და ფილტრების სია შენი შაბლონების მოსარგებად. ასევე შეგიძლია გამოიყენო Admin GraphQL API-ის დოკუმენტაცია ობიექტის ველების შესახებ დეტალების გასაგებად.

ცვლადებისა და ატრიბუტების გამოყენება

Shopify Order Printer-ის შაბლონებში ძირითადი მონაცემთა ობიექტებია order და shop. შეკვეთის ატრიბუტებზე წვდომისთვის შეგიძლია გამოიყენო order.variable_name.

შეკვეთის შემდეგი, ხშირად გამოყენებული ატრიბუტები ხელმისაწვდომია order. პრეფიქსის გარეშე:

  • line_items
  • tax_lines
  • fulfillments
  • transactions
  • discounts
  • refunds
  • shipping_methods
  • customer

მაგალითად, თუ გსურს წვდომა ხაზის ელემენტების ცვლადზე, შეგიძლია გამოიყენო line_items ან order.line_items.

Shopify Order Printer-ში ხელმისაწვდომი Liquid ცვლადები

ხელმისაწვდომია შემდეგი კლასები. ატრიბუტები ჩამოთვლილია ანბანური თანმიმდევრობით.

შეკვეთა

შეკვეთის შემდეგი ატრიბუტები ხელმისაწვდომია Shopify Order Printer-ში:

  • 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. დრო, როდესაც შეკვეთა დამუშავდა. ეს უდრის order.processed_at-ს GraphQL API-დან. გამოიყენე date ფილტრი დროის ნიშნულის დასაფორმატებლად, მაგალითად, {{ order.created_at | date: "%B %e, %Y" }}-ით.
  • customer
  • discounts. მოძველებულია, რადგან ყველა ტიპის ფასდაკლება და დეტალი არ აღირიცხება. order.discounts თვისება შეიცვალა order.discount_applications-ით.
  • discounts_amount. მოძველებულია, რადგან ყველა ტიპის ფასდაკლება და დეტალი არ აღირიცხება. order.discounts თვისება შეიცვალა order.total_discounts-ით.
  • discount_applications
  • discounts_savings. მოძველებულია, რადგან ყველა ტიპის ფასდაკლება და დეტალი არ აისახება. order.discounts თვისება შეიცვალა შემდეგით: -.
  • 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

გადახედე Shop-ის ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:

  • 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

გაეცანი ხაზის ელემენტის ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:

  • aggregated_update
  • applied_discounts. მოძველებულია, რადგან ყველა ფასდაკლების ტიპი და დეტალი არ არის ხელმისაწვდომი. line_item.discounts თვისება ჩანაცვლდა line_item.discount_allocations-ით.
  • current_quantity
  • discount_allocations
  • discounts. მოძველებულია, რადგან ფასდაკლების ყველა ტიპი და დეტალი არ არის ხელმისაწვდომი. line_item.discounts თვისება ჩანაცვლდა line_item.discount_allocations-ით.
  • 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. მოძველებულია, რადგან არ მოიცავს ფასდაკლებებს ავტომატური ფასდაკლებებიდან და ფასდაკლების კოდებიდან. line_item.line_price თვისება ჩანაცვლდა line_item.final_line_price-ით.
  • message
  • options_with_values
  • original_line_price
  • original_price
  • price. მოძველებულია, რადგან არ მოიცავს ფასდაკლებებს ავტომატური ფასდაკლებებიდან და ფასდაკლების კოდებიდან. line_item.price თვისება ჩანაცვლდა line_item.final_price-ით.
  • product
  • product_id
  • properties
  • quantity
  • refunded_quantity
  • requires_shipping
  • selling_plan_allocation
  • sku
  • successfully_fulfilled_quantity
  • tax_lines
  • taxable
  • title
  • total_discount. მოძველებულია, რადგან არ მოიცავს ფასდაკლებებს ავტომატური ფასდაკლებებიდან და ფასდაკლების კოდებიდან. line_item.total_discount თვისება ჩანაცვლდა line_item.line_level_total_discount-ით.
  • unit_price
  • unit_price_measurement
  • url
  • url_to_remove
  • variant
  • variant_id
  • vendor

შეკვეთის შესრულება

გაეცანი შეკვეთის შესრულების ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:

  • created_at. დროის ნიშნულის დასაფორმატებლად გამოიყენე date ფილტრი, მაგალითად: {{ fulfillment.created_at | date: "%B %e, %Y" }}.
  • estimated_delivery_at
  • fulfillment_line_items
  • item_count
  • line_items
  • requires_shipping
  • tracking_company
  • tracking_number
  • tracking_numbers
  • tracking_url
  • tracking_urls
  • updated_at

მისამართი

გაეცანი მისამართის ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:

  • 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

მომხმარებელი

გაეცანი მომხმარებლის ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:

  • 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

გაეცანი DiscountApplication-ის ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:

  • target_selection
  • target_type
  • title
  • total_allocated_amount
  • type
  • value_type
  • value

ფასდაკლებების ბეჭდვა

ფასდაკლებები შესაძლებელია გამოყენებულ იქნას სრულ შეკვეთაზე ან კონკრეტულ ხაზის ელემენტებზე:

  • შეკვეთის დონის ფასდაკლებები: ისინი ვრცელდება მთლიან შეკვეთაზე. შეკვეთის ინვოისის ბეჭდვისას ეს ფასდაკლებები შეგიძლია ცალკე აჩვენო, ქვედა ნაწილში.
  • ხაზის ელემენტის დონის ფასდაკლებები: ისინი ვრცელდება ინდივიდუალურ ერთეულებზე. ამ ფასდაკლებების მითითება შეგიძლია ხაზის ელემენტის სექციაში ცალკეული ერთეულის დეტალების ბეჭდვისას.

ფასდაკლებების ინფორმაციაზე წვდომა შეგიძლია შემდეგი ცვლადების გამოყენებით:

  • მოიპოვე წვდომა შეკვეთაზე ან მის რომელიმე ხაზის ელემენტზე გამოყენებულ ყველა ფასდაკლებაზე order.total_discounts მნიშვნელობისა და order.discount_applications კოლექციის გამოყენებით.
  • მოიპოვე წვდომა ხაზის ელემენტის ფასდაკლებებზე line_item.line_level_total_discount მნიშვნელობის ან line_item.line_level_discount_allocations კოლექციის გამოყენებით.
  • მოიპოვე წვდომა ხაზის ელემენტის საწყის ფასზე (ნებისმიერი ფასდაკლების გამოყენებამდე) line_item.original_price მნიშვნელობის გამოყენებით.
  • მოიპოვე წვდომა ხაზის ელემენტის საბოლოო ფასზე (ხაზის ელემენტის დონის ყველა შესაბამისი ფასდაკლების გამოყენების შემდეგ) line_item.final_price მნიშვნელობის გამოყენებით.
  • line_item.original_line_price და line_item.final_line_price მნიშვნელობები უდრის line_item.quantity-ზე გამრავლებულ line_item.original_price და line_item.final_price მნიშვნელობებს.
  • მოიპოვე წვდომა შეკვეთის დონის ფასდაკლებებზე order.cart_level_discount_applications კოლექციის გამოყენებით.

კოდის ბლოკის მაგალითი ხაზის ელემენტის დონის ფასდაკლებების საბეჭდად:

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

კოდის ბლოკის მაგალითი შეკვეთის დონის ფასდაკლებების საბეჭდად:

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

გაეცანი DiscountAllocation-ის ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:

  • amount
  • discount_application

Discount

გაეცანი Discount-ის ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:

  • amount
  • code
  • free_shipping_discount
  • id
  • savings
  • title
  • total_amount
  • total_savings

Product

გაეცანი Product-ის ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:

  • 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

ვარიანტი

გადახედე ვარიანტის ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:

  • 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

თანხის დაბრუნება

გადახედე თანხის დაბრუნების ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:

  • amount
  • created_at
  • id
  • note
  • refund_line_items
  • restock
  • transactions

მიწოდების ხაზი

გადახედე მიწოდების ხაზის ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:

  • handle
  • id
  • original_price
  • price. მოძველებულია, რადგან ფასში არ შედიოდა შეკვეთის დონის ფასდაკლებები. shipping_line.price თვისება შეიცვალა shipping_line.price_with_discounts თვისებით.
  • price_with_discounts
  • tax_lines
  • title

გადასახადის ხაზი

გადახედე გადასახადის ხაზის ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:

  • price
  • rate
  • rate_percentage
  • title

ტრანზაქცია

გადახედე ტრანზაქციის ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:

  • 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

მეტაველი

მშობელ ობიექტზე მიმაგრებული მეტაველი. იმის გასაგებად, თუ როგორ უნდა მიიღო წვდომა მეტაველზე კონკრეტულ ობიექტში, იხილე მეტაველებზე წვდომა.

მეტაველებს აქვთ მონაცემთა მრავალი ტიპის მხარდაჭერა, რომლებიც განსაზღვრავენ, თუ რა სახის ინფორმაცია ინახება მეტაველში. მეტაველებზე წვდომისთვის, მეტაველების წვდომის გზა ორი ფენისგან შედგება:

  • სახელთა სივრცე — მეტაველების დაჯგუფება კონფლიქტების თავიდან ასაცილებლად,
  • გასაღები — მეტაველის სახელი.

აქედან გამომდინარე, მეტაველის ობიექტზე წვდომა შეგიძლია შემდეგი სინტაქსით: {{ resource.metafields.namespace.key }}.

დასახელება: <object>.metafields.<namespace>.<key>. მაგალითად: order.metafields.shipping.express_delivery_status.

ტიპები:

  • String
  • Array — ინდექსირებისთვის გამოიყენე [ ]. მაგალითად: order.metafield.shipping.express_delivery_status[0]
  • Integer
  • Boolean
  • Date

შენიშვნა: Metaobject ტიპს მხარდაჭერა არ აქვს.

ობიექტები, რომლებსაც აქვთ მეტაველების მხარდაჭერა:

  • Order
  • Customer
  • Product
  • Variant
  • Location

Liquid-ის ფილტრები, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში

გამოყენება

გამოტანილ შედეგზე ფილტრების გამოსაყენებლად დაამატე ფილტრი და ფილტრის ნებისმიერი პარამეტრი ფიგურული ფრჩხილების {{ }} შიგნით, რომელთა წინ დაწერილი იქნება ვერტიკალური ხაზის სიმბოლო |. ქვემოთ მოცემულ მაგალითში, product არის ობიექტი, title არის მისი თვისება, ხოლო upcase არის გამოყენებული ფილტრი:

{{ product.title | upcase }}

თუ product.title-ს აქვს Health potion მნიშვნელობა, HEALTH POTION იქნება upcase ფილტრის შედეგი.

Liquid-ის ფილტრების გამოყენების შესახებ დეტალებისთვის იხილე ფილტრების სექცია Shopify-ის თემების Liquid-ის ცნობარიდან.

ფილტრები, რომლებიც გამოიყენება მისამართის ობიექტებზე

  • format_address

გამოყენების მაგალითებისთვის იხილე Shopify-ის თემების Liquid-ის დოკუმენტაცია format_address-ისთვის.

ფილტრები, რომლებიც გამოიყენება ნებისმიერ ტექსტზე / სტრიქონზე

  • camelcase
  • camelize
  • encode_url_component
  • format_code
  • handle
  • highlight
  • pad_spaces
  • paragraphize
  • pluralize
  • url_escape
  • url_param_escape

გამოყენების მაგალითებისთვის იხილე Shopify-ს თემების Liquid-ის დოკუმენტაცია სტრიქონის ფილტრების შესახებ.

ფილტრები, რომლებიც გამოიყენება ფულის მნიშვნელობის მქონე რიცხვებისთვის

  • money
  • money_with_currency
  • money_without_currency
  • money_without_trailing_zeros

Shopify Order Printer თანხის ფორმატირებისთვის იყენებს ელფოსტის შეტყობინებების ვალუტის ფორმატირების პარამეტრებს, რომლებიც კონფიგურირებულია Shopify-ს ადმინში. შენ შეგიძლია ვალუტის ფორმატირების შეცვლა. დააყენე მნიშვნელობები Email with currency და Email without currency Shopify-ს ადმინში, რათა შეცვალო თანხის ფილტრების ფორმატირება Shopify Order Printer-ში.

გამოყენების მაგალითებისთვის იხილე Shopify-ს თემების Liquid-ის დოკუმენტაცია თანხის ფილტრების შესახებ.

ფილტრები, რომლებიც გამოიყენება ობიექტების json-ად კონვერტირებისთვის

  • json

გამოყენების მაგალითებისთვის იხილე Shopify-ს თემების Liquid-ის დოკუმენტაცია json-ის ფილტრების შესახებ.

ფილტრები, რომლებიც გამოიყენება წონის მნიშვნელობის მქონე რიცხვებისთვის

  • weight
  • weight_with_unit

გამოყენების მაგალითებისთვის იხილე Shopify-ს თემების Liquid-ის დოკუმენტაცია ერთეულის მქონე წონის შესახებ.

ფილტრები, რომლებიც გამოიყენება თეგებისთვის

  • highlight_active_tag
  • link_to_add_tag
  • link_to_remove_tag
  • link_to_tag

გამოყენების მაგალითებისთვის იხილე Shopify-ს თემების Liquid-ის დოკუმენტაცია თეგის ფილტრების შესახებ.

ფილტრები, რომლებიც გამოიყენება URL-ებისთვის

  • 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

მხარდაჭერილი მედიის ფილტრების გამოყენების მაგალითებისთვის იხილე Shopify-ს თემების Liquid-ის დოკუმენტაცია მედიის ფილტრების შესახებ.

ფილტრები, რომლებიც გამოიყენება კოლექციებისთვის

  • link_to_type
  • link_to_vendor
  • sort_by
  • url_for_type
  • url_for_vendor
  • within

გამოყენების მაგალითებისთვის იხილე Shopify-ს თემების Liquid-ის დოკუმენტაცია კოლექციის ფილტრების შესახებ.