Shopify Order Printer 的 Liquid 變數和篩選條件參考資料。
您可以使用 Shopify Order Printer 應用程式和 Liquid 自行建立自訂範本。Liquid 可以按照每筆訂單的不同資料建立和轉譯文字範本。
此頁面上列出的 Liquid 參考資料是 Liquid 開放原始碼版本的延伸，主要用於 Shopify Order Printer 應用程式。若要根據 order 和 shop 屬性轉譯資訊，您可以使用此參考資料中的物件、標籤和篩選條件清單來自訂範本。您也可以參閱 GraphQL Admin 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。系統處理訂單的時間，等同於來自 GraphQL API 的order.processed_at。使用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
請看以下 Shopify Order Printer 提供的 Shop 屬性：
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
請查看以下 Shopify Order Printer 提供的 DiscountApplication 屬性清單：
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.original_price和line_item.final_price乘以line_item.quantity的結果。使用
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
請查看以下 Shopify Order Printer 提供的 DiscountAllocation 屬性清單：
amountdiscount_application
折扣
請看以下 Shopify Order Printer 提供的折扣屬性：
amountcodefree_shipping_discountidsavingstitletotal_amounttotal_savings
產品
請看以下 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
TaxLine
請看以下 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
Shopify Order Printer 提供的 Liquid 篩選條件
使用
如果想對輸出內容套用篩選條件，請在輸出內容的大括號分隔符號 {{ }} 當中加入篩選條件和任何篩選條件參數，並在前方加上直線字元 |。在以下範例中，商品是物件、標題是屬性，而 upcase 是套用的篩選條件：
{{ product.title | upcase }}如果 product.title 的值是 Health potion，則從 upcase 篩選條件輸出的內容將會是 HEALTH POTION。
請參閱 Shopify 佈景主題 Liquid 參考資料的篩選條件區段，以便詳細瞭解如何使用 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 管理介面中所設定的電子郵件通知幣別格式選項。您可以變更幣別格式。在 Shopify 管理介面設定 Email with currency 和 Email without currency 值，以變更 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 文件的標籤篩選條件。
套用在網址上的篩選條件
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 文件的多媒體檔案和 HTML 篩選條件。
套用在商品系列上的篩選條件
link_to_typelink_to_vendorsort_byurl_for_typeurl_for_vendorwithin
使用範例請參閱 Shopify 佈景主題 Liquid 文件的商品系列篩選條件。