将模板从 Order Printer 应用迁移到 Shopify Order Printer

如果您的旧版 Order Printer 应用中有任何自定义模板,则需要将模板迁移到 Shopify Order Printer 应用。

若要迁移模板,您需要从旧版应用中复制模板的代码,然后将代码粘贴到新应用中。但是,新的 Shopify Order Printer 应用与旧版 Order Printer 应用的实现略有不同。这意味着某些现有模板最初可能无法工作,您可能需要对模板的代码执行一些调整。

若要使模板能够适用于新应用,您需要将旧版变量替换为新变量。例如,如果您使用 date 变量,则需要将其替换为 created_at 变量。

在此页面上,您可以找到在 Shopify Order Printer 应用中需要替换为新变量的变量列表。

迁移现有模板的注意事项

将现有模板迁移到 Shopify Order Printer 应用前,请查看以下注意事项:

将现有模板迁移到 Shopify Order Printer 应用

若要将现有模板迁移到 Shopify Order Printer 应用,您需要完成以下步骤:

  1. 访问旧版 Order Printer 应用,确定要迁移的模板。
  2. 从旧版 Order Printer 应用中复制现有模板的代码。
  3. 在 Shopify Order Printer 应用中创建新模板,然后粘贴旧版应用中的模板代码。
  4. 查看您的模板是否使用了任何旧版变量,然后用新的变量替换它们
  5. 预览模板并确保模板正确显示。
  6. 打印测试文档。

对要迁移到 Shopify Order Printer 应用的每个模板重复这些步骤。

在 Shopify Order Printer 应用中使用订单变量

订单变量在 Shopify Order Printer 应用中的使用方式有所不同。若要访问订单变量,您需要添加 order. 前缀。例如,若要访问 billing_address 变量,您需要使用 order.billing_address

无需添加 order. 前缀即可访问以下常用订单变量:

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

例如,如果要访问订单项目变量,则可以使用 line_itemsorder.line_items

您还可以为模板创建您自己的别名。例如,您可以使用 {% assign fulfillments_count = order.fulfillments | size %} Liquid 语法,然后通过在代码中使用 {{ fulfillments_count }} 来引用它。

变量映射

Shopify Order Printer 应用与旧版 Order Printer 应用使用不同的变量。如果您的现有模板使用此部分列出的任何变量,则您需要将旧变量替换为新变量。

例如,如果您使用 date 变量,则需要将其替换为 created_at 变量。

订单变量

订单变量
旧版 Order Printer 应用中的变量 新版 Shopify Order Printer 应用中的变量
line_items 已退款订单项目不包含在 line_items 变量中。请使用 refunds.<each>.refunded_line_items 变量访问已退款订单项目。
credit_card 通过 transactions.<each>.payment_details 变量,使用基于订单每笔交易的付款详细信息。
current_shipping_price shipping_price
date 使用 created_at 变量。使用 date 筛选条件设置时间戳的格式:{{ order.created_at | date: "%B %e, %Y" }}
网关 unique_gatewaystransactions.<each>.gateway
order_currency 货币
processed_at 使用 created_at 变量。使用 date 筛选条件设置时间戳的格式:{{ order.created_at | date: "%B %e, %Y" }}
payment_transactions 针对种类和状态筛选 order.transactions - 使用内含 where 或内含循环和 if 的 Liquid 语法。
refund_transactions 针对种类和状态筛选 order.transactions - 使用内含 where 或内含循环和 if 的 Liquid 语法。
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
姓名 title
product_title product.title
unit_discount quantity ? total_discount / quantity : 0
variant_title variant.title
weight grams

发货变量

发货变量
旧版 Order Printer 应用中的变量 新版 Shopify Order Printer 应用中的变量
date 创建时间

商店变量

商店变量
旧版 Order Printer 应用中的变量 新版 Shopify Order Printer 应用中的变量
所有者 account_owner.name
address 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 变量,则 latitude 和 longitude 可用作 location 对象本身的变量。
longitude 如果通过 location 属性引用 address 变量,则 latitude 和 longitude 可用作 location 对象本身的变量。

退款变量

退款变量
旧版 Order Printer 应用中的变量 新版 Shopify Order Printer 应用中的变量
date 使用 created_at 变量。使用 date 筛选条件设置时间戳的格式:{{ order.created_at | date: "%B %e, %Y" }}

ShippingLine 变量

ShippingLine 变量
旧版 Order Printer 应用中的变量 新版 Shopify Order Printer 应用中的变量
current_price price
price original_price

交易变量

以下交易变量已被删除,无法在 Shopify Order Printer 应用中替换:

  • authorization
  • message
  • test

多属性变量

多属性变量
旧版 Order Printer 应用中的变量 新版 Shopify Order Printer 应用中的变量
grams weight

元字段变量

若要访问元字段,您需要指定元字段的命名空间,并且无需将 .value 添加到变量中。详细了解元字段定义

例如,请改用 product.metafields.custom.manufacturerid 变量,而不是 product.metafields.manufacturerid.value 变量。

若要识别每个元字段的命名空间值,请参阅 Shopify 后台中的自定义数据页面。元字段定义按其引用的对象(例如产品、多属性或订单)进行分组。

筛选条件变量

筛选条件映射
旧版 Order Printer 应用中的变量 新版 Shopify Order Printer 应用中的变量
files_url file_url
payment_methodpayment_methods 在订单交易上使用 transaction.gateway_display_name 字段。付款方式不再分类为特定类型,例如 {credit card, debit card, bank transfer}。旧版 Order Printer 仅将当前有效支付网关的一小部分映射到这些类别。支付网关提供商会管理客户使用的付款方式类型。

准备好开始使用 Shopify 进行销售了吗?

免费试用