Liquid mainīgo un filtru atsauce lietotnei Shopify Order Printer
Tu vari izmantot Liquid, lai veidotu savas pielāgotās veidnes, izmantojot lietotni Shopify Order Printer. Ar Liquid vari izveidot teksta veidnes un attēlot tās, pamatojoties uz katra pasūtījuma unikālajiem datiem.
Šajā lapā norādītās Liquid atsauces ir atvērtā pirmkoda Liquid versijas paplašinājums, kas paredzēts lietošanai lietotnē Shopify Order Printer. Lai attēlotu informāciju, pamatojoties uz order un shop atribūtiem, vari izmantot šajā atsaucē sniegto objektu, tagu un filtru sarakstu, lai pielāgotu savas veidnes. Vari arī izmantot Admin GraphQL API dokumentāciju, lai uzzinātu papildinformāciju par objektu laukiem.
Šajā lapā
Mainīgo un atribūtu izmantošana
Lietotnes Shopify Order Printer veidnēs galvenie datu objekti ir order un shop. Lai piekļūtu pasūtījuma atribūtiem, izmanto order.variable_name.
Tālāk minētajiem bieži izmantotajiem pasūtījuma atribūtiem var piekļūt bez priedēkļa order.:
line_itemstax_linesfulfillmentstransactionsdiscountsrefundsshipping_methodscustomer
Piemēram, ja vēlies piekļūt rindas vienumu mainīgajam, vari izmantot line_items vai order.line_items.
Lietotnē Shopify Order Printer pieejamie Liquid mainīgie
Ir pieejamas tālāk norādītās klases. Atribūti ir uzskaitīti alfabētiskā secībā.
Pasūtījums
Lietotnē Shopify Order Printer ir pieejami tālāk minētie pasūtījumu atribūti:
attributesb2bbilling_addresscancel_reasoncancel_reason_labelcancelledcancelled_atcart_level_discount_applicationscheckout_idcheckout_payment_collection_urlcompanycompany_locationconfirmation_numbercreated_at. Laiks, kad pasūtījums apstrādāts. Tas ir vienāds arorder.processed_atno GraphQL API. Izmantodatefiltru, lai formatētu laikspiedolu, piemēram, ar{{ order.created_at | date: "%B %e, %Y" }}.customerdiscounts. Novecojis, jo netiek tverti visi atlaižu veidi un informācija. Rekvizītsorder.discountsir aizstāts arorder.discount_applications.discounts_amount. Novecojis, jo netiek tverti visi atlaižu veidi un informācija. Rekvizītsorder.discountsir aizstāts arorder.total_discounts.discount_applicationsdiscounts_savings. Novecojis, jo netiek fiksēti visi atlaižu veidi un informācija. Īpašībaorder.discountsir aizstāta ar-.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
Pārskati tālāk norādīto sarakstu ar Shop atribūtiem, kas ir pieejami lietotnē 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
Pārskati tālāk sniegto Shopify Order Printer pieejamo rindas vienuma atribūtu sarakstu:
aggregated_updateapplied_discounts. Novecojis, jo nav pieejami visi atlaižu veidi un informācija. Īpašumsline_item.discountsir aizstāts arline_item.discount_allocations.current_quantitydiscount_allocationsdiscounts. Novecojis, jo nav pieejami visi atlaižu veidi un informācija. Īpašumsline_item.discountsir aizstāts arline_item.discount_allocations.final_line_pricefinal_pricefulfillmentfulfillment_servicegift_cardgramsgroupsidimageindexitem_updatesjson_filterkeyline_level_discount_allocationsline_level_total_discountline_price. Novecojis, jo nav iekļautas atlaides no automātiskajām atlaidēm un atlaižu kodiem. Īpašumsline_item.line_priceir aizstāts arline_item.final_line_price.messageoptions_with_valuesoriginal_line_priceoriginal_priceprice. Novecojis, jo nav iekļautas atlaides no automātiskajām atlaidēm un atlaižu kodiem. Īpašumsline_item.priceir aizstāts arline_item.final_price.productproduct_idpropertiesquantityrefunded_quantityrequires_shippingselling_plan_allocationskusuccessfully_fulfilled_quantitytax_linestaxabletitletotal_discount. Novecojis, jo nav iekļautas atlaides no automātiskajām atlaidēm un atlaižu kodiem. Īpašumsline_item.total_discountir aizstāts arline_item.line_level_total_discount.unit_priceunit_price_measurementurlurl_to_removevariantvariant_idvendor
Izpilde
Pārskati tālāk sniegto Shopify Order Printer pieejamo izpildes atribūtu sarakstu:
created_at. Izmanto filtrudate, lai formatētu laikspiedolu, piemēram, šādi:{{ fulfillment.created_at | date: "%B %e, %Y" }}.estimated_delivery_atfulfillment_line_itemsitem_countline_itemsrequires_shippingtracking_companytracking_numbertracking_numberstracking_urltracking_urlsupdated_at
Adrese
Pārskati tālāk sniegto Shopify Order Printer pieejamo adreses atribūtu sarakstu:
address1address2citycompanycountrycountry_codecountry_uppererrorsfirst_nameidlast_namenamephoneprovinceprovince_codestreetsummarytranslated_country_nametranslated_province_nameurlzip
Klients
Pārskati tālāk sniegto Shopify Order Printer pieejamo klienta atribūtu sarakstu:
accepts_marketingaccount_activation_urladdressesaddresses_countb2b?default_addressemailfirst_namehas_accountidlast_namelast_ordermetafieldsnamenew_addressordersorders_countpayment_methodsphonereset_password_urlsubscribe_urltagstax_exempttotal_spent
DiscountApplication
Pārskati tālāk norādīto DiscountApplication atribūtu sarakstu, kas pieejami Shopify Order Printer:
target_selectiontarget_typetitletotal_allocated_amounttypevalue_typevalue
Atlaižu drukāšana
Atlaides var piemērot visam pasūtījumam vai konkrētiem rindas vienumiem:
- Pasūtījuma līmeņa atlaides: tās tiek piemērotas visam pasūtījumam. Drukājot pasūtījuma rēķinu, šīs atlaides vari parādīt atsevišķi apakšā.
- Rindas vienuma līmeņa atlaides: tās tiek piemērotas atsevišķiem vienumiem. Drukājot atsevišķa vienuma informāciju rindas vienumu sadaļā, vari norādīt šīs atlaides.
Informācijai par atlaidēm vari piekļūt, izmantojot tālāk norādītos mainīgos:
- Piekļūsti visām pasūtījumam vai tā rindas vienumiem piemērotajām atlaidēm, izmantojot vērtību
order.total_discountsun kolekcijuorder.discount_applications. - Piekļūsti rindas vienuma atlaidēm, izmantojot vērtību
line_item.line_level_total_discountvai kolekcijuline_item.line_level_discount_allocations. - Piekļūsti rindas vienuma cenai, kāda tā bija pirms atlaižu piemērošanas, izmantojot vērtību
line_item.original_price. - Piekļūsti rindas vienuma gala cenai pēc visu saistīto rindas vienuma līmeņa atlaižu piemērošanas, izmantojot vērtību
line_item.final_price. - Vērtības
line_item.original_line_priceunline_item.final_line_priceir vienādas ar vērtībāmline_item.original_priceunline_item.final_price, kas reizinātas arline_item.quantity. - Piekļūsti pasūtījuma līmeņa atlaidēm, izmantojot kolekciju
order.cart_level_discount_applications.
Koda bloka piemērs rindas vienuma līmeņa atlaižu drukāšanai:
{% 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 %}Koda bloka piemērs pasūtījuma līmeņa atlaižu drukāšanai:
{% 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 %}- Uzzini vairāk par atlaižu veidiem un darbu ar atlaidēm Liquid.
DiscountAllocation
Pārskati tālāk norādīto DiscountAllocation atribūtu sarakstu, kas pieejami Shopify Order Printer:
amountdiscount_application
Atlaide
Pārskati tālāk norādīto atlaides atribūtu sarakstu, kas pieejami Shopify Order Printer:
amountcodefree_shipping_discountidsavingstitletotal_amounttotal_savings
Produkts
Pārskati tālāk norādīto produkta atribūtu sarakstu, kas pieejami 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
Variants
Pārskati tālāk norādīto varianta atribūtu sarakstu, kas ir pieejami 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
Atmaksājums
Pārskati tālāk norādīto atmaksājuma atribūtu sarakstu, kas ir pieejami Shopify Order Printer:
amountcreated_atidnoterefund_line_itemsrestocktransactions
Piegādes pozīcija
Pārskati tālāk norādīto piegādes pozīcijas atribūtu sarakstu, kas ir pieejami Shopify Order Printer:
handleidoriginal_priceprice. Novecojis, jo cenā netika iekļautas pasūtījuma līmeņa atlaides. Rekvizītsshipping_line.priceir aizstāts arshipping_line.price_with_discounts.price_with_discountstax_linestitle
Nodokļa pozīcija
Pārskati tālāk norādīto nodokļa pozīcijas atribūtu sarakstu, kas ir pieejami Shopify Order Printer:
priceraterate_percentagetitle
Darījums
Pārskati tālāk norādīto darījuma atribūtu sarakstu, kas ir pieejami Shopify Order Printer:
amountbuyer_pending_payment_instructionsbuyer_pending_payment_noticecreated_atgatewaygateway_display_nameidkindnamepayment_detailsreceiptshow_buyer_pending_payment_instructionsstatusstatus_label
Metalauks
Metalauks, kas piesaistīts vecākobjektam. Lai uzzinātu, kā piekļūt konkrēta objekta metalaukam, skati sadaļu Piekļuve metalaukiem.
Metalauki atbalsta vairākus datu tipus, kas nosaka metalaukā glabātās informācijas veidu. Piekļuves ceļš metalaukiem sastāv no diviem līmeņiem:
- nosaukumvieta – metalauku grupējums, lai novērstu konfliktus;
- atslēga – metalauka nosaukums.
Ņemot to vērā, vari piekļūt metalauka objektam, izmantojot šādu sintaksi: {{ resource.metafields.namespace.key }}.
Nosaukumu piešķiršana: <object>.metafields.<namespace>.<key>. Piemēram, order.metafields.shipping.express_delivery_status.
Tipi:
String(virkne)Array(masīvs) – izmanto[ ], lai indeksētu. Piemēram,order.metafield.shipping.express_delivery_status[0]Integer(vesels skaitlis)Boolean(Būla vērtība)Date(datums)
Piezīme. Metaobject (metaobjekta) tips netiek atbalstīts.
Objekti, kas atbalsta metalaukus:
Order(pasūtījums)Customer(klients)Product(produkts)Variant(variants)Location(atrašanās vieta)
Liquid filtri, kas pieejami Shopify Order Printer
Lietojums
Lai lietotu filtrus izvadei, pievieno filtru un visus filtra parametrus izvades figūriekavās {{ }}, pirms kuriem ir vertikālās svītras rakstzīme |. Tālāk norādītajā piemērā product ir objekts, title ir tā rekvizīts, un upcase ir lietotais filtrs:
{{ product.title | upcase }}Ja product.title vērtība ir Health potion, izvade no filtra upcase būs HEALTH POTION.
Lai uzzinātu vairāk par Liquid filtru izmantošanu, skati Shopify Tēmu Liquid atsauces sadaļu Filtri.
Filtri, kas lietojami adreses objektu tipam (Address)
format_address
Lietošanas piemērus skati Shopify Tēmu Liquid dokumentācijā par format_address.
Filtri, kas lietojami jebkuram tekstam/virknei
camelcasecamelizeencode_url_componentformat_codehandlehighlightpad_spacesparagraphizepluralizeurl_escapeurl_param_escape
Lietošanas piemērus skati Shopify tēmu Liquid dokumentācijā par virkņu filtriem.
Filtri, kas piemērojami skaitļiem ar naudas vērtību
moneymoney_with_currencymoney_without_currencymoney_without_trailing_zeros
Naudas summu formatēšanai Shopify Order Printer izmanto e-pasta paziņojumu valūtas formatēšanas opcijas, kas konfigurētas Shopify administrēšanas panelī.
Tu vari mainīt valūtas formatējumu. Lai mainītu naudas filtru formatējumu lietotnē Shopify Order Printer, iestati vērtības Email with currency un Email without currency Shopify administrēšanas panelī.
Lietošanas piemērus skati Shopify tēmu Liquid dokumentācijā par naudas filtriem.
Filtri, kas piemērojami, lai konvertētu objektus uz json
json
Lietošanas piemērus skati Shopify tēmu Liquid dokumentācijā par json filtriem.
Filtri, kas piemērojami skaitļiem, kuri norāda svaru
weightweight_with_unit
Lietošanas piemērus skati Shopify tēmu Liquid dokumentācijā par svaru ar mērvienību.
Filtri, kas piemērojami tagiem
highlight_active_taglink_to_add_taglink_to_remove_taglink_to_tag
Lietošanas piemērus skati Shopify tēmu Liquid dokumentācijā par tagu filtriem.
Filtri, kas piemērojami vietrāžiem 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
Atbalstīto multivides filtru lietošanas piemērus skati Shopify tēmu Liquid dokumentācijā par multivides filtriem.
Filtri, kas piemērojami kolekcijām
link_to_typelink_to_vendorsort_byurl_for_typeurl_for_vendorwithin
Lietošanas piemērus skati Shopify tēmu Liquid dokumentācijā par kolekciju filtriem.