打印收据代码编辑器

您可以在 Shopify 后台使用代码编辑器自定义打印收据。使用代码编辑器,您可以使用 HTML、CSS 和 Liquid 创建比可视化编辑器更高级的自定义。

您可以更改收据模板和打印收据上使用的分区模板。收据模板文件是您可以在商店中打印的收据类型。分区是收据的各个部分,例如标头或页脚。多个收据可以重复使用分区。

使用收据代码编辑器的注意事项

使用收据代码编辑器之前,请查看以下注意事项:

  • 您只能在台式电脑上的 Shopify 后台中使用代码编辑器。
  • 您进行的代码更改应用于所有 POS Pro 地点。但是,您可以添加条件,显示特定地点的自定义。详细了解如何在 Liquid 中使用控制流标签
  • 切换到代码编辑器后,无法在 Shopify POS 应用中对收据模板进行任何自定义。您仍然可以在 Shopify POS 应用中,为拥有 POS Pro 订阅套餐的地点调整打印选项
  • 代码编辑器中的自定义仅适用于 POS Pro 地点。如果您使用代码编辑器,并且有 POS Lite 地点,您可以使用可视化编辑器,为您的 Lite 地点自定义标头和页脚。
  • 收据中的文件包含 Liquid,这是 Shopify 的模板语言。详细了解如何使用 Liquid
  • 若要在收据代码编辑器中编辑模板,您需要熟悉 HTML、CSS 和 Liquid。Shopify 模板支持团队可以在 Shopify 设计政策范围内帮助您进行微调。
  • 某些类型的打印收据无法自定义
  • 代码编辑器不适用于意大利的任何地点。

收据类型的不兼容注意事项

某些类型的打印收据无法在收据代码编辑器中自定义。代码编辑器中没有模板的收据类型不兼容自定义。

您可以自定义以下类型的打印收据:

  • 销售收据
  • 礼品卡收据
  • 礼品收据

无法自定义以下收据:

  • 退货收据
  • 换货收据

此外,意大利所有地点的所有收据类型都无法自定义。

访问代码编辑器

您可以使用代码编辑器编辑模板。

步骤:

  1. 在 Shopify 后台中,转到设置 > 应用和销售渠道

  2. 应用和销售渠道页面中,点击Point of sale

  3. 点击打开销售渠道

  4. 点击设置 > 收据自定义

  5. 点击自定义收据

  6. 点击 ... > 编辑代码

  7. 编辑代码对话框中,点击编辑代码

在收据模板中使用自定义文件

您可以使用上传文件自定义收据。如果您有要在收据上打印的自定义图片,您可以将这些图片上传到 Shopify 后台,然后在自定义收据上使用。详细了解文件上传

步骤:

  1. 在 Shopify 后台中,转到设置 > 应用和销售渠道

  2. 应用和销售渠道页面中,点击Point of sale

  3. 点击打开销售渠道

  4. 点击设置 > 收据自定义

  5. 点击自定义收据

  6. 点击内容页面

  7. 复制要在收据模板中使用的文件旁边的链接。

  8. 在模板中添加该链接。

将收据模板重置为默认值

您可以使用代码编辑器将收据模板重置为默认版本。

步骤:

  1. 在 Shopify 后台中,转到设置 > 应用和销售渠道

  2. 应用和销售渠道页面中,点击Point of sale

  3. 点击打开销售渠道

  4. 点击设置 > 收据自定义

  5. 点击要重置的模板。

  6. 点击重置图标。

  7. 将文件重置为默认值模态窗口中,点击重置确认。

收据代码编辑器中可用的 Liquid 变量

您可以使用 Liquid 自定义打印收据模板和收据类型。

在收据代码编辑器可使用以下数据对象:

收据数据对象的描述
对象描述
shop
包含商店信息,例如商店名称。
location
包含零售地点信息,例如地址和电话号码。
order
包含订单数据,包括订单项目、折扣、税费和交易信息。
gift_card
只能在模板 gift_card.liquid 中使用。包含礼品卡数据,包括余额、字母数字代码以及 POS 应用可扫描的二维码的内容。

收据代码编辑器中可用的 Liquid 筛选条件

您可以使用 Liquid 筛选条件调整收据模板中的信息。例如,您可以更改货币格式或特定文本(例如税务代码)的大小写。

若要应用筛选条件,在双花括号之间的 Liquid 代码块中添加管道字符 |,然后添加筛选条件 {{ }}。筛选条件只能应用于 Liquid 代码块。

在以下示例中,筛选条件将税务代码从小写调整为大写。

{{ tax_line.title | upcase }}

在示例代码块中,product 是对象,title 是它的属性,upcase 是应用的筛选条件。upcase 筛选条件将 tax_line.title 的大小写值改为大写。例如,如果 tax_line.title 的值为 Hst,则 upcase 筛选条件将值更改为 HST

请参阅 Shopify Themes Liquid 参考中的筛选条件部分,了解有关如何使用 Liquid 筛选条件的详细信息。

在收据代码编辑器中可使用以下筛选条件:

收据筛选条件的描述
属性描述
t
将预定义标签翻译成分配给您所在地点的语言。
money
您所在地点的货币设置价格格式。
escape
转义 HTML 特殊字符,例如 <>'&,并将字符转换为转义序列。
barcode
生成 1D 条码 SVG
qrcode
生成 2D 条码 SVG

打印收据模板代码自定义示例

您可以使用 Liquid 添加条件消息。此功能与使用可视化编辑器保存到单个地点类似。例如,您的业务最初只有一个地点,但您现在有多个新地点。您希望在打印收据上突出显示您的创始商店。

您可以在代码编辑器的分区文件夹中,向 header.liquid 模板添加自定义消息,使用 Liquid 只为您的旗舰地点显示该消息。

以下代码检查地点名称。在本例中,您的创始地点叫“Home”,如果地点与名称匹配,则显示消息“欢迎访问我们的创始商店(1972 年创立)”。相反,从其他地点打印的收据会显示消息“欢迎访问我们的商店”。

{% if location.name == 'Home' %}
  Welcome to our original store, opened in 1972.
{% else %}
  Welcome to our store.
{% end %}
没有找到您需要的答案?我们将为您提供帮助。