將範本從 Order Printer 應用程式移轉到 Shopify Order Printer

如果您在舊版 Order Printer 應用程式中仍有自訂範本，則需將這些範本移轉到 Shopify Order Printer 應用程式。

若要移轉範本，您可以將現有範本匯入 Shopify Order Printer 應用程式。不過，新版 Shopify Order Printer 應用程式與舊版 Order Printer 應用程式的實作方式略有不同。這可能導致某些現有範本一開始無法運作；在此情況下，您需要調整範本的部分程式碼。

為了讓範本能夠在新版應用程式中運作，請將舊版變數更換為新版變數。舉例來說，如果您使用 date 變數，則需將它更換為 created_at 變數。

本頁面提供一份變數清單，您可能需要在 Shopify Order Printer 應用程式中將這些變數更換為新版變數。

移轉現有範本的考量事項

將現有範本移轉到 Shopify Order Printer 應用程式之前，請檢視下列考量事項：

• 若要移轉現有範本，您必須熟悉 HTML、CSS 和 Liquid。Shopify 佈景主題支援服務可在 Shopify 設計政策所述範圍內，協助您稍微調整範本內容。
• 請詳閱 Shopify Order Printer 的 Liquid 變數和篩選條件參考資料，以瞭解所有支援的範本自訂項目。
• 如果現有範本使用自訂 CSS，您就需要手動移轉，並在新版應用程式中調整程式碼。
• 若要在 Shopify Order Printer 應用程式中存取訂單變數，則需加上訂單前綴。
• 匯入現有範本時，不會一併匯入中繼欄位。您可能需要手動移轉包含中繼欄位的範本。

將現有範本移轉到 Shopify Order Printer 應用程式

如果您有舊版 Order Printer 應用程式的範本，可以將這些範本匯入 Shopify Order Printer 應用程式。您無法匯入特定範本，只能同時匯入所有範本。

步驟如下：

1. 在 Shopify 管理介面中，點擊「設定」>「應用程式和銷售管道」。
2. 按一下「Order Printer」。

3. 點擊「開啟應用程式」。

4. 點擊「範本」。

5. 按一下「匯入」。

6. 在對話方塊中，按一下「匯入」。

7. 查看範本是否包含舊版變數，然後將您找到的舊版變數更換為新版變數。

8. 預覽範本並確保範本正確顯示。

9. 選用：列印測試文件。

在 Shopify Order Printer 應用程式中使用訂單變數

在 Shopify Order Printer 應用程式中，使用訂單變數的方式有所不同，即存取訂單變數時，需要加上 order. 前綴。例如，若要存取 billing_address 變數，您必須使用 order.billing_address。

下列常用訂單變數無需 order. 前綴即可存取：

• line_items
• tax_lines
• fulfillments
• transactions
• refunds
• shipping_methods
• customer

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

您也可以為範本建立專屬別名，例如使用 Liquid 語法「{% assign fulfillments_count = order.fulfillments | size %}」，然後在程式碼中使用 {{ fulfillments_count }} 來參照該語法。

變數對應

Shopify Order Printer 應用程式與舊版 Order Printer 應用程式使用不同的變數。如果您的現有範本使用本節列出的任何變數，請將舊版變數更換為新版變數。

舉例來說，如果您使用 date 變數，則需更換為 created_at 變數。

訂單變數

訂單變數

舊版 Order Printer 應用程式中的變數	新版 Shopify Order Printer 應用程式中的變數
line_items	已退款的商品項目不會包含在 line_items 變數中。請檢視以下詳細資訊： 若要存取已退款的商品項目，可以使用 refunds.<each>.refund_line_items 變數。請檢視下列範例。 {% assign refunded_line_items = refunds | map: "refund_line_items" | map: "line_item" %} 如果需要，您可以將已退款的商品項目加入 line_items 集合。請檢視下列範例。 {% assign refunded_line_items = order.refunds | map: "refund_line_items" | map: "line_item" %} {% assign line_items_with_refunded = order.line_items | concat: refunded_line_items | uniq %} 請務必包含 | uniq 篩選條件，以避免已退款的商品項目重複。 小費商品項目不會包含在變數 line_items 中。請檢視以下詳細資訊： 您可以使用 tip_line_items 變數存取小費商品項目。 如果需要，不妨將 tip_line_items 加入 line_items 集合。請檢視下列範例。 {% assign line_items_with_tips = order.line_items | concat: order.tip_line_items %} 若要模擬舊版 Order Printer line_items 集合，可以使用下列範例程式碼。 {% assign refunded_line_items = refunds | map: "refund_line_items" | map: "line_item" %} {% assign all_line_items = order.line_items | concat: refunded_line_items | concat: order.tip_line_items | uniq %} {% for line_item in all_line_items %} ... {% endfor %}
credit_card	根據含有 transactions.<each>.payment_details 變數的每筆訂單交易來使用付款詳細資訊。
current_shipping_price	shipping_price
date	使用 created_at 變數。藉由 date 篩選條件設定時間戳記的格式，例如使用 。
閘道	unique_gateways 或 transactions.<each>.gateway
order_currency	貨幣
processed_at	使用 created_at 變數。此變數會存放 order.processed_at (來自 GraphQL API) 的值，且表示系統處理訂單的實際時間，而不是訂單匯入 Shopify 的時間。它與 order.processed_at (來自舊版 Order Printer 應用程式) 相同。您可以使用 date 篩選條件設定時間戳記的格式，例如使用 。
payment_transactions	對 order.transactions 進行篩選；在 Liquid 語法中使用 where 或是使用迴圈搭配 if 來篩選 kind 狀態。請檢視下列範例。 {% assign sale_transactions = order.transactions | where: "kind", "sale" %} {% assign capture_transactions = order.transactions | where: "kind", "capture" %} {% for transaction in transactions %} {% if transaction.kind == "sale" or transaction.kind == "capture" %} 交易 ID：{{ transaction.id }} 種類：{{ transaction.kind }} 金額：{{ transaction.amount | money }} {% endif %} {% endfor %} {% assign sale_transactions = order.transactions | where: "kind", "sale" %} {% assign capture_transactions = order.transactions | where: "kind", "capture" %} {% assign payment_transactions = sale_transactions | concat: capture_transactions %}
refund_transactions	對 order.transactions 進行篩選；在 Liquid 語法中使用 where 或是使用迴圈搭配 if 來篩選 kind 狀態，如下列範例所示。 {% assign refund_transactions = order.transactions | where: "kind", "refund" %}
shipping_line	shipping_methods | first
shipping_lines	shipping_methods
show_line_item_taxes	tax_lines.size > 0。您可以在範本開頭將此定義為變數並重複參照使用，如以下範例所示。 {% if tax_lines.size > 0 %} {% assign show_line_item_taxes = true %} {% else %} {% assign show_line_item_taxes = false %} {% endif %}
total_tax	tax_price
total_paid	net_payment

LineItem 變數

LineItem 項目變數

舊版 Order Printer 應用程式中的變數	新版 Shopify Order Printer 應用程式中的變數
fulfillable_quantity	quantity - successfully_fulfilled_quantity
已出貨	quantity == successfully_fulfilled_quantity
名稱	標題
product_title	product.title
unit_discount	quantity ? line_level_total_discount / quantity : 0
variant_title	variant.title
重量	grams

訂單出貨變數

訂單出貨變數

舊版 Order Printer 應用程式中的變數	新版 Shopify Order Printer 應用程式中的變數
date	created_at

商店變數

Shop 變數

舊版 Order Printer 應用程式中的變數	新版 Shopify Order Printer 應用程式中的變數
擁有者	account_owner.name
地址	shop.address.address1
address2	shop.address.address2
city	shop.address.city
國家/地區	shop.address.country
country_code	shop.address.country_code
province	shop.address.province
province_code	shop.address.province_code
郵遞區號	shop.address.zip

地址變數

地址變數

舊版 Order Printer 應用程式中的變數	新版 Shopify Order Printer 應用程式中的變數
latitude	如果 location 屬性參照了 address 變數，則 location 物件本身就有經緯度。
longitude	如果 location 屬性參照了 address 變數，則 location 物件本身就有經緯度。

退款變數

退款變數

舊版 Order Printer 應用程式中的變數	新版 Shopify Order Printer 應用程式中的變數
date	使用 created_at 變數。藉由 date 篩選條件設定時間戳記的格式，例如使用 。

ShippingLine 變數

運送路線變數

舊版 Order Printer 應用程式中的變數	新版 Shopify Order Printer 應用程式中的變數
current_price	價格
價格	original_price

交易變數

以下交易變數已經移除，因此無法在 Shopify Order Printer 應用程式中更換：

• authorization
• message
• test

子類變數

子類變數

舊版 Order Printer 應用程式中的變數	新版 Shopify Order Printer 應用程式中的變數
grams	重量

中繼欄位變數

若要存取中繼欄位，需指定中繼欄位的命名空間，而無需將 .value 新增至變數。深入瞭解中繼欄位定義。

例如，使用 product.metafields.custom.manufacturerid 變數，而非 product.metafields.manufacturerid.value 變數。

若要識別每個中繼欄位的命名空間值，請參閱 Shopify 管理介面中的自訂資料頁面。中繼欄位定義會依所參照的物件 (如商品、子類或訂單) 進行分組。

篩選條件對應

篩選條件對應

舊版 Order Printer 應用程式中的篩選條件名稱	新版 Shopify Order Printer 應用程式中的篩選條件名稱
files_url	file_url
payment_method 和 payment_methods	使用訂單交易的 transaction.gateway_display_name 欄位。付款方式已不再分類為特定類型，例如信用卡、簽帳卡和銀行轉帳。舊版 Order Printer 應用程式只能將目前使用的一小部分付款閘道對應到這些類別。付款閘道供應商會自行管理顧客使用的付款方式類型。