Rujukan penapis dan pemboleh ubah Liquid untuk Shopify Order Printer
Anda boleh menggunakan Liquid untuk membina templat tersuai anda sendiri menggunakan aplikasi Shopify Order Printer. Dengan Liquid, anda boleh mencipta templat teks dan memaparkannya berdasarkan data unik setiap pesanan.
Rujukan Liquid yang disenaraikan pada halaman ini ialah sambungan bagi versi sumber terbuka Liquid dan bertujuan untuk digunakan pada aplikasi Shopify Order Printer. Untuk memaparkan maklumat berdasarkan atribut order dan shop, anda boleh menggunakan senarai objek, tag dan penapis daripada rujukan ini untuk menyesuaikan templat anda. Anda juga boleh menggunakan dokumen Admin GraphQL API untuk mengetahui butiran tentang medan objek.
Pada halaman ini
Menggunakan pemboleh ubah dan atribut
Dalam templat Shopify Order Printer, objek data teras ialah order dan shop. Anda boleh menggunakan order.variable_name untuk mengakses atribut pesanan.
Atribut pesanan yang biasa digunakan yang berikut boleh diakses tanpa awalan order.:
line_itemstax_linesfulfillmentstransactionsdiscountsrefundsshipping_methodscustomer
Contohnya, jika anda ingin mengakses pemboleh ubah item baris, anda boleh menggunakan line_items atau order.line_items.
Pemboleh ubah Liquid yang tersedia dalam Shopify Order Printer
Kelas berikut tersedia. Atribut disenaraikan mengikut susunan abjad.
Pesanan
Atribut Pesanan berikut tersedia dalam Shopify Order Printer:
attributesb2bbilling_addresscancel_reasoncancel_reason_labelcancelledcancelled_atcart_level_discount_applicationscheckout_idcheckout_payment_collection_urlcompanycompany_locationconfirmation_numbercreated_at. Masa apabila pesanan telah diproses. Ini adalah sama denganorder.processed_atdaripada API GraphQL. Gunakan penapisdateuntuk memformatkan cap masa, contohnya dengan{{ order.created_at | date: "%B %e, %Y" }}.customerdiscounts. Telah ditamatkan kerana bukan semua jenis dan butiran diskaun dirakam. Sifatorder.discountstelah digantikan denganorder.discount_applications.discounts_amount. Telah ditamatkan kerana bukan semua jenis dan butiran diskaun dirakam. Sifatorder.discountstelah digantikan denganorder.total_discounts.discount_applicationsdiscounts_savings. Telah ditamatkan kerana bukan semua jenis dan butiran diskaun dirakam. Sifatorder.discountstelah digantikan dengan-.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
Semak senarai atribut Shop berikut yang tersedia dalam 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
Item Baris
Semak senarai atribut Item Baris berikut yang tersedia dalam Shopify Order Printer:
aggregated_updateapplied_discounts. Ditamatkan penggunaannya kerana tidak semua jenis dan butiran diskaun tersedia. Sifatline_item.discountstelah digantikan denganline_item.discount_allocations.current_quantitydiscount_allocationsdiscounts. Ditamatkan penggunaannya kerana tidak semua jenis dan butiran diskaun tersedia. Sifatline_item.discountstelah digantikan denganline_item.discount_allocations.final_line_pricefinal_pricefulfillmentfulfillment_servicegift_cardgramsgroupsidimageindexitem_updatesjson_filterkeyline_level_discount_allocationsline_level_total_discountline_price. Ditamatkan penggunaannya kerana diskaun daripada diskaun automatik dan kod diskaun tidak disertakan. Sifatline_item.line_pricetelah digantikan denganline_item.final_line_price.messageoptions_with_valuesoriginal_line_priceoriginal_priceprice. Ditamatkan penggunaannya kerana diskaun daripada diskaun automatik dan kod diskaun tidak disertakan. Sifatline_item.pricetelah digantikan denganline_item.final_price.productproduct_idpropertiesquantityrefunded_quantityrequires_shippingselling_plan_allocationskusuccessfully_fulfilled_quantitytax_linestaxabletitletotal_discount. Ditamatkan penggunaannya kerana diskaun daripada diskaun automatik dan kod diskaun tidak disertakan. Sifatline_item.total_discounttelah digantikan denganline_item.line_level_total_discount.unit_priceunit_price_measurementurlurl_to_removevariantvariant_idvendor
Pemenuhan
Semak senarai atribut Pemenuhan berikut yang tersedia dalam Shopify Order Printer:
created_at. Gunakan penapisdateuntuk memformatkan cap masa, sebagai contoh dengan{{ fulfillment.created_at | date: "%B %e, %Y" }}.estimated_delivery_atfulfillment_line_itemsitem_countline_itemsrequires_shippingtracking_companytracking_numbertracking_numberstracking_urltracking_urlsupdated_at
Alamat
Semak senarai atribut Alamat berikut yang tersedia dalam Shopify Order Printer:
address1address2citycompanycountrycountry_codecountry_uppererrorsfirst_nameidlast_namenamephoneprovinceprovince_codestreetsummarytranslated_country_nametranslated_province_nameurlzip
Pelanggan
Semak senarai atribut Pelanggan berikut yang tersedia dalam Shopify Order Printer:
accepts_marketingaccount_activation_urladdressesaddresses_countb2b?default_addressemailfirst_namehas_accountidlast_namelast_ordermetafieldsnamenew_addressordersorders_countpayment_methodsphonereset_password_urlsubscribe_urltagstax_exempttotal_spent
DiscountApplication
Semak senarai atribut DiscountApplication berikut yang tersedia dalam Shopify Order Printer:
target_selectiontarget_typetitletotal_allocated_amounttypevalue_typevalue
Mencetak diskaun
Diskaun boleh dikenakan pada seluruh pesanan atau pada item baris yang khusus:
- Diskaun tahap pesanan: Diskaun ini dikenakan pada seluruh pesanan. Anda boleh memaparkan diskaun ini secara berasingan pada bahagian bawah apabila mencetak invois pesanan anda.
- Diskaun tahap item baris: Diskaun ini dikenakan pada item individu. Anda boleh menyatakan diskaun ini apabila mencetak butiran item individu dalam bahagian item baris.
Anda boleh mengakses maklumat diskaun menggunakan pemboleh ubah yang berikut:
- Akses semua diskaun yang dikenakan pada pesanan atau mana-mana item barisnya dengan nilai
order.total_discountsdan koleksiorder.discount_applications. - Akses diskaun item baris dengan nilai
line_item.line_level_total_discountatau koleksiline_item.line_level_discount_allocations. - Akses harga item baris sebelum sebarang diskaun dikenakan dengan nilai
line_item.original_price. - Akses harga hasil item baris selepas semua diskaun tahap item baris berkaitan dikenakan dengan nilai
line_item.final_price. - Nilai
line_item.original_line_pricedanline_item.final_line_priceadalah sama dengan nilailine_item.original_pricedanline_item.final_priceyang didarab denganline_item.quantity. - Akses diskaun tahap pesanan dengan koleksi
order.cart_level_discount_applications.
Contoh blok kod untuk mencetak diskaun tahap item baris:
{% 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 %}Contoh blok kod untuk mencetak diskaun tahap pesanan:
{% 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 %}- Ketahui lebih lanjut tentang jenis diskaun dan menggunakan diskaun dalam Liquid.
DiscountAllocation
Semak senarai atribut DiscountAllocation berikut yang tersedia dalam Shopify Order Printer:
amountdiscount_application
Diskaun
Semak senarai atribut Diskaun berikut yang tersedia dalam Shopify Order Printer:
amountcodefree_shipping_discountidsavingstitletotal_amounttotal_savings
Produk
Semak senarai atribut Produk berikut yang tersedia dalam 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
Varian
Semak senarai atribut Varian berikut yang tersedia dalam 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
Bayaran balik
Semak senarai atribut Bayaran balik berikut yang tersedia dalam Shopify Order Printer:
amountcreated_atidnoterefund_line_itemsrestocktransactions
Baris pengiriman
Semak senarai atribut Baris pengiriman berikut yang tersedia dalam Shopify Order Printer:
handleidoriginal_priceprice. Ditamatkan kerana harga tidak merangkumi diskaun peringkat pesanan. Sifatshipping_line.pricetelah digantikan denganshipping_line.price_with_discounts.price_with_discountstax_linestitle
Baris cukai
Semak senarai atribut Baris cukai berikut yang tersedia dalam Shopify Order Printer:
priceraterate_percentagetitle
Transaksi
Semak senarai atribut Transaksi berikut yang tersedia dalam Shopify Order Printer:
amountbuyer_pending_payment_instructionsbuyer_pending_payment_noticecreated_atgatewaygateway_display_nameidkindnamepayment_detailsreceiptshow_buyer_pending_payment_instructionsstatusstatus_label
Medan meta
Medan meta yang dilampirkan pada objek induk. Untuk mengetahui tentang cara mengakses medan meta pada objek tertentu, rujuk Akses medan meta.
Medan meta menyokong berbilang jenis data, yang menentukan jenis maklumat yang disimpan dalam medan meta. Untuk mengakses medan meta, laluan akses bagi medan meta terdiri daripada dua lapisan:
- ruang nama - kumpulan medan meta untuk mengelakkan konflik,
- kunci - nama medan meta.
Berdasarkan perkara ini, anda boleh mengakses objek medan meta dengan sintaks berikut: {{ resource.metafields.namespace.key }}.
Penamaan: <object>.metafields.<namespace>.<key>. Contohnya, order.metafields.shipping.express_delivery_status.
Jenis:
RentetanTatasusunan- gunakan[ ]untuk indeks. Contohnya,order.metafield.shipping.express_delivery_status[0]IntegerBooleanTarikh
Nota Jenis Metaobjek tidak disokong.
Objek yang menyokong medan meta:
PesananPelangganProdukVarianLokasi
Penapis Liquid yang tersedia dalam Shopify Order Printer
Penggunaan
Untuk menggunakan penapis pada output, tambahkan penapis dan sebarang parameter penapis dalam pembatas kurungan ikal output {{ }}, didahului dengan aksara paip |. Dalam contoh di bawah, produk ialah objek, tajuk ialah sifatnya dan upcase ialah penapis yang digunakan:
{{ product.title | upcase }}Jika product.title mempunyai nilai Health potion, HEALTH POTION akan menjadi output daripada penapis upcase.
Rujuk bahagian Penapis daripada rujukan Liquid Tema Shopify untuk butiran tentang cara menggunakan penapis Liquid.
Penapis untuk digunakan pada objek Alamat
format_address
Untuk contoh penggunaan, rujuk dokumentasi Liquid Tema Shopify untuk format_address.
Penapis untuk digunakan pada mana-mana teks / rentetan
camelcasecamelizeencode_url_componentformat_codehandlehighlightpad_spacesparagraphizepluralizeurl_escapeurl_param_escape
Untuk contoh penggunaan, rujuk dokumentasi Liquid Tema Shopify untuk penapis rentetan.
Penapis untuk digunakan pada nombor yang mewakili wang
moneymoney_with_currencymoney_without_currencymoney_without_trailing_zeros
Shopify Order Printer menggunakan pilihan pemformatan mata wang pemberitahuan e-mel yang dikonfigurasikan dalam pentadbir Shopify untuk memformat wang.
Anda boleh menukar pemformatan mata wang. Tetapkan nilai E-mel dengan mata wang dan E-mel tanpa mata wang dalam pentadbir Shopify untuk menukar pemformatan penapis wang dalam Shopify Order Printer.
Untuk contoh penggunaan, rujuk dokumentasi Liquid Tema Shopify untuk penapis wang.
Penapis untuk digunakan bagi menukar objek kepada json
json
Untuk contoh penggunaan, rujuk dokumentasi Liquid Tema Shopify untuk penapis json.
Penapis untuk digunakan pada nombor yang mewakili berat
weightweight_with_unit
Untuk contoh penggunaan, rujuk dokumentasi Liquid Tema Shopify untuk berat berserta unit.
Penapis untuk digunakan pada tag
highlight_active_taglink_to_add_taglink_to_remove_taglink_to_tag
Untuk contoh penggunaan, rujuk dokumentasi Liquid Tema Shopify untuk penapis tag.
Penapis untuk digunakan pada 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
Untuk contoh penggunaan bagi penapis media yang disokong, rujuk dokumentasi Liquid Tema Shopify untuk penapis media.
Penapis untuk digunakan pada koleksi
link_to_typelink_to_vendorsort_byurl_for_typeurl_for_vendorwithin
Untuk contoh penggunaan, rujuk dokumentasi Liquid Tema Shopify untuk penapis koleksi.