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_itemstax_linesfulfillmentstransactionsdiscountsrefundsshipping_methodscustomer
მაგალითად, თუ გსურს წვდომა ხაზის ელემენტების ცვლადზე, შეგიძლია გამოიყენო line_items ან order.line_items.
Shopify Order Printer-ში ხელმისაწვდომი Liquid ცვლადები
ხელმისაწვდომია შემდეგი კლასები. ატრიბუტები ჩამოთვლილია ანბანური თანმიმდევრობით.
შეკვეთა
შეკვეთის შემდეგი ატრიბუტები ხელმისაწვდომია Shopify Order Printer-ში:
attributesb2bbilling_addresscancel_reasoncancel_reason_labelcancelledcancelled_atcart_level_discount_applicationscheckout_idcheckout_payment_collection_urlcompanycompany_locationconfirmation_numbercreated_at. დრო, როდესაც შეკვეთა დამუშავდა. ეს უდრისorder.processed_at-ს GraphQL API-დან. გამოიყენეdateფილტრი დროის ნიშნულის დასაფორმატებლად, მაგალითად,{{ order.created_at | date: "%B %e, %Y" }}-ით.customerdiscounts. მოძველებულია, რადგან ყველა ტიპის ფასდაკლება და დეტალი არ აღირიცხება.order.discountsთვისება შეიცვალაorder.discount_applications-ით.discounts_amount. მოძველებულია, რადგან ყველა ტიპის ფასდაკლება და დეტალი არ აღირიცხება.order.discountsთვისება შეიცვალაorder.total_discounts-ით.discount_applicationsdiscounts_savings. მოძველებულია, რადგან ყველა ტიპის ფასდაკლება და დეტალი არ აისახება.order.discountsთვისება შეიცვალა შემდეგით:-.emailfeesfinancial_statusfinancial_status_labelfulfilled_line_itemsfulfillment_abortedfulfillment_statusfulfillmentsgatewayiditem_countlanding_sitelanding_site_refline_itemsline_items_subtotal_pricelocationmetafieldsnamenet_paymentnoteorder_nameorder_numberorder_status_urlpaymentpayment_detailspo_numberrefundsrequires_shippingshipping_addressshipping_methodshipping_methodsshipping_priceshopshop_namesubtotal_pricetagstax_linestax_pricetip_line_itemstotal_discountstotal_dutiestotal_landed_cost_additional_feestotal_net_amounttotal_outstandingtotal_pricetotal_refunded_amounttotal_tiptransactionsunacceptable_risksunfulfilled_line_itemsunique_gatewaysuservoid_transactions
Shop
გადახედე Shop-ის ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:
accepts_gift_cardsaccount_ownerallows_discountscheckoutcheckout_requires_confirmation_stepcollections_countcontact_informationcurrencycustomer_accounts_enabledcustomer_accounts_optionaldescriptiondomainemailemail_accent_coloremail_logo_urlemail_logo_widthemail_marketingenabled_currenciesenabled_localesenabled_payment_typesfeaturesidlatitudelegal_noticelongitudemetafieldsmoney_formatmoney_with_currency_formatnamepassword_messagepermanent_domainphonepoliciesprivacy_policyproducts_countrefund_policysecure_urlshipping_policysubscription_policyterms_of_saleterms_of_servicetypesurl
LineItem
გაეცანი ხაზის ელემენტის ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:
aggregated_updateapplied_discounts. მოძველებულია, რადგან ყველა ფასდაკლების ტიპი და დეტალი არ არის ხელმისაწვდომი.line_item.discountsთვისება ჩანაცვლდაline_item.discount_allocations-ით.current_quantitydiscount_allocationsdiscounts. მოძველებულია, რადგან ფასდაკლების ყველა ტიპი და დეტალი არ არის ხელმისაწვდომი.line_item.discountsთვისება ჩანაცვლდაline_item.discount_allocations-ით.final_line_pricefinal_pricefulfillmentfulfillment_servicegift_cardgramsgroupsidimageindexitem_updatesjson_filterkeyline_level_discount_allocationsline_level_total_discountline_price. მოძველებულია, რადგან არ მოიცავს ფასდაკლებებს ავტომატური ფასდაკლებებიდან და ფასდაკლების კოდებიდან.line_item.line_priceთვისება ჩანაცვლდაline_item.final_line_price-ით.messageoptions_with_valuesoriginal_line_priceoriginal_priceprice. მოძველებულია, რადგან არ მოიცავს ფასდაკლებებს ავტომატური ფასდაკლებებიდან და ფასდაკლების კოდებიდან.line_item.priceთვისება ჩანაცვლდაline_item.final_price-ით.productproduct_idpropertiesquantityrefunded_quantityrequires_shippingselling_plan_allocationskusuccessfully_fulfilled_quantitytax_linestaxabletitletotal_discount. მოძველებულია, რადგან არ მოიცავს ფასდაკლებებს ავტომატური ფასდაკლებებიდან და ფასდაკლების კოდებიდან.line_item.total_discountთვისება ჩანაცვლდაline_item.line_level_total_discount-ით.unit_priceunit_price_measurementurlurl_to_removevariantvariant_idvendor
შეკვეთის შესრულება
გაეცანი შეკვეთის შესრულების ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:
created_at. დროის ნიშნულის დასაფორმატებლად გამოიყენეdateფილტრი, მაგალითად:{{ fulfillment.created_at | date: "%B %e, %Y" }}.estimated_delivery_atfulfillment_line_itemsitem_countline_itemsrequires_shippingtracking_companytracking_numbertracking_numberstracking_urltracking_urlsupdated_at
მისამართი
გაეცანი მისამართის ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:
address1address2citycompanycountrycountry_codecountry_uppererrorsfirst_nameidlast_namenamephoneprovinceprovince_codestreetsummarytranslated_country_nametranslated_province_nameurlzip
მომხმარებელი
გაეცანი მომხმარებლის ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:
accepts_marketingaccount_activation_urladdressesaddresses_countb2b?default_addressemailfirst_namehas_accountidlast_namelast_ordermetafieldsnamenew_addressordersorders_countpayment_methodsphonereset_password_urlsubscribe_urltagstax_exempttotal_spent
DiscountApplication
გაეცანი DiscountApplication-ის ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:
target_selectiontarget_typetitletotal_allocated_amounttypevalue_typevalue
ფასდაკლებების ბეჭდვა
ფასდაკლებები შესაძლებელია გამოყენებულ იქნას სრულ შეკვეთაზე ან კონკრეტულ ხაზის ელემენტებზე:
- შეკვეთის დონის ფასდაკლებები: ისინი ვრცელდება მთლიან შეკვეთაზე. შეკვეთის ინვოისის ბეჭდვისას ეს ფასდაკლებები შეგიძლია ცალკე აჩვენო, ქვედა ნაწილში.
- ხაზის ელემენტის დონის ფასდაკლებები: ისინი ვრცელდება ინდივიდუალურ ერთეულებზე. ამ ფასდაკლებების მითითება შეგიძლია ხაზის ელემენტის სექციაში ცალკეული ერთეულის დეტალების ბეჭდვისას.
ფასდაკლებების ინფორმაციაზე წვდომა შეგიძლია შემდეგი ცვლადების გამოყენებით:
- მოიპოვე წვდომა შეკვეთაზე ან მის რომელიმე ხაზის ელემენტზე გამოყენებულ ყველა ფასდაკლებაზე
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 %}- შეიტყვე მეტი ფასდაკლების ტიპებისა და Liquid-ში ფასდაკლებებთან მუშაობის შესახებ.
DiscountAllocation
გაეცანი DiscountAllocation-ის ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:
amountdiscount_application
Discount
გაეცანი Discount-ის ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:
amountcodefree_shipping_discountidsavingstitletotal_amounttotal_savings
Product
გაეცანი Product-ის ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:
as_jsonavailablecollectionscompare_at_pricecompare_at_price_maxcompare_at_price_mincompare_at_price_variescontentcreated_atdescriptionfeatured_imagefeatured_mediafirst_available_variantgift_card?handlehas_only_default_variantidimagesjson_filtermediametafieldsobject_typeoptionsoptions_by_nameoptions_with_valuespriceprice_maxprice_minprice_variespublished_atrequires_selling_planselected_or_first_available_selling_plan_allocationselected_or_first_available_variantselected_selling_planselected_selling_plan_allocationselected_variantselling_plan_groupstagstemplate_suffixtitletypeurlvariantsvendor
ვარიანტი
გადახედე ვარიანტის ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:
as_jsonavailablebarcodecompare_at_pricefeatured_imagefeatured_mediaidimageincominginventory_managementinventory_policyinventory_quantityjson_filtermetafieldsnext_incoming_dateoption1option2option3optionspriceproductrequires_selling_planrequires_shippingselected_selling_plan_allocationselling_plan_allocationsskustore_availabilitiestaxabletitleunit_priceunit_price_measurementurlweightweight_in_unitweight_unit
თანხის დაბრუნება
გადახედე თანხის დაბრუნების ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:
amountcreated_atidnoterefund_line_itemsrestocktransactions
მიწოდების ხაზი
გადახედე მიწოდების ხაზის ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:
handleidoriginal_priceprice. მოძველებულია, რადგან ფასში არ შედიოდა შეკვეთის დონის ფასდაკლებები.shipping_line.priceთვისება შეიცვალაshipping_line.price_with_discountsთვისებით.price_with_discountstax_linestitle
გადასახადის ხაზი
გადახედე გადასახადის ხაზის ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:
priceraterate_percentagetitle
ტრანზაქცია
გადახედე ტრანზაქციის ატრიბუტების შემდეგ სიას, რომლებიც ხელმისაწვდომია Shopify Order Printer-ში:
amountbuyer_pending_payment_instructionsbuyer_pending_payment_noticecreated_atgatewaygateway_display_nameidkindnamepayment_detailsreceiptshow_buyer_pending_payment_instructionsstatusstatus_label
მეტაველი
მშობელ ობიექტზე მიმაგრებული მეტაველი. იმის გასაგებად, თუ როგორ უნდა მიიღო წვდომა მეტაველზე კონკრეტულ ობიექტში, იხილე მეტაველებზე წვდომა.
მეტაველებს აქვთ მონაცემთა მრავალი ტიპის მხარდაჭერა, რომლებიც განსაზღვრავენ, თუ რა სახის ინფორმაცია ინახება მეტაველში. მეტაველებზე წვდომისთვის, მეტაველების წვდომის გზა ორი ფენისგან შედგება:
- სახელთა სივრცე — მეტაველების დაჯგუფება კონფლიქტების თავიდან ასაცილებლად,
- გასაღები — მეტაველის სახელი.
აქედან გამომდინარე, მეტაველის ობიექტზე წვდომა შეგიძლია შემდეგი სინტაქსით: {{ resource.metafields.namespace.key }}.
დასახელება: <object>.metafields.<namespace>.<key>. მაგალითად: order.metafields.shipping.express_delivery_status.
ტიპები:
StringArray— ინდექსირებისთვის გამოიყენე[ ]. მაგალითად:order.metafield.shipping.express_delivery_status[0]IntegerBooleanDate
შენიშვნა: Metaobject ტიპს მხარდაჭერა არ აქვს.
ობიექტები, რომლებსაც აქვთ მეტაველების მხარდაჭერა:
OrderCustomerProductVariantLocation
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-ისთვის.
ფილტრები, რომლებიც გამოიყენება ნებისმიერ ტექსტზე / სტრიქონზე
camelcasecamelizeencode_url_componentformat_codehandlehighlightpad_spacesparagraphizepluralizeurl_escapeurl_param_escape
გამოყენების მაგალითებისთვის იხილე Shopify-ს თემების Liquid-ის დოკუმენტაცია სტრიქონის ფილტრების შესახებ.
ფილტრები, რომლებიც გამოიყენება ფულის მნიშვნელობის მქონე რიცხვებისთვის
moneymoney_with_currencymoney_without_currencymoney_without_trailing_zeros
Shopify Order Printer თანხის ფორმატირებისთვის იყენებს ელფოსტის შეტყობინებების ვალუტის ფორმატირების პარამეტრებს, რომლებიც კონფიგურირებულია Shopify-ს ადმინში.
შენ შეგიძლია ვალუტის ფორმატირების შეცვლა. დააყენე მნიშვნელობები Email with currency და Email without currency Shopify-ს ადმინში, რათა შეცვალო თანხის ფილტრების ფორმატირება Shopify Order Printer-ში.
გამოყენების მაგალითებისთვის იხილე Shopify-ს თემების Liquid-ის დოკუმენტაცია თანხის ფილტრების შესახებ.
ფილტრები, რომლებიც გამოიყენება ობიექტების json-ად კონვერტირებისთვის
json
გამოყენების მაგალითებისთვის იხილე Shopify-ს თემების Liquid-ის დოკუმენტაცია json-ის ფილტრების შესახებ.
ფილტრები, რომლებიც გამოიყენება წონის მნიშვნელობის მქონე რიცხვებისთვის
weightweight_with_unit
გამოყენების მაგალითებისთვის იხილე Shopify-ს თემების Liquid-ის დოკუმენტაცია ერთეულის მქონე წონის შესახებ.
ფილტრები, რომლებიც გამოიყენება თეგებისთვის
highlight_active_taglink_to_add_taglink_to_remove_taglink_to_tag
გამოყენების მაგალითებისთვის იხილე Shopify-ს თემების Liquid-ის დოკუმენტაცია თეგის ფილტრების შესახებ.
ფილტრები, რომლებიც გამოიყენება URL-ებისთვის
article_img_urlasset_img_urlasset_urlcdn_asset_urlcollection_img_urlfile_img_urlfile_urlglobal_asset_urlimage_urlimg_tagimg_urllink_topayment_icon_png_urlpayment_type_img_urlpayment_type_svg_tagplaceholder_svg_tagproduct_img_urlscript_tagshopify_asset_urlstylesheet_tag
მხარდაჭერილი მედიის ფილტრების გამოყენების მაგალითებისთვის იხილე Shopify-ს თემების Liquid-ის დოკუმენტაცია მედიის ფილტრების შესახებ.
ფილტრები, რომლებიც გამოიყენება კოლექციებისთვის
link_to_typelink_to_vendorsort_byurl_for_typeurl_for_vendorwithin
გამოყენების მაგალითებისთვის იხილე Shopify-ს თემების Liquid-ის დოკუმენტაცია კოლექციის ფილტრების შესახებ.