YayMail WooCommerce邮件定制插件：拖放构建器与真实数据预览彻底改造交易邮件模板

YayMail通过拖放构建器和真实数据预览，彻底替代默认的WooCommerce交易邮件模板。

• 拖放式构建器，无需代码即可编辑邮件
• 实时预览，支持真实订单数据
• 50+动态区块和80+附加组件
• 取代设计层，不影响邮件发送功能

关键术语：

• YayMail：WooCommerce拖放邮件定制插件，可重新设计交易邮件模板。
• 动态区块：YayMail中可拖拽的邮件内容组件，如订单详情、商品列表。
• 交易邮件：订单确认、发货通知等由WooCommerce自动发送的邮件。

多年来，我一直告诉客户，WooCommerce 默认的订单邮件就很好。确实简洁，但功能齐全。直到有一天下午，我在自己刚建好的商店里下了个测试订单，在手机上打开确认邮件，然后把它放在笔记本电脑上打开的正式网站旁边。它们看起来像是来自两家不同的公司。一个温暖精致，另一个则是一个灰色盒子，带一条细紫色条，表格还超出了屏幕。

就在那一刻，我不再为它们辩护，而 YayMail 改变我的想法。它是一个拖放式自定义工具，让你可以重新设计 WooCommerce 发送的每封交易邮件，并带有实时预览和真实订单数据，无需打开任何模板文件。

这是一次详尽、诚实的全面介绍：YayMail 的功能、构建器的实际使用感受、哪些动态 WooCommerce 区块值得你花时间、80 多个扩展插件、完整的开发者参考，以及一个几乎会绊倒所有人的陷阱（它不发送你的邮件，这一点比你想象的更重要）。无论你是自己运营商店还是为客户建站，读完本文你都会清楚这个插件到底适合什么场景。

YayMail 到底是什么

YayMail 是由 YayCommerce（YaySMTP 和 YayCurrency 的同一个团队）开发的 WooCommerce 邮件自定义工具。它的唯一使命就是取代你编辑 WooCommerce 交易邮件的方式。不再是那些简陋、方正的默认模板（新订单、处理中、已完成等），而是一个可视化构建器，你可以将区块拖到画布上，右侧实时预览自动更新，然后点击保存。无需 PHP，也无需将模板文件复制到主题中。

这里有一个重要的区分需要提前说明。WooCommerce 本身就具备发送订单邮件的功能，还提供了一个小设置面板，可以替换页眉图片和调整几种颜色。YayMail 并不是要取代 WooCommerce 的邮件发送器，而是取代其上的 设计 层。你的商店仍然负责发送邮件，而 YayMail 只决定邮件长什么样。

安装过程极为轻便，几乎是最简单的了。 YayMail 是一个独立插件。无需先安装免费基础版，也无需额外寻找独立的核心附加组件。安装并激活后，它会在后台添加一个 YayCommerce » YayMail 菜单。唯一的硬性依赖就是 WooCommerce 本身，这很合理，因为整个功能都依赖于 WooCommerce 自己的 WC_Email 类。如果 WooCommerce 未激活，那就没有什么可自定义的了。

谁开发了它以及为何重要： YayCommerce 是一个专注于 WooCommerce 的商店，这一点显而易见。YayMail 并非试图成为一个恰好能与 WooCommerce 配合使用的通用邮件设计器。它从头开始就是围绕 WooCommerce 订单对象构建的，正因如此，它的实时预览能够获取真实订单，并渲染出实际的产品表格、总额和地址。通用工具是做不到这一点的。

YayMail 一览

此处不粘贴营销要点列表，而是列出一旦运行 YayMail 后，实际会改变你工作方式的功能。

• 真正的拖拽式构建器。 左侧面板存放元素，右侧显示邮件的实时预览，您可以在两者之间移动模块。这感觉就像一个页面构建器，只不过专门用于邮件。
• 带有真实订单数据的实时预览。 这是标题。预览不是通用的模拟图。选择一个示例订单，新订单邮件就会渲染该订单的产品表格、小计、运费、付款方式以及账单和收货地址。
• 超过 50 个元素，分为基础、通用、WooCommerce 和模块类别。包含标题、按钮、图片、分隔线、列、社交图标、倒计时器以及动态 WooCommerce 模块，正是这些让整个产品物有所值。
• 所有 WooCommerce 交易邮件，统列于一个列表。 新订单、已取消、失败、待处理、处理中、已完成、已退款、客户发票、客户备注、重置密码、新账户。每个邮件都可设计，WooCommerce 在需要分开处理管理员和客户收件人的情况下，会分别处理。
• 共享的全局页眉和页脚。 一次性设计好徽标页眉和页脚，它会应用到每封邮件中，从而保持品牌一致性。
• 桌面端和移动端预览切换，加上撤销和重做。在发送任何内容之前，您可以检查窄屏布局，而默认的 WooCommerce 邮件在这方面表现不佳。
• 一个测试发送选项卡。 将当前设计发送到您自己的收件箱，以便在真实的邮件客户端中查看，而不仅仅是在构建器中。
• 80 多个附加组件 扩展 YayMail 以对其他插件（如 Subscriptions、Bookings、Dokan、YITH 插件等）的邮件进行品牌化，此外还有条件逻辑附加组件，用于基于产品和规则的邮件。
• 面向真实工作流的设置工具： 同步的区块模式（跨邮件保持同步的可重用区块）、全局变量、文件附件、模板的导入/导出、迁移工具和备份。
• 一个开发者界面 包含专用的自定义文章类型、操作和过滤钩子以及自定义元素 API，以便机构可以打包自己的区块。

简短版本： YayMail 将电子邮件编辑从编码工作转变为设计工作，并且它使设计与真实的 WooCommerce 数据相关联，而不是静态占位符。

构建器：元素、实时预览和真实订单数据

构建器是你会花时间的地方，所以让我描述一下打开它时的实际外观。

屏幕分为两半。左侧是一个有两个选项卡的面板， 元素 和 模板，顶部有一个搜索框，你的元素按类别分组： 基础， 常规， WooCommerce，以及 Blocks。右侧是您正在编辑的邮件的实时渲染。顶部有一条工具栏，包含邮件选择器、示例订单选择器、撤销和重做、桌面/移动切换、预览眼睛图标以及保存按钮。

通过拖拽来构建。 从左侧抓取一个标题，拖放到画布上，它会立即出现在预览中。点击任何已放置的区块，其设置就会打开，以便您可以更改文本、颜色、间距、对齐方式等。这与Elementor等页面构建器的心智模型相同，只是面向HTML邮件的受限世界。

实时预览是它最吸引人的地方。 当我在演示中打开新订单邮件时，右侧显示的并不是占位文本，而是一个真实的订单：名为”Happy YayCommerce”的产品订购了两次，金额为约 130 元（$18.00），下方列出了小计、运费、总计、付款方式以及账单地址和配送地址。这是因为YayMail会针对实际的WooCommerce订单对象进行渲染。

那个顶栏 示例订单选择器 这就是你选择哪个订单来提供预览的方式。将其指向商店中的一个真实订单，你就能真实了解客户收到的邮件会是什么样子，包括长商品名、多个商品项或优惠券行等边缘情况。你不再需要猜测。

桌面/移动端切换比听起来更重要。 大多数订单邮件在手机上会显示错乱，而大多数人是在手机上阅读订单邮件的。将预览切换到移动端，你就能在发送任何邮件之前，看到你的两栏布局是否整洁堆叠，或者产品表格是否溢出。

现在，一个坦诚的技术说明。YayMail的后台是一个Vue单页应用，因此其编辑器是现代JavaScript界面，而非一堆经典的WordPress元数据框。在日常使用中，这是件好事，拖拽交互流畅，但这确实意味着编辑器在wp-admin内部感觉像是一个独立的运行环境，而非原生的WordPress界面。它截图效果良好，加载速度快，只是有其独特的风格。

提示： 在操作单个邮件前，打开 全局页眉和页脚 标签页，并先设计好它们。每封邮件都会继承这些内容，所以一次性设置好你的徽标、页眉背景和页脚（地址、退订类法律文本、社交链接），可以为你省去重复十一遍的工作。

所有 WooCommerce 邮件汇集一处

打开 YayMail，首先映入眼帘的是邮件模板列表。这里列出了 WooCommerce 可以发送的所有邮件，作为一个清单非常实用，因为很多店主从未见过自己所有的交易邮件列在同一个地方。

每一行显示邮件名称、其 状态 （启用或停用）、 收件人、 来源 （WooCommerce 或您的某个插件）以及最后更新时间。列表涵盖了完整的邮件类型：

• 新订单 （发送给管理员，告知有新订单产生）
• 已取消订单 （管理员和客户）
• 失败订单 （管理员和客户）
• 订单暂停 （客户）
• 处理中订单 （客户，即“我们已收到您的订单”的邮件）
• 已完成订单 (客户，名为“已发货/已完成”的邮件)
• 已退款订单 (客户)
• 客户发票/订单详情 (手动或按需发送)
• 客户备注 (当你为订单添加备注时)
• 重置密码 和 新账户 （账户生命周期邮件）

以下是需要理解的关键行为。 默认情况下，每个模板处于非活动状态，WooCommerce 会发送其自带的纯文本版本。当你将 YayMail 模板切换为 激活后，YayMail 会接管该特定邮件的渲染，你的设计将被发送出去。保持一个模板为非活动状态，WooCommerce 会照常处理。这意味着你可以重新设计最重要的三四个邮件（新订单、处理中、已完成），而暂时保持其他邮件不变。

管理员与客户之间的区分值得一提。 某些邮件，如新订单，会发送给店主。其他邮件，如处理中和已完成，会发送给买家。少数邮件，如已取消和失败，同时发送给双方，而 WooCommerce 将这些视为独立的邮件并各自有不同的收件人。YayMail 尊重这种区分，因此你可以将面向客户的已完成邮件设计成品牌化、适合追加销售的样式，而将面向管理员的新订单邮件保持为简洁、信息密集、两秒即可扫描的布局。不同受众，不同用途。

您可能想知道激活 YayMail 模板是否会改变 触发时间 或 谁 它理解吗？不，它不理解。触发条件和收件人仍然是 WooCommerce 的。YayMail 只改变消息的内容和设计。这是一个刻意划定的界限，而且是一条正确的界限。

让 WooCommerce 物有所值的元素

许多工具都可以在邮件中放入 Logo 和按钮。YayMail 与普通 HTML 邮件编辑器的区别在于它的一套 动态 WooCommerce 元素 它们在发送时呈现实时的订单数据。这些是我真正会使用的区块，也是这个插件值这个价格的原因。

订单详情 它是主力。它是一个明细表（产品、数量、价格、小计、运费、税费、总计），直接从订单中提取。你可以设计它的样式，但数据对每个收件人来说都是真实且实时的。

订单进度 是一个可视化状态条，显示订单在您的履行流程中的位置。客户不再需要眯着眼睛看 ‘处理中' 这个词，而是一眼就能看到进度指示器。这是一件小事，但能显著减少 ‘我的订单在哪里？' 这类支持邮件。

账单地址、配送地址，以及一个合并的账单/配送块 将客户的实际地址拖入布局，按照 WooCommerce 存储它们的格式进行排版。

订单详情下载 为销售数字商品的商店呈现可下载产品的链接，以便客户直接在确认邮件中获取文件。

接下来是营收模块，这也是商店所有者容易忽略的部分。

精选产品 让您可以在电子邮件中展示精心挑选的产品。 交叉销售/追加销售产品 提取已订购产品上配置的交叉销售和追加销售产品。 带有评论的产品 展示产品及其星级评分以提供社交证明。将“交叉销售”区块放入您的 已完成订单 邮件中，一位满意的客户在对自己购买感到满意的时刻，会看到“您可能还喜欢”。这是您拥有的最高意向营销时机，而且是您已经拥有的免费资源。

如果您经营印刷店或商品商店， 包含“特色产品”区块的“已完成订单”邮件就成为一个安静的第二门面。 如果您销售可下载的设计素材， “订单详情下载”区块加上“交叉销售”区块，将每封发货邮件变成对下一套产品的温和推销。

还有一个“发货追踪”元素和一个“高级发货追踪（AST）”集成区块，因此如果您使用追踪插件，运单号和承运商会作为动态数据直接出现在邮件中，而无需手动粘贴。还有一个 “高级本地自提说明” 区块和一个 Admin Custom Order Fields 针对需要在消息中包含取件详情或自定义订单元数据的商店的区块。

注意： 动态区块仅在预览指向实际包含该数据的订单时才会呈现有意义的数据。如果您的 Cross-sell 区块在预览中显示为空，通常是因为示例订单的商品没有配置交叉销售，而不是区块出了问题。将示例订单选择器指向一个已知设置了交叉销售的订单，它就会填充内容。

还有一个布局层面的元素值得向开发者提及： Hook 元素。您可以将 WordPress 动作钩子直接放入邮件正文中，这意味着开发者可以在布局的特定位置渲染完全自定义、由代码生成的内容，而无需构建一个完整的自定义元素。这是一个巧妙的“后门”。

80+ 个插件：覆盖你其余技术栈的邮件

WooCommerce 很少单独存在。一个真实的商店会运行 Subscriptions（订阅）、Bookings（预订）或多供应商插件，而每一个都会发送自己的邮件。开箱即用，YayMail 可以定制 WooCommerce 的核心邮件。The 80 多个插件扩展 正是通过这些扩展，你将 其他 插件的邮件统一在你自己的品牌下。

打开插件扩展界面（标题为“探索 80 多个 WooCommerce 邮件自定义插件扩展”），你会看到按类别分组的集成卡片网格：营销、支付、会员、多供应商、订阅、订单状态、预订。每个扩展都会让 YayMail 了解特定插件的邮件和数据，添加正确的元素和合并标签，以便你可以像设计核心邮件一样设计它们。

要清楚“80 多个插件扩展”的含义，因为这个营销数字容易误解。 这些是集成，而不是 80 个全部捆绑并启用的功能。你需要安装并激活与你商店实际运行的插件相匹配的特定扩展。如果你不使用预订插件，就永远不需要触碰预订扩展。这个数字衡量的是覆盖范围，而不是默认加载的数量。

以下是在实践中最重要的集成：

• WooCommerce Subscriptions。 如果你销售周期性产品，续订、取消和订阅切换的邮件是你发送的阅读率最高的邮件之一。该扩展让你可以对它们进行品牌定制，使其风格统一。如果你在考虑订阅功能，我们的 WooCommerce Subscriptions 指南涵盖了计费方面的工作原理。
• Dokan 和其他多供应商插件。 在市场上，供应商会收到各自的通知邮件。Dokan 插件可以让您对这些供应商邮件进行品牌定制，从而使整个市场感觉像一个统一的平台，而不是拼凑物。
• YITH 插件 （愿望清单、订阅、预购、多供应商）， SUMO Subscriptions， WooCommerce Bookings， WooCommerce Appointments， WooCommerce Waitlist， Quotes for WooCommerce， WooCommerce B2B， Germanized Pro， Smart Coupons， Order Delivery Date Pro，等等。这个列表读起来就像 WooCommerce 商店实际运行的插件普查。

然后还有一个不是关于第三方插件的插件： YayMail 条件逻辑。 这个是我认为大多数商店都应该考虑的插件。它允许你根据条件发送不同的邮件内容，使用 任意/所有 和 是/不是 规则。为特定产品发送自定义邮件。只向某个国家的客户显示一个区块。根据订单总额更换追加销售部分。在订单实际发货前隐藏追踪区块。它将 YayMail 从“一种邮件一种设计”转变为“为每种情况提供合适的设计”，这是你能做的事情的一个有意义的飞跃。

YayMail 与手动编辑及新闻通讯工具的比较

对于 YayMail 来说，你有三个实际的替代方案，诚实地说明每种方案的优势是值得的。

默认设置允许你添加一张页眉图片和大约三种颜色，这就是全部了。而 YayMail 提供了 50 多个元素、完整的布局控制、动态追加销售区块以及移动端预览。如果你只需要一个 logo 和品牌色，默认设置完全够用，而且是免费的。但如果你希望邮件看起来和你的网站风格一致，默认设置很快就会显得力不从心。 系统自带默认邮件模板仅支持设置一张头部图片、大概三种主题配色，这就是它的功能上限。而 YayMail 插件提供五十余种邮件组件、完整布局自定义能力、动态追加推销区块，还自带移动端预览功能。如果你只需要简单放个品牌 Logo、设置一个主色调，原生模板完全够用，而且不用额外花钱。但如果你希望商城邮件视觉风格和网站统一，默认模板很快就会暴露出功能不足、无法满足需求。

与手动编辑 WC_Email 模板相比。 这是开发者路线：将WooCommerce的邮件模板复制到你的主题中，然后手动编辑PHP和内联样式。这种方式免费且无限灵活，但也缓慢、脆弱且维护成本高昂。这些模板会随WooCommerce版本更新而改变，而被你遗忘的覆盖可能会悄然失效或过时。我曾花费数小时调试一个商店，其自定义邮件模板在一次更新后停止渲染总计金额。YayMail将设计保存在数据库中的自定义文章类型中，而不是模板文件，因此WooCommerce更新不会悄悄破坏你的工作。你用一些理论上的灵活性换来了更强的耐久性。

与新闻通讯或营销工具相比。 这是人们最常误解的比较，所以请允许我直言不讳。 YayMail 仅用于交易邮件。 它设计的是WooCommerce在响应订单时自动发送的邮件：确认、状态变更、发票。它不发送营销新闻通讯、培育式营销活动或促销广播。如果你想向邮件列表发送黑五大促或每周摘要，那是MailPoet或FluentCRM的领域，不是YayMail。这两个工具解决不同的问题，一个健康的商店通常同时运行两者：一个用于活动的营销工具，以及用于订单邮件的YayMail。

可量化的总结： 50+个拖放元素、80+个插件集成、一个实时预览、覆盖所有11个WooCommerce核心交易邮件。默认邮件无法匹配设计范围，手动编辑无法匹敌速度或更新安全性，而新闻通讯工具根本不涉及订单邮件。

谁应该使用（以及谁不应该使用）

让我用具体例子来说明，因为“自定义邮件”这个概念在你看到自己实际应用之前是很抽象的。

注重品牌的店主。 你的网站很精美，但订单邮件却像2011年的收据。每当客户收到一封邮件，你苦心经营的品牌体验就在他们最投入的那一刻受到冲击。这正是使用 YayMail 最明显的理由。让邮件与网站匹配，整个购买过程就显得经过精心设计。

追求复购的商店。 你已经知道获取新客户比留住老客户成本更高。在已完成订单邮件中放入一个交叉销售或特色产品模块，你就可以免费向一个热情、已付款的客户营销，而且他们一定会打开这封邮件。订单邮件的打开率是营销邮件梦寐以求的。利用这个空间进行温和的追加销售，是电子商务中回报最高、付出最低的操作之一。

使用多个插件的商店。 你运行着 Subscriptions、Bookings 或 Dokan，这些插件发送的邮件与你的 WooCommerce 邮件看起来完全不同。这些附加组件将所有邮件统一到一致的设计下。对于市场或订阅业务，这种一致性决定了客户是感觉你像一家真正的公司，还是感觉像披着风衣的三个插件。

代理机构或自由职业者。 你为客户搭建商店，不想手动编辑 WC_Email 每个客户的模板，然后永久维护它们。YayMail 为你提供了一种可重复、可视化、对客户安全的邮件品牌化方式，导入/导出工具意味着你可以将基础模板从一个项目带到另一个项目。自定义元素 API 甚至允许你提供自己的模块。

谁应该跳过它？ 说实话，有两类人。

首先，如果你只想在默认的电子邮件中添加你的标志和几种品牌颜色，WooCommerce 自带邮件设置已经免费提供了。不要为了修改三种颜色而购买定制器。

其次，这是重点，如果你实际想要的是发送 营销简报或促销活动，那么 YayMail 是错误工具。它不发送广播信息，也不管理订阅者列表。那是专用邮件营销插件的任务。购买 YayMail 却期望它是一个简报生成器，这是最常见的让人失望的原因，如果你一开始就知道它只用于交易邮件，完全可以避免。

不要重新设计邮件却忘了它们仍然要能送达。

聪明人会犯的一个错误，而且会花费真金白银。

你花了一个下午用 YayMail 打造了一封精美、符合品牌风格的“已完成订单”邮件。预览看起来完美，你点击保存，然后继续。但是你的 WordPress 网站仍然通过 PHP 默认的 mail() 函数发送邮件，未经身份验证，来自 Gmail 和 Outlook 不信任的服务器。所以大部分邮件会进入垃圾箱，客户永远看不到。

他们不会觉得“设计不错”。他们会认为你收了钱就销声匿迹了，于是提出争议。钱和信任都没了，而设计跟这毫无关系。

这是人们容易忽略的一点：YayMail 负责设计邮件，但不负责发送，也无法解决送达率问题。 这是两件不同的事。YayMail 负责邮件的外观，而且做得很出色；但它完全无法控制邮件是否到达收件箱。这取决于你的网站如何发送邮件。

解决方案很简单，但你必须去做。将 YayMail 与正确的 SMTP 设置搭配使用，让邮件通过认证发送，而不是直接通过原始 PHP。像 WP Mail SMTP 这样的工具会将你的邮件通过真正的发送服务路由出去，我们关于修复 WordPress 邮件送达率的指南会详细介绍。使用 SPF 和 DKIM 验证你的域名，这样邮箱提供商才会信任你。

然后进行真实测试。向 Gmail 和 Outlook 地址发送一封真实的测试邮件，而不仅仅是 YayMail 的预览，并检查各自的垃圾邮件文件夹。在真实的手机上打开它，因为在桌面端看起来完美的邮件在窄屏幕上可能会崩溃。

只有当测试邮件真正进入收件箱——在桌面端和移动端都看起来与构建器中一致——这封邮件才算完成。预览是承诺，收件箱是证明。

送达率、性能与陷阱

基于那个反模式，这里有一些诚实的注意事项和边缘情况，在你决定使用之前值得了解。

YayMail 是一个设计层，而不是邮件服务器。 我在上面已经说过，但值得重复，因为这是最常见的误解。如果你的邮件无法送达，YayMail 不是问题，重新安装它也无济于事。先修复发送（SMTP、域名验证），再设计外观。

前端性能基本上不是问题，这一点让很多人感到意外。 YayMail 的工作在两个地方进行：管理后台的构建器（编辑时加载的 Vue 应用）和发送时生成的邮件 HTML。它不会向前台添加脚本或样式，因此对网站的页面速度或 Core Web Vitals 没有影响。如果你正在使用 WP Rocket 之类的工具仔细管理前端性能，YayMail 完全不在这个范畴内。唯一的性能开销是邮件渲染时的一小部分额外处理，对于正常订单量来说可以忽略不计。

Vue 构建器很现代，但这也有一个权衡。 界面流畅快速，但由于它是单页应用而非传统的 WordPress 界面，非常激进的优化插件或 wp-admin 上的严格内容安全策略有时会干扰其加载。如果构建器显示空白画布，首先检查的就是这个：是否有东西阻止了管理后台的 JavaScript？

邮件 HTML 是一个充满挑战的领域。 这不是 YayMail 的缺陷，所有邮件都是如此，但这常常让人措手不及。邮件客户端渲染 HTML 的方式不一致。尤其是 Outlook 使用 Word 的渲染引擎，会扭曲现代 CSS。YayMail 的元素正是为此而构建的，使用了对邮件安全、基于表格的 HTML，但这意味着相比网页设计你受到限制。不要指望有 flexbox 级别的布局控制。坚持使用设计的元素，并在真实的客户端中测试。

测试发送是必不可少的。 构建器预览是浏览器渲染，没有任何浏览器预览能完美预测 Gmail、Outlook 和 Apple Mail 的呈现效果。在将模板应用到正式商店之前，请使用“预览邮件”选项卡给自己发送一份真实的邮件。

兼容性说明。 YayMail 需要启用 WooCommerce，并且对 PHP 版本要求不高，因此主机很少成为障碍。它通过专用的语言过滤器支持 WPML，因此多语言商店可以用客户的语言发送邮件。在多站点中，像大多数 WooCommerce 插件一样，按站点安装。需要留意的一类冲突是其他也试图覆盖 WooCommerce 邮件渲染的插件；同时运行两个邮件定制器会带来问题，因此选择一个即可。

重大变更前先备份。 YayMail 在设置中提供了备份工具，我建议使用它。在重构全局头部或彻底修改已激活的模板前，先备份一下。这个两秒钟的习惯能让你在不喜欢某个更改时，免去重做一小时工作的麻烦。

开发者参考：钩子、过滤器和自定义文章类型

YayMail 比大多数邮件工具对开发者更友好，因为它提供了真正的扩展接口，而不仅仅是设置界面。以下是实际可用的内容。以下所有内容均经过插件源码验证；我剔除了所有无法确认的信息。

自定义文章类型。 邮件设计以自定义文章类型存储， yaymail_template每个设计的邮件都是此类型的文章，这就是为什么你的设计在 WooCommerce 更新后依然存在（它们存储在数据库中，而非主题模板文件中）。模式有它们自己的相关文章类型。如果你需要以编程方式查询或迁移设计，这就是你的入口点。

$templates = get_posts( array(
    'post_type'   => 'yaymail_template',
    'post_status' => 'publish',
    'numberposts' => -1,
) );

foreach ( $templates as $template ) {
    // Each post is one YayMail email design.
    echo esc_html( $template->post_title );
}

REST 层是内部的。 YayMail 注册了一个 REST 命名空间， yaymail/v1它为 Vue 构建器提供支持（附件处理、模板库等）。它受身份验证保护，专用于管理应用。请将其视为私有的内部 API，而非用于构建集成的公开记录接口。它可能随时更改，恕不另行通知。

注册自定义元素。 这个 yaymail_register_elements action 会将元素加载器传递给你，这样你就可以将自己的拖放块添加到构建器面板中。机构使用此功能来提供不属于核心集合的品牌块。

add_action( 'yaymail_register_elements', function ( $elements_loader ) {
    // $elements_loader is YayMail's element registry.
    // Register your own element class so it appears in the builder palette.
    $elements_loader->register( new My_Loyalty_Badge_Element() );
} );

注册自定义邮件类型。 这个 yaymail_register_emails action 会将邮件集合提供给你，这样你就可以在 YayMail 中设计自定义邮件（由你自己的插件触发），与核心 WooCommerce 邮件并列。

add_action( 'yaymail_register_emails', function ( $yaymail_emails ) {
    // Add a custom email so it shows in YayMail's template list
    // and becomes editable in the builder.
    $yaymail_emails->register( new My_Renewal_Reminder_Email() );
} );

在设计邮件发送时作出响应。 这个 yaymail_trigger_email 当 YayMail 发送其设计的邮件时，action 会触发并附带邮件对象和订单 ID。便于记录日志、分析或将“已通知”标志同步回另一个系统。

add_action( 'yaymail_trigger_email', function ( $email, $order_id ) {
    // $email is the WC_Email-derived object; $order_id is the WooCommerce order.
    error_log( sprintf( 'YayMail sent %s for order #%d', $email->id, $order_id ) );
}, 10, 2 );

添加自定义合并标签。 这是大多数开发者会使用的过滤器。 yaymail_extra_shortcodes 该过滤器允许你注册自己的合并标签（merge-tag），这样商店工作人员就可以在邮件构建器中向任何邮件插入动态数据。假设你运营一个忠诚度计划，并需要一个 {loyalty_points} 显示客户余额的标签。

add_filter( 'yaymail_extra_shortcodes', function ( $shortcodes, $data ) {
    // Each entry is a list item with a 'name' key (not the array key),
    // matching the shape of YayMail's own merge-tags.
    $shortcodes[] = array(
        'name'        => 'loyalty_points',
        'description' => 'Loyalty points',
        'group'       => 'general',
        'callback'    => function ( $data, $atts ) {
            // YayMail passes its render data (the order lives at $data['order']),
            // not the WC_Order directly.
            $order = isset( $data['order'] ) ? $data['order'] : null;
            return $order ? (int) get_post_meta( $order->get_id(), '_loyalty_points', true ) : '';
        },
    );
    return $shortcodes;
}, 10, 2 );

重要术语说明： 这些“短代码”实际上是 邮件合并标签（email merge-tags），是你在邮件设计中放置的订单和客户数据令牌。它们不是前端 WordPress [shortcode] 标签，也不会在你的页面上运行。它们仅在邮件渲染时解析。

过滤传入模板的数据。 该 yaymail_template_rendering_args filter 允许你在电子邮件渲染时注入或调整可用数据，这在自定义元素或 Hook 元素需要额外值时非常有用。

add_filter( 'yaymail_template_rendering_args', function ( $args ) {
    // $args holds the data passed into the email at render time.
    $args['store_hours'] = 'Mon to Fri, 9am to 5pm';
    return $args;
} );

该 filter 是 YayMail 的 WPML 和多语言钩子。它允许你控制用于确定客户语言的订单上下文，因此发出的电子邮件会根据客户下单时的语言进行翻译。 yaymail_order_for_language 一些有意不在此处的内容。

add_filter( 'yaymail_order_for_language', function ( $order ) {
    // Return the order used to resolve the customer's language for WPML.
    return $order;
} );

插件中没有 WP-CLI 命令集；电子邮件设计是一项视觉工作，因此没有 CLI 界面可编写脚本。同样，也没有需要满足的免费基础依赖项，也没有需要集成的公共 REST API。如果你在扩展 YayMail，那么操作、过滤器、自定义元素 API 以及 post type 是你的工具包。对于这些钩子所基于的底层 WooCommerce 电子邮件类，WooCommerce 和 WordPress 电子邮件开发者文档是需要随时打开的参考资料。 yaymail_template 常见问题解答

YayMail 会发送我的 WooCommerce 电子邮件或修复送达率吗？

不会，这是最重要的一点。YayMail 设计你的电子邮件；WooCommerce 和你的服务器仍然负责发送。如果你的邮件进入垃圾邮件箱或无法送达，那是发送问题，而不是设计问题，你可以通过 SMTP 插件和正确的域名认证（SPF 和 DKIM）来解决。设计和发送是两件独立的工作，YayMail 只负责前者。

不是的，这一点是最关键的，务必理解清楚。

YayMail 只负责设计邮件外观；实际发送邮件的主体仍是 WooCommerce 和你的服务器。

如果邮件进了垃圾邮箱、或是根本收不到，这属于邮件投递发送层面的问题，和邮件界面设计无关。想要解决这类问题，需要借助 SMTP 发送插件，并正确配置域名身份验证（SPF、DKIM 记录）。

邮件视觉设计与邮件投递送达是两套完全独立的工作，YayMail 只负责前者。

使用 YayMail 需要先安装 WooCommerce 吗？
需要。YayMail 直接构建在 WooCommerce 的邮件系统之上，因此必须安装并激活 WooCommerce。没有 WooCommerce，就没有可自定义的交易邮件，插件也无处挂钩。它不是通用的 WordPress 邮件设计器。

YayMail 适用于营销简报或推广活动吗？
不适用，如果抱着这种期望购买它，那就大错特错了。YayMail 仅处理交易邮件，即与订单相关的自动消息（确认、状态变更、发票、账户邮件）。它不管理订阅者列表，也不发送广播邮件。对于简报和滴灌式营销活动，你需要像 MailPoet 或 FluentCRM 这样的营销工具。许多商店同时运行两者，用营销工具做推广活动，用 YayMail 处理订单邮件。

在安装 YayMail Pro 之前，需要先安装免费版吗？
不需要。YayMail Pro 本身就是一个完整的插件。无需先安装免费基础版，也没有单独的核心附加组件。只需安装这一个插件，激活它，一切即可运行。唯一的依赖是 WooCommerce。

所有 80 多种附加组件是否都包含在内并默认启用？
不是。这 80 多种附加组件是针对特定第三方插件（Subscriptions、Bookings、Dokan、YITH 等）的集成。你只需安装并激活与你的商店实际运行的插件相匹配的那几个。这个数字反映了覆盖范围的广度，而不是默认加载的一大堆功能。大多数商店只使用其中的几个。

WooCommerce 更新会破坏我的邮件设计吗？
不会，这也是相对于手动编辑模板的一大优势。YayMail 将您的设计作为自定义文章类型存储在数据库中，而不是作为主题中的模板覆盖，因此 WooCommerce 更新不会静默覆盖或破坏您的工作。手动编辑的 WC_Email 模板覆盖是那种在更新过程中容易偏移和出问题的做法。

电子邮件的管理员版和客户版有什么区别？
WooCommerce 会向您（店主）发送一些邮件，也会向买家发送一些邮件，还有少数邮件会同时发送给双方。新订单邮件发送给管理员；处理中和已完成邮件发送给客户。YayMail 将这些邮件分开管理，因此您可以独立设计一份简洁易读的管理员新订单邮件，以及一份精美且便于追加销售的客户已完成邮件。它们面向不同的读者，所以外观也应该不同。

我可以自定义来自其他插件（如 Subscriptions 或 Dokan）的电子邮件吗？
可以，通过插件扩展来实现。核心插件自定义 WooCommerce 自身的邮件；相应的扩展插件将 YayMail 的功能扩展到来自 Subscriptions、Dokan、Bookings、YITH 插件以及数十个其他插件的邮件，为每个插件添加正确的元素和合并标签。这样，您店铺发送的每一封邮件（而不仅仅是 WooCommerce 核心邮件）都能拥有一致的设计。

实时预览显示的是客户实际收到的内容吗？
很接近，但请将其视为强有力的预览，而非绝对保证。邮件构建器在您的浏览器中渲染，而真实的电子邮件客户端（尤其是 Outlook）会对 HTML 进行不同的渲染。在真实店铺上激活模板之前，务必使用测试发送功能将实际邮件发送给自己，并在桌面端和手机上打开查看。预览用于设计，测试发送用于确认。

有没有办法在多个邮件或店铺之间重复使用同一设计？
有。同步模式让您只需构建一个区块，即可在其使用的所有位置保持同步；全局页眉和页脚会自动应用于所有邮件；导入/导出工具让您可以在店铺之间转移模板。对于反复构建类似店铺的代理机构来说，这种导出/导入流程可以节省大量重复设置工作。

总结

我曾是WooCommerce邮件定制器的怀疑者，坚信默认邮件已经足够好，任何更花哨的功能都是没事找事。直到我把一个测试订单放在自己的网站旁边，才改变了看法。精美店铺与灰色订单邮件之间的差距是真实存在的，客户即使说不清也能感受到。

YayMail弥补了这一差距，无需你编写代码或操心模板覆盖。它的构建器用起来很舒服，基于真实订单数据的实时预览是点睛之笔，而动态WooCommerce区块（特别是已完成订单邮件中的交叉销售和特色产品区块）能将你打开率最高的消息转化为静默的收入。80多个插件意味着它能与你的技术栈共同成长，而不会让你的Subscriptions或Dokan邮件显得孤立无援。此外，开发者表面、 yaymail_template 文章类型、元素和邮件注册钩子以及合并标签过滤器，比我预想的邮件插件要周到得多。

只要清醒地把握两个边界就行。YayMail设计邮件，但不负责发送或改善送达率，所以需要搭配真正的SMTP设置，并在真实收件箱中测试。它用于事务性邮件，而非营销邮件，因此请将新闻通讯工具留作营销活动使用。尊重这两个界限，它就能干净利落地完成工作。

先重新设计三个最重要的邮件（新订单、处理中、已完成），在真实收件箱中测试，你就会纳闷为什么之前让它们看起来像收据那么久。