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_items
• tax_lines
• fulfillments
• transactions
• discounts
• refunds
• shipping_methods
• customer

例如，若要存取商品項目變數，可以使用 line_items 或 order.line_items。

備註

您可以使用 {% assign fulfillments_count = order.fulfillments | size %} Liquid 語法在範本當中建立自己的別名，後續的範本文字就能用 {{ fulfillments_count }} 語法參照這些別名。

Shopify Order Printer 提供的 Liquid 變數

備註

您可以在範本中加入以下程式碼： <a href="{{ shop.url }}/admin/orders/{{ order.id }}">View order</a> 這段程式碼會轉譯成最終網址，例如：<a href="https://myshop.myshopify.com/admin/orders/123">View order</a>。

您可以使用以下類別：這裡的屬性以英文字母順序排列。

訂單

備註

如果想深入瞭解以下列出的訂單屬性，歡迎參閱 Shopify 佈景主題訂單 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。系統處理訂單的時間，等同於來自 GraphQL API 的 order.processed_at。使用 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

備註

如果想深入瞭解以下列出的商店屬性，歡迎參閱 Shopify 佈景主題商店 Liquid 文件。

請看以下 Shopify Order Printer 提供的 Shop 屬性：

• 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

備註

如果想深入瞭解以下列出的 LineItem 屬性，歡迎參閱 Shopify 佈景主題商品項目 Liquid 文件。

請看以下 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 佈景主題出貨作業 Liquid 文件。

請看以下 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 佈景主題地址 Liquid 文件。

請看以下 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 佈景主題顧客 Liquid 文件。

請看以下 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 佈景主題 DiscountApplication Liquid 文件。

請查看以下 Shopify Order Printer 提供的 DiscountApplication 屬性清單：

• 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.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

備註

如需下列 DiscountAllocation 屬性的詳細資訊，請參閱 Shopify 佈景主題 DiscountAllocation Liquid 文件。

請查看以下 Shopify Order Printer 提供的 DiscountAllocation 屬性清單：

• amount
• discount_application

折扣

備註

已停用，因為並未擷取所有折扣類型和詳細資訊。

折扣物件已更換為 discount_allocation 和 discount_application 物件。

如需下列 Discount 屬性的詳細資訊，請參閱 Shopify 佈景主題 Discount Liquid 文件。

請看以下 Shopify Order Printer 提供的折扣屬性：

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

產品

備註

如果想深入瞭解以下列出的商品屬性，歡迎參閱 Shopify 佈景主題商品 Liquid 文件。

請看以下 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 佈景主題子類 Liquid 文件。

請看以下 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 佈景主題退款 Liquid 文件。

請看以下 Shopify Order Printer 提供的退款屬性：

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

運送路線

請看以下 Shopify Order Printer 提供的運送路線屬性：

• handle
• id
• original_price
• tax_lines
• title

TaxLine

備註

如果想深入瞭解以下列出的稅項屬性，歡迎參閱 Shopify 佈景主題稅項 Liquid 文件。

請看以下 Shopify Order Printer 提供的稅項屬性：

• price
• rate
• rate_percentage
• title

交易

備註

如果想深入瞭解以下列出的交易屬性，歡迎參閱 Shopify 佈景主題交易 Liquid 文件。

請看以下 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

Shopify Order Printer 提供的 Liquid 篩選條件

使用

如果想對輸出內容套用篩選條件，請在輸出內容的大括號分隔符號 {{ }} 當中加入篩選條件和任何篩選條件參數，並在前方加上直線字元 |。在以下範例中，商品是物件、標題是屬性，而 upcase 是套用的篩選條件：

{{ product.title | upcase }}

如果 product.title 的值是 Health potion，則從 upcase 篩選條件輸出的內容將會是 HEALTH POTION。

請參閱 Shopify 佈景主題 Liquid 參考資料的篩選條件區段，以便詳細瞭解如何使用 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 管理介面中所設定的電子郵件通知幣別格式選項。您可以變更幣別格式。在 Shopify 管理介面設定 Email with currency 和 Email without currency 值，以變更 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 文件的標籤篩選條件。

套用在網址上的篩選條件

• 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 文件的多媒體檔案和 HTML 篩選條件。

套用在商品系列上的篩選條件

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

使用範例請參閱 Shopify 佈景主題 Liquid 文件的商品系列篩選條件。