参考来源与致谢
- 引用来源:how to change odoo email format to simple text
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
企业使用 Odoo 发送通知、报价、发票或工单邮件时,若收件方邮件客户端渲染 HTML 异常、被反垃圾策略拦截,或业务要求统一为纯文本通知,可将指定邮件模板的输出改为纯文本。此调整只影响模板渲染结果,不改变 Odoo 的邮件发送机制。
准备与风险 #
- 确认 Odoo 版本与部署方式(在线版或自建),不同版本界面路径可能不同,具体以对应版本官方文档为准。
- 准备测试环境,使用与生产一致的数据库副本和邮件模板副本进行验证。
- 操作前备份数据库与自定义模块目录,记录原始模板内容,便于回退。
- 纯文本邮件不支持按钮、图片、样式和跟踪像素,可能影响营销类邮件的点击统计。
- 不要在生产环境直接修改正在使用的系统模板,建议先复制模板再调整。
处理步骤 #
- 进入设置中的技术功能菜单,打开邮件模板列表。若界面未显示技术菜单,需先启用开发者模式。
- 找到目标模板,复制一份作为测试模板,避免直接改动系统模板。
- 在模板编辑界面查看正文字段。Odoo 模板正文通常使用 HTML 或 QWeb 语法,纯文本化有两种通用做法:一是将正文改为不含标签的纯文本内容;二是保留 QWeb 变量但去掉 HTML 标签与样式。
- 若模板正文由 QWeb 渲染,检查其中是否包含
t-esc、t-out等输出指令。纯文本场景下应避免输出 HTML 片段,必要时对变量做转义处理。 - 检查模板的邮件正文类型或子类型设置,确认发送时不会强制套用 HTML 包装。部分版本会在邮件发送环节附加默认布局,需要一并调整。
- 保存模板后,在测试环境用测试收件地址发送一封邮件,确认内容为纯文本。
修改系统模板或邮件服务器参数属于影响面较大的操作。请先在测试环境验证,确认无误后再考虑生产变更,并保留可回退的备份。
验证方法 #
- 查看收件箱中邮件的原始内容,确认不含 HTML 标签与内联样式。
- 在 Odoo 的邮件记录中检查正文存储内容,确认与预期一致。
- 使用不同邮件客户端(桌面端、网页端、移动端)分别查看,确认显示正常。
- 检查模板中的变量是否被正确替换,例如客户名称、单据编号等占位内容。
回退建议 #
- 若结果不符合预期,恢复备份的数据库或还原原始模板内容。
- 若仅修改了模板副本,删除副本并重新启用原模板即可。
- 若调整过邮件服务器或发送参数,逐项恢复原值并重新测试发送。
常见问题 #
- 邮件仍显示 HTML:检查是否还有其他模板或邮件布局在发送时被套用。
- 变量未替换:确认 QWeb 表达式语法正确,且模板上下文包含所需字段。
- 纯文本邮件被判定为垃圾邮件:检查发件域配置、SPF 与 DKIM 等基础邮件认证设置,具体配置请查阅对应版本文档。
- 多语言环境下内容不一致:确认各语言版本的模板正文均已调整。
- 升级后模板被覆盖:升级前备份自定义模板,升级后重新核对。
