[TITLE]
Odoo 邮件模板使用指南及编辑技巧

[DESCRIPTION]
本文详细介绍了 Odoo 中邮件模板的概念、访问路径及多种编辑方式，包括 Powerbox 富文本编辑、XML/HTML 代码编辑、动态占位符、模板重置、回复设置、事务邮件链接处理以及多语言翻译的更新方法，帮助用户高效创建和维护高质量的邮件内容。

[KEYWORDS]
Odoo,邮件模板,动态占位符,Powerbox,XML编辑,富文本编辑,模板重置,事务邮件,多语言翻译,邮件回复

邮件模板

邮件模板是指从数据库中重复使用的已保存邮件。它们让用户能够发送高质量的沟通内容，而无需一次又一次地撰写相同的文字。

创建针对特定情境的不同模板，使用户能够为合适的受众选择恰当的信息。这能够提升信息质量以及整体的客户参与度。

:::: note
::: title
注意
:::
邮件模板在 Odoo 中使用 QWeb 或 XML，这使得在最终渲染时即可编辑邮件，定制更为稳健，无需编辑任何代码。这意味着 Odoo 可以使用图形用户界面（GUI）编辑邮件，而实际修改的是后台代码。当收件人的程序读取邮件时，最终形式会呈现不同的格式和图形。
::::

在开发者模式 (developer mode <developer-mode>) 下，路径为：
设置应用 --> 技术菜单 --> 邮件 --> 邮件模板

在处理邮件模板时可以使用 Powerbox 功能。该功能提供直接编辑模板中的格式和文本的能力，并可添加链接、按钮、预约选项或图片。

此外，还可以通过 </> 图标直接编辑邮件模板的 XML/HTML 代码。模板中同样支持使用动态占位符（引用 Odoo 中的字段）。

Powerbox 是一个功能丰富的文本编辑器，提供多种格式、布局和文本选项。它也可以在邮件模板中加入 XML/HTML 功能。通过在模板正文输入正斜杠 / 来激活 Powerbox。

当在模板正文输入 / 时，会出现下拉菜单，包含以下选项：

结构

  • 项目符号列表：创建简单的项目符号列表。
  • 编号列表：创建带编号的列表。
  • 检查清单：使用检查清单跟踪任务。
  • 表格：插入表格。
  • 分隔线：插入水平分隔线。
  • 引用：添加块引用。
  • 代码：添加代码块。
  • 2 列：转换为两列布局。
  • 3 列：转换为三列布局。
  • 4 列：转换为四列布局。

格式

  • 标题 1：大型章节标题。
  • 标题 2：中型章节标题。
  • 标题 3：小型章节标题。
  • 切换方向：切换文本方向。
  • 文本：段落块。

媒体

  • 图片：插入图片。
  • 文章：链接文章。

导航

  • 链接：添加链接。
  • 按钮：添加按钮。
  • 预约：添加特定预约。
  • 日历：安排预约。

小部件

  • 3 星：插入三颗星的评分。
  • 5 星：插入五星评分。

基础块

  • 签名：插入签名。

营销工具

  • 动态占位符：插入个性化内容。

:::: tip
::: title
提示
:::
使用这些选项时，只需在 Powerbox 下拉菜单中点击所需功能。若要对已有文本使用文本相关选项（如 标题 1、切换方向 等），先选中该文本，然后输入激活键 /，再从下拉菜单中选择对应选项。
::::

{.align-center}

::: seealso
使用动态占位符 <email_template/dynamic-placeholders>
:::

要访问邮件模板的 XML/HTML 编辑器，首先进入 开发者模式 (developer mode <developer-mode>)。然后点击模板右上角的 </> 图标，即可编辑 XML/HTML。若想返回标准文本编辑器，再次点击 </> 图标即可。

{.align-center}

:::: warning
::: title
警告
:::
XML/HTML 编辑器属于模板的后台代码，操作需谨慎。错误的编辑可能导致模板立即失效或在数据库升级时出现问题。
::::

动态占位符 引用 Odoo 数据库中的特定字段，以在邮件模板中生成唯一数据。

::: example
许多公司喜欢在邮件中加入个性化的客户信息以吸引注意力。可以在 Odoo 中通过插入动态占位符来引用模型中的字段。例如，在 销售订单 模型的 客户 字段中，可使用占位符 {{ object.partner_id }} 来引用客户姓名。
:::

动态占位符会被编码为显示数据库中的字段值。它们可用于邮件模板的 正文（Content 选项卡）、邮件配置 选项卡中的各字段、邮件的 主题 以及 语言。

在正文中使用动态占位符的步骤：

  1. 在 Content 选项卡的正文中输入 /，打开 Powerbox。
  2. 滚动到选项列表底部的 营销工具，选择 动态占位符。
  3. 从可用列表中选择所需占位符，并按提示配置对应的 Odoo 字段。不同占位符的配置方式各异。

{.align-center}

:::: note
::: title
注意
:::
每一种 字段、子模型 与 子字段 的组合都会产生不同的动态占位符。可以将其视为对字段的组合引用。
::::

要搜索可用字段，只需在前端名称（用户界面上显示的名称）中输入，即可在模型的所有可用字段中找到匹配项。

:::: warning
::: title
警告
:::
定制邮件模板不在 Odoo 官方支持范围内。
::::

选中模板中的文本后，会出现富文本编辑器工具栏。可用于更改标题、字体大小/样式、颜色、列表类型或添加链接。

{.align-center}

如果因为代码被修改导致模板失效，可点击屏幕左上角的 重置模板 按钮，将模板恢复为出厂默认状态。

{.align-center}

在 邮件配置 选项卡下，有一个 回复至（Reply To）字段。该字段用于在使用该模板批量发送邮件时，将回复重定向到指定的电子邮箱地址。

:::: tip
::: title
提示
:::
在多个邮箱地址之间使用逗号 , 分隔，或使用动态占位符。
::::

回复至 字段仅在群发邮件（批量发送）时生效。几乎所有 Odoo 应用的列表视图都支持群发邮件。

在列表视图中，勾选希望发送邮件的记录，点击 操作（⚙️）按钮，选择相应的邮件选项，即可弹出邮件编辑窗口，进行自定义。

{.align-center}

在 Odoo 中，多种事件会触发自动发送邮件，这类邮件称为 事务邮件，有时会包含指向 Odoo 数据库的链接。

默认情况下，数据库生成的链接使用系统参数中定义的动态键 [web.base.url]。详见 系统参数 <domain-name/web-base-url>。

如果未安装 网站 应用，则 [web.base.url] 键始终是生成所有链接的默认参数。

:::: important
::: title
重要
:::
[web.base.url] 只能有单一值，这意味着在多站点或多公司环境中，即使每个站点都有独立域名，事务邮件或文档共享链接仍可能统一使用同一个域名。
::::

::: example
若系统参数 web.base.url 的值为 https://www.mycompany.com，而 Odoo 中有两个公司分别使用 https://www.mycompany2.com 与 https://www.mycompany1.com，则无论是哪家公司发送文档或邮件，生成的共享链接均为 https://www.mycompany.com。
:::

部分 Odoo 应用（如 电子商务）在数据库中已与 网站 应用关联，此时若为站点定义了特定域名，事务邮件中生成的 URL 将使用对应站点的域名。

::: example
客户在 Odoo 电子商务站点完成购买后，订单确认邮件中的链接会使用该站点的域名。
:::

:::: note
::: title
注意
:::
使用 文档 应用共享的文档始终使用 [web.base.url] 键，因为文档并未关联特定网站，无论从哪家公司共享，URL 都保持一致。这是已知限制。
::::

有关域名配置的更多信息，请参阅 域名文档 </applications/websites/website/configuration/domain_names>。

Odoo 会自动为数据库中已安装的所有语言翻译邮件模板。通常不需要手动更改翻译。但若因特定原因必须修改，可按以下步骤操作。

:::: warning
::: title
警告
:::
如同任何代码修改，若翻译修改不当（例如语法错误），可能导致模板破损，显示为空白。
::::

  1. 进入 开发者模式。
  2. 在邮件模板上点击 编辑 按钮，然后点击语言按钮（当前语言的缩写，如 EN 表示英文）。

{.align-center}

:::: note
::: title
注意
:::
如果数据库未安装多语言或用户没有管理权限，语言按钮将不会出现。
::::

弹出窗口会列出数据库中已安装的语言，可在此进行翻译编辑。完成后点击 保存。

{.align-center}

:::: note
::: title
注意
:::
编辑时，数据库默认语言会以 粗体 显示。
::::

[SUMMARY]

  • 邮件模板
    • 概述
    • 访问路径（设置 → 技术 → 邮件 → 邮件模板）
    • 编辑方式
      • Powerbox 功能
        • 结构（项目符号、编号、检查清单、表格、分隔线、引用、代码、列布局）
        • 格式（标题 1/2/3、切换方向、文本）
        • 媒体（图片、文章）
        • 导航（链接、按钮、预约、日历）
        • 小部件（3 星、5 星）
        • 基础块（签名）
        • 营销工具（动态占位符）
      • XML/HTML 代码编辑器
      • 动态占位符
      • 富文本编辑器
      • 重置模板
      • 回复设置（Reply To）
    • 事务邮件与链接
      • web.base.url 参数
      • 多站点/多公司注意事项
      • 电商站点的域名使用
    • 翻译更新
      • 进入开发者模式 → 编辑 → 语言按钮 → 修改并保存