如何使用listmonk邮件模板条件逻辑：从基础到高级场景实现

listmonk是一款高性能、自托管的新闻通讯和邮件列表管理工具，提供现代化的仪表板和强大的邮件模板系统。本文将详细介绍如何利用listmonk的模板条件逻辑功能，创建动态且个性化的邮件内容，满足复杂的营销场景需求。## 为什么需要邮件模板条件逻辑？在邮件营销中，不同的订阅者群体往往需要接收个性化的内容。例如：- 向新订阅者发送欢迎邮件- 根据用户所在地区展示不同的促销信息- 为付费

gitblog_00016

346人浏览 · 2026-02-02 02:42:53

gitblog_00016 · 2026-02-02 02:42:53 发布

如何使用listmonk邮件模板条件逻辑：从基础到高级场景实现

【免费下载链接】listmonk High performance, self-hosted, newsletter and mailing list manager with a modern dashboard. Single binary app. 项目地址: https://gitcode.com/gh_mirrors/li/listmonk

listmonk是一款高性能、自托管的新闻通讯和邮件列表管理工具，提供现代化的仪表板和强大的邮件模板系统。本文将详细介绍如何利用listmonk的模板条件逻辑功能，创建动态且个性化的邮件内容，满足复杂的营销场景需求。

为什么需要邮件模板条件逻辑？

在邮件营销中，不同的订阅者群体往往需要接收个性化的内容。例如：

向新订阅者发送欢迎邮件
根据用户所在地区展示不同的促销信息
为付费用户提供专属内容
根据用户兴趣定制邮件内容

listmonk的模板系统支持条件判断和循环等高级功能，让你能够轻松实现这些需求，提升邮件营销效果和用户体验。

图：listmonk提供直观的模板编辑界面，支持条件逻辑和动态内容

基础条件判断：if语句的应用

listmonk使用Go模板语法，最基础的条件逻辑是if语句。以下是一个简单示例，用于判断订阅者是否提供了姓氏：

<h1>Hello {{ .Subscriber.Name }} {{ if .Subscriber.LastName }}{{ .Subscriber.LastName }}{{ end }}!</h1>

在static/email-templates/default-visual.tpl文件中，你可以看到类似的用法：

<h3 style="font-weight:bold;margin:0;font-size:20px;padding:16px 24px 16px 24px">
  Hello {{ .Subscriber.Name }}
</h3>
<div style="font-weight:normal;padding:16px 24px 16px 24px">
  <p>
    This is a test e-mail campaign. Your second name is {{ .Subscriber.LastName }} and this block of text is in Markdown.
  </p>

带else的条件判断

你还可以添加else子句来处理不同情况：

{{ if .Subscriber.Country }}
  <p>Special offers for {{ .Subscriber.Country }} subscribers!</p>
{{ else }}
  <p>Welcome to our newsletter!</p>
{{ end }}

循环遍历：range语句的使用

当你需要处理列表数据时，range语句非常有用。在static/email-templates/subscriber-optin.html文件中，listmonk使用range来显示订阅者加入的列表：

<ul>
  {{ range $i, $l := .Lists }}
    {{ if eq .Type "public" }}
      <li>{{ .Name }}</li>
    {{ else }}
      <li>{{ L.Ts "email.optin.privateList" }}</li>
    {{ end }}
  {{ end }}
</ul>

这段代码会遍历所有列表，并根据列表类型显示不同内容：

如果是公共列表，显示列表名称
如果是私有列表，显示"Private list"文本

循环中的索引和条件

你还可以在循环中使用索引和条件组合，实现更复杂的逻辑：

{{ range $index, $item := .Products }}
  {{ if lt $index 3 }}
    <div class="product-item">
      <h4>{{ $item.Name }}</h4>
      <p>{{ $item.Description }}</p>
    </div>
  {{ end }}
{{ end }}

这段代码只会显示前3个产品，非常适合在邮件中展示精选商品。

图：使用条件逻辑前，需要先设置正确的订阅者查询条件

复杂场景实现：多条件组合

在实际应用中，你可能需要组合多个条件来实现复杂的业务逻辑。以下是一些常见的高级场景：

根据订阅时长显示不同内容

{{ if .Subscriber.JoinedAt }}
  {{ $daysSinceJoin := .Now.Sub .Subscriber.JoinedAt | days }}
  {{ if gt $daysSinceJoin 30 }}
    <p>Thanks for being with us for over a month!</p>
    <p>As a token of appreciation, here's a 20% discount code: LONGTERM20</p>
  {{ else if gt $daysSinceJoin 7 }}
    <p>Welcome to our community! We're glad to have you with us for a week.</p>
  {{ else }}
    <p>Welcome! Here's a special welcome offer just for you: WELCOME10</p>
  {{ end }}
{{ end }}

根据用户兴趣定制内容

{{ if .Subscriber.Tags }}
  <h3>Recommended for you</h3>
  <ul>
    {{ range .Subscriber.Tags }}
      {{ if eq . "technology" }}
        <li>Check out our latest tech articles</li>
      {{ else if eq . "design" }}
        <li>New design resources available now</li>
      {{ else if eq . "marketing" }}
        <li>Marketing tips for this month</li>
      {{ end }}
    {{ end }}
  </ul>
{{ end }}