跳到主内容
版本: 1.x

自定义收据

如果您想更改收据的外观，有三种方式可以选择。选择最适合您需求的方式——大多数店铺只需要第一种即可。

三种自定义方式​

1. 选择不同的模板

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

2. 让 AI 帮您调整

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

3. 手动编辑

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

三种方式的起点相同：WP Admin → POS → 模板。页面分为两部分——顶部是您的模板（当前正在使用的模板），下方是模板库（预置的模板合集）。

选项 1 — 选择其他模板​

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

1

打开模板库

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

2

浏览和预览

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

3

使用模板

点击卡片上的使用模板按钮。WCPOS 会创建一个可编辑的副本，并将其添加到页面顶部的您的模板中。切换该行的启用开关即可在收据中使用；拖动该行的手柄可调整顺序。您可以同时启用多个模板——收银员在收银台自行选择。

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

点击使用模板始终会创建一个全新的副本。原始的模板库模板保持不变，因此您可以随时返回选择不同的起点。如果同时启用了多个收据模板，收据界面会显示一个下拉菜单，方便收银员随时切换。

内置模板​

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

大多数内置模板会自动适配店铺的税费设置——含税店铺显示含税价格和"含税"行；不含税店铺显示净价，税费作为单独一行显示。详细系列模板无论设置如何，始终显示完整的税费明细。

WP Overnight 发票和装箱单模板​

如果您的站点还使用了 WP Overnight 的 PDF Invoices & Packing Slips for WooCommerce，WCPOS 会自动向您的模板中添加两个额外的模板：

模板格式用途
发票（WP Overnight）服务器端渲染的 HTML使用 WP Overnight 配置的发票文档用于 POS 订单
装箱单（WP Overnight）服务器渲染 HTML使用 WP Overnight 配置的装箱单文档用于 POS 订单

这些模板不会复制 WCPOS 内置的发票或装箱单布局。它们会请求 WP Overnight 为 POS 订单渲染文档，因此您现有的发票编号、品牌标识、法律/税务字段以及 WP Overnight 模板自定义设置在线上订单和店内订单之间保持一致。

仅在 WP Overnight 插件处于激活状态时显示。输出会在 WCPOS 打印界面中以 HTML 形式打开，而非作为单独的 PDF 文件下载。由于文档在服务器端渲染，打印这些模板时 POS 需要连接到您的站点；如需离线打印，请使用内置的 HTML 或热敏模板。

按店铺分配​

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

在 WP Admin → POS → 店铺 中进行设置，然后打开要配置的店铺。编辑店铺页面包含一个收据模板区域，其中有一个*“店铺专属收据模板”*开关：

  • 关闭 （默认）——店铺继承 POS → 模板 页面的全站模板列表。
  • 开启——店铺拥有独立的模板选择和排序，与全站默认设置互不影响。拖动手柄排序的操作方式相同。

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

当收银员在某个店铺登录时，收据下拉菜单中仅显示该店铺的已启用模板。

全站设置与按店铺设置

WP Admin 中的模板页面为整个站点设置默认值。按店铺覆盖功能的存在，是为了让同一个模板（例如标准收据）可以在不同门店展示不同的品牌形象，或者让某个门店使用其他门店不需要的布局。如果所有店铺都需要相同的模板，只需将按店铺分配留空，全站默认设置即会生效。

方案二——让 AI 帮您调整​

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

1

复制模板

在 WP Admin → POS → 模板 中打开要使用的模板，点击进入编辑器，选中左侧的所有文本（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 能够理解这些占位符——您无需了解细节。如果您想知道所有可用的占位符，请参阅收据数据参考。

选项 3 — 手动编辑​

如果您了解一些 HTML（或与开发人员合作），可以直接在应用内编辑器中编辑模板。编辑器提供实时预览、语法高亮、可搜索的字段选择器、撤销/重做以及查找替换功能。

选择您的模板引擎：

  • HTML 模板 — Mustache 风格的 {{variable}} 占位符。客户端渲染，支持离线使用。推荐大多数店铺使用。
  • 热敏打印模板 — 用于 ESC/POS 热敏打印机的 XML。同一模板同时生成屏幕预览和打印输出。
  • 小票数据参考 — 所有可用占位符，按分区分组。
旧版 PHP 模板

如果您之前通过主题中的 PHP 文件(yourtheme/woocommerce-pos/receipt.php)覆盖小票模板，该方式仍然有效。它现在在模板库中标记为旧版 PHP 模板，与新的无逻辑模板引擎和热敏打印引擎并列。WP Overnight 集成也使用服务器端渲染路径，因为第三方文档 API 在服务器上渲染 HTML。新的自定义应使用模板库或应用内编辑器——它们支持离线使用、实时预览，且无需服务器往返。

常见自定义​

以下是最常见问题的快速解答。

如何添加店铺徽标？

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

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

如何更改页脚文本（例如"感谢您的惠顾！"）？

两种方式：

  1. 最简单 — 在 WP Admin → POS → 设置 → 店铺 → 店铺详情 → 收据页脚/个人备注 中设置一次，即可应用于所有收据。内置模板会自动使用该设置；如果未设置页脚，则会回退到友好的默认内容，例如 "感谢您的惠顾！"。
  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 应用中，前往设置 → 打印路由。您将看到每个活跃模板旁边都有一个打印机下拉菜单。选择所需的打印机，或保留为自动。

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

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

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

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

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

预览为空白或显示"未找到 POS 订单"

此问题仅出现在旧版 PHP 模板中，因为它们需要一个真实订单才能进行预览。处理一笔 POS 订单（即使是 $0 的测试交易）后，预览即可正常显示。

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

搞乱了——如何重新开始？

三重安全保障：

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

何时寻求帮助​

  • 模板编辑器无法加载，或保存后更改未生效。
  • 收据在一台设备上打印正常，但在另一台设备上无法正常打印。
  • 需要针对特定国家（意大利、巴西、西班牙等）的财税/法规版式——这些通常由 WCPOS Pro 或特定国家的集成方案来处理。
  • 您正在尝试自定义内容，但 AI 无法完全实现预期效果。

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