自定义您的收据

如果您想更改收据的外观，有三种方式可供选择。挑选能满足需求的最简单的一种即可——大多数店铺从不需要用到第一种之外的方式。

三种自定义方式

1. 选择不同的模板

使用模板库中现成的模板之一。完全无需编写代码。 适用于：更换布局、隐藏价格、A4 发票、厨房小票。

2. 让 AI 帮您调整

将模板粘贴到 ChatGPT 或 Claude 中，描述您想要的效果。无需编程技能——用平实的语言描述即可。适用于：措辞、颜色等小幅调整，或调整元素位置。

3. 手动编辑

应用内编辑器允许您直接更改模板。适用于：需要精确控制，或者您已经懂 HTML。

这三种方式都从同一个地方开始：WP Admin → POS → Templates。该页面分为两部分——顶部是您的模板（您当前正在使用的模板），下方是模板库（入门模板库）。

方式一 —— 选择不同的模板

这是最简单的方式，能满足大多数需求。

1

打开模板库

在 WP Admin 中前往 POS → Templates。向下滚动越过您的模板，找到模板库部分——这就是入门模板库。

2

浏览并预览

按类别（收据、发票、礼品收据、厨房小票、报价单 / 采购订单）、格式（用于浏览器打印的 HTML，用于热敏打印机的 ESC/POS）或方向（从左到右或从右到左）进行筛选。点击任意卡片的缩略图——或其底部的预览链接——即可打开使用您店铺真实数据的实时预览。

3

使用它

点击卡片上的使用模板。WCPOS 会为您创建一个可编辑的副本，并将其添加到页面顶部的您的模板中。打开该行的激活开关即可开始在收据上使用它；拖动该行的抓取手柄可重新排序。您可以同时激活多个模板——收银员在收银台进行选择。

使用模板绝不会替换任何内容

点击使用模板始终会创建一个全新的副本。原始的库模板保持不变，因此您随时可以回来选择一个不同的起点。如果有多个收据模板处于激活状态，收据界面会显示一个下拉菜单，方便收银员随时在它们之间切换。

内置模板

模板	格式	用途
标准收据	HTML	默认——Logo、商品、合计、付款。适用于大多数店铺
标准收据（RTL）	HTML	与标准收据相同，针对阿拉伯语 / 希伯来语 / 波斯语 / 乌尔都语进行了镜像处理
极简 / 现代	HTML	信息与标准收据相同，但占用更少的竖向空间
详细收据	HTML	完整税务发票——SKU 列、单价、按税率细分的税额、地址
礼品收据	HTML	仅显示商品——隐藏价格。包含礼品留言和退换政策
发票	HTML	整页 A4/Letter 发票。为未付款订单添加"如何付款"面板
装箱单	HTML	仓库配套单据——商品 + 数量、收货地址，不含价格
报价单 / 估价单	HTML	含定价和条款的售前单据——无付款部分
窄版收据	HTML	等宽字体收据，适用于窄纸或支持 HTML 的热敏打印机
简易热敏收据（58mm）	热敏	简洁的 58mm 热敏布局
简易热敏收据（80mm）	热敏	简洁的 80mm 热敏布局——最常用
简易热敏收据 80mm（RTL）	热敏	80mm 的 RTL 版本。需要支持阿拉伯语代码页的打印机
详细热敏收据（58mm / 80mm）	热敏	增加税额细分、地址、退款、付款、条款、条形码
厨房小票	热敏	仅显示商品，大号字体，不含价格——用于备餐站

大多数内置模板会自动适配您店铺的税务设置——含税店铺会看到含税价格和一行"含税"说明；不含税店铺会看到不含税价格，并将税额作为单独一行加上。无论设置如何，详细系列模板始终显示完整的税额细分。

按店铺分配

如果您拥有多个店铺（Pro），每个店铺都可以拥有自己的模板选择和排序，独立于站点级默认设置。街边的咖啡馆可以使用带有不同 Logo 和地址的小型热敏收据；仓库可以使用装箱单；主店铺可以保留标准收据——全部来自同一个模板库。

请在 WP Admin → POS → Stores 中进行设置，然后打开您想要配置的店铺。编辑店铺页面有一个收据模板部分，其中带有*"店铺专属收据模板"*开关：

• 关闭开关 (默认) —— 该店铺继承来自主 POS → Templates 页面的站点级模板列表。
• 打开开关 —— 该店铺获得自己的模板选择和排序，独立于站点级默认设置。拖拽手柄重新排序的方式相同。

同一个编辑店铺页面也是每个店铺信头（Logo、地址、联系方式，以及收据信息区块——结束语、退换政策、页脚）所在的位置。内置模板从这些按店铺设置的字段中提取信息，因此同一个"标准收据"模板可以在不同地点呈现不同的品牌信息。

当收银员在某个店铺登录时，收据下拉菜单中只会显示该店铺的激活模板。

站点级 vs 按店铺

WP Admin 中的模板页面为整个站点设置默认值。按店铺覆盖的存在，是为了让单个模板（例如标准收据）能够在不同地点呈现不同的品牌信息，或者让某个地点使用其他地点没有的布局。如果您所有的店铺都想使用相同的模板，只需将按店铺分配留空，站点级默认设置便会生效。

方式二 —— 让 AI 帮您调整

如果模板库中的模板接近但不完全符合需求，AI 助手可以在几分钟内为您修改——而且您无需懂 HTML。

1

复制模板

在 WP Admin → POS → Templates 中打开您想要作为起点的模板，点击进入编辑器，然后选中左侧的所有文本（Ctrl/Cmd + A）。复制它。

2

粘贴到 ChatGPT 或 Claude 中

打开 ChatGPT 或 Claude。粘贴模板，然后用平实的语言写下您想要的效果：

3

描述要更改的内容

确切地告诉 AI 您想要什么。以下是效果良好的示例：

• "把店铺名称放大并居中。"
• "在底部添加一条斜体的感谢留言。"
• "隐藏客户姓名。改为在订单号下方添加电话号码。"
• "把条形码改成链接到我的退换页面的二维码。"
• "在店铺名称下方添加一句标语'家族经营，始于 1987 年'。"

AI 会把修改后的模板返回给您。

4

粘贴回去

复制 AI 的回复。回到 WCPOS 模板编辑器中，全选（Ctrl/Cmd + A），粘贴新版本，然后点击更新。右侧的预览会刷新，让您看到效果。如果看起来不对，请让 AI 修复——描述哪里出了问题。

最佳实践

在模板库中每次点击使用模板都会创建一个全新的可编辑副本，因此原始模板始终安全无虞。如果您正在尝试不同方案，可以多次使用同一个库模板——重命名您的副本*（收据 v1、收据 v2）*，并在决定之前在它们之间切换。

关于变量呢？

像 {{store.name}} 和 {{order.number}} 这样的部分是您真实数据的占位符。AI 能够理解这些——您无需理解。如果您想了解所有可用的占位符，请参阅收据数据参考。

方式三 —— 手动编辑

如果您懂一点 HTML（或者您正与开发者协作），可以直接在应用内编辑器中编辑模板。该编辑器具备实时预览、语法高亮、可搜索的字段选择器、撤销/重做以及查找替换功能。

选择您的引擎：

• HTML 模板 —— Mustache 风格的 {{variable}} 占位符。在客户端渲染，可离线工作。推荐大多数店铺使用。
• 热敏模板 —— 用于 ESC/POS 热敏打印机的 XML。同一个模板既生成屏幕预览，也生成打印机输出。
• 收据数据参考 —— 您可以使用的所有占位符，按部分分组。

旧版 PHP 模板

如果您以前曾使用主题中的 PHP 文件（yourtheme/woocommerce-pos/receipt.php）来覆盖收据，那种方式仍然有效。它现在在模板库中被标注为旧版 PHP 模板，与新的无逻辑引擎和热敏引擎并列。新的自定义应改用模板库或应用内编辑器——它们可离线工作、实时预览，且无需服务器往返。

常见自定义

以下是我们最常被问到的问题的快速解答。

如何添加我的店铺 Logo？

Logo 来自您的店铺设置，而非模板本身。前往 WP Admin → POS → Settings → Stores，编辑您的店铺，并在那里上传 Logo。每个显示 Logo 的内置模板都会自动使用它。

如果您想更改 Logo 在模板中出现的位置，请编辑模板，将 {{#store.logo}}<img src="{{store.logo}}" ...>{{/store.logo}} 区块移动到您想要的位置。

如何更改页脚文字（例如“感谢您的惠顾！”）？

两种方式：

1. 最简单 —— 在 WP Admin → POS → Settings → Stores → Store details → Receipt footer / personal note 中为每张收据一次性设置。内置模板会自动采用；如果未设置页脚，它们会回退到一个友好的默认值，例如*“感谢您的惠顾！”*。
2. 在单个模板中 —— 编辑模板并直接替换页脚文字。查找 {{store.personal_notes}} 或字面的感谢语句。

如何在店铺名称下方添加标语或口号？

编辑模板，并在 {{store.name}} 下方添加一行：

<div style="font-style: italic; color: #6b7280;">Family-owned since 1987</div>

在热敏模板中：

<align mode="center"><text>Family-owned since 1987</text></align>

如何隐藏价格（用于礼品收据）？

点击模板库中礼品收据卡片上的使用模板——它会隐藏所有价格和合计，同时仍显示商品、SKU、属性和礼品留言。无需编辑。

如果您更愿意自行构建无价格的收据，请复制任意模板，并删除 {{...total...}}、{{...price...}} 和 {{#totals}}...{{/totals}} 区块。

如何将条形码改成二维码？

在您的模板中找到 <barcode> 元素，并更改 type 属性：

<!-- Default: Code 128 barcode of the order number -->
<barcode type="code128">{{order.number}}</barcode>

<!-- Switch to a QR code -->
<barcode type="qrcode">{{order.number}}</barcode>

<!-- Or encode something else, like a returns URL -->
<barcode type="qrcode">https://example.com/returns?order={{order.number}}</barcode>

同样的 <barcode> 语法在 HTML 模板和热敏模板中都适用。其他受支持的类型包括 ean13、ean8、upca、pdf417，以及 bwip-js 支持的所有类型。

如何将不同的模板发送到特定的打印机？

在 POS 应用中，前往 Settings → Print Routing。您会看到每个激活的模板旁边都有一个打印机下拉菜单。选择您想要的打印机，或保持为自动。

• 自动会自动将模板与打印机匹配——热敏模板发送到热敏打印机，HTML 模板发送到系统打印对话框。
• 特定打印机会覆盖自动设置，并始终将该模板发送到那里。
• 在打印时，收银员可以通过收据界面上的打印机下拉菜单覆盖上述任一设置。

路由按设备存储，因此每台 iPad 或电脑都可以拥有自己的设置。

编辑后我的收据仍然显示旧版本

点击模板编辑界面上的 WordPress 更新按钮。编辑器不会自动保存——您的更改只有在点击更新后才会保留。

对于旧版 PHP 模板，编辑器中的预览显示的是上次保存的版本，而非您正在输入的内容。请先保存，然后刷新预览。

预览空白或显示“未找到 POS 订单”

这只会在旧版 PHP 模板中发生，它们需要一个真实的订单来进行预览。处理一笔 POS 订单——哪怕是一笔 $0 的测试销售——预览就会开始正常工作。

无逻辑（HTML）模板和热敏模板始终有可回退的示例数据，因此即使在全新的店铺上也能正常预览。

我搞砸了——如何重新开始？

三重保险：

1. 编辑器具备撤销功能（Ctrl/Cmd + Z），用于会话内的更改。
2. 每次保存都会创建一个 WordPress 修订版本——在编辑界面上打开修订版本即可比较并还原任何先前版本。
3. 如果您是从库模板开始的，请点击您的模板中您副本上的删除，然后再次点击同一个库卡片上的使用模板。您将获得一个全新的、未经改动的副本。

何时寻求帮助

• 模板编辑器无法加载，或保存无法生效。
• 收据在一台设备上打印正常，但在另一台设备上却不行。
• 您需要针对特定国家（意大利、巴西、西班牙等）的财税/法律布局——这些通常由 WCPOS Pro 或特定国家的集成来处理。
• 您正尝试做一些自定义操作，但 AI 始终无法完全实现。

请提交支持工单，并粘贴您正在使用的模板——这能为我们提供帮助您所需的一切信息。