打印收据代码编辑器
您可以在 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 设计政策范围内帮助您进行微调。
- 某些类型的打印收据无法自定义。
- 代码编辑器不适用于意大利的任何地点。
收据类型的不兼容注意事项
某些类型的打印收据无法在收据代码编辑器中自定义。代码编辑器中没有模板的收据类型不兼容自定义。
您可以自定义以下类型的打印收据:
- 销售收据
- 礼品卡收据
- 礼品收据
无法自定义以下收据:
- 退货收据
- 换货收据
此外,意大利所有地点的所有收据类型都无法自定义。
访问代码编辑器
您可以使用代码编辑器编辑模板。
步骤:
在 Shopify 后台中,转到设置 > 应用和销售渠道。
在应用和销售渠道页面中,点击Point of sale。
点击打开销售渠道。
点击设置 > 收据自定义。
点击自定义收据。
点击
...
> 编辑代码。在编辑代码对话框中,点击编辑代码。
在收据模板中使用自定义文件
您可以使用上传文件自定义收据。如果您有要在收据上打印的自定义图片,您可以将这些图片上传到 Shopify 后台,然后在自定义收据上使用。详细了解文件上传。
步骤:
在 Shopify 后台中,转到设置 > 应用和销售渠道。
在应用和销售渠道页面中,点击Point of sale。
点击打开销售渠道。
点击设置 > 收据自定义。
点击自定义收据。
点击内容页面。
复制要在收据模板中使用的文件旁边的链接。
在模板中添加该链接。
将收据模板重置为默认值
您可以使用代码编辑器将收据模板重置为默认版本。
步骤:
在 Shopify 后台中,转到设置 > 应用和销售渠道。
在应用和销售渠道页面中,点击Point of sale。
点击打开销售渠道。
点击设置 > 收据自定义。
点击要重置的模板。
点击重置图标。
在将文件重置为默认值模态窗口中,点击重置确认。
收据代码编辑器中可用的 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 %}