使用 Ad Inserter 实现多语言、多系列文章的精准 CTA 插入

在运营一个中英文双语的技术博客时，我遇到了一个不算复杂但有点繁琐的需求：

• 在普通文章（非 VPN 系列）的末尾，根据文章语言，分别显示中文版或英文版的通用联系方式 CTA。
• 而在 VPN 系列文章（包括中英文）中，不显示通用 CTA，而是显示专属的“WireGuard VPN 代搭建服务”广告（Block 1 和 Block 2）。
• 未来可能还会新增其他系列或语言，希望配置能尽量清晰、易于扩展。

经过一番折腾，最终通过 Ad Inserter 免费版 的黑名单功能，配合 Polylang 的语言代码，完美实现了需求。下面是完整的配置思路和步骤，供有类似需求的朋友参考。

一、整体逻辑

我的文章按系列分为两类：

• VPN 系列：中英文两个系列，分别使用自定义分类法 series: self-hosted-vpn（中文）和 series: self-hosted-vpn-en（英文）。这些文章需要显示专属的 VPN 代搭建 CTA（Block 1 和 Block 2）。
• 普通文章：不属于上述系列。这些文章需要根据当前语言显示对应的通用 CTA。

为了实现“普通文章显示通用 CTA，VPN 文章不显示通用 CTA”，最直接的办法是在通用 CTA 的 Block 中，黑名单里排除 VPN 系列的所有文章。
同时，由于有两种语言，我需要两个通用 CTA Block：

• Block 3：中文通用 CTA（只显示在普通中文文章中）
• Block 4：英文通用 CTA（只显示在普通英文文章中）

二、关键点：如何区分语言？

我的博客使用 Polylang 插件管理多语言。Polylang 会在每个文章页面添加一个语言相关的 class，并且可以通过 wpml-current-language 这个参数来识别当前语言（兼容 WPML 的写法）。
在 Ad Inserter 的“黑白名单”中，我们可以直接使用这个参数：

• 中文页面：wpml-current-language: zh
• 英文页面：wpml-current-language: en

三、精简后的具体配置步骤

原理：wpml-current-language: en 已经排除了所有英文文章（包括英文 VPN 系列），因此无需再单独排除 series: self-hosted-vpn-en。同理，wpml-current-language: zh 排除了所有中文文章，也就不再需要排除 series: self-hosted-vpn。两个通用 Block 的黑名单只需各两个条件，简洁且无冗余。

1. 准备两个通用 CTA Block

Block 3 – 中文通用 CTA

核心设置：

• 插入位置：After post
• 黑名单（Blacklist）：
• wpml-current-language: en → 排除所有英文文章
• series: self-hosted-vpn → 排除中文 VPN 系列

这样，Block 3 只会在语言为中文、且不属于中文 VPN 系列的文章中显示。

Block 4 – 英文通用 CTA

核心设置：

• 插入位置：After post
• 黑名单：
• wpml-current-language: zh → 排除所有中文文章
• series: self-hosted-vpn-en → 排除英文 VPN 系列

同理，Block 4 只会在语言为英文、且不属于英文 VPN 系列的文章中显示。

2. VPN 系列专属 Block（Block 1 和 Block 2）保持不变

• Block 1：白名单 series: self-hosted-vpn，插入位置 After post。
• Block 2：白名单 series: self-hosted-vpn-en，插入位置 After post。

这两个 Block 没有设置黑名单，因此只要满足系列条件就会显示。而由于通用 Block 已经通过黑名单排除了这些系列，所以不会出现重复插入。

四、效果验证

配置完成后，我们来看实际页面效果。

1. VPN 系列文章（应显示专属 CTA，不显示通用 CTA）

• 中文 VPN 文章：
  可以看到文章末尾出现了“拒绝折腾 | 专属 WireGuard VPN 代搭建服务”，没有通用联系方式。
• 英文 VPN 文章：
  显示英文版专属 CTA（“Stop the Hassle | Custom WireGuard VPN Setup Service”），通用 CTA 未出现。

2. 普通文章（应显示对应语言的通用 CTA）

• 普通中文文章：
  末尾正确显示中文通用联系方式（包含服务列表、微信、邮箱等）。
• 普通英文文章：
  末尾正确显示英文通用联系方式。

五、扩展性与维护提示

这套方案的设计原则是：黑名单只用于通用 CTA 的 Block，专属系列只需要在自己的 Block 里使用白名单。

• 新增专属系列时：
  创建一个新的专属 Block，设置白名单为该系列（例如 series: docker-tutorial），插入位置与通用 Block 相同。
  同时，需要将该系列添加到每一个通用 CTA Block（Block 3、Block 4 以及未来新增的其他语言通用 Block）的黑名单中。
• 如果新系列属于中文语言，则只需添加到中文通用 Block（Block 3）的黑名单；
• 如果中英文语言都有，则两个通用 Block 都要添加。
  这个操作只需在通用 Block 的黑名单文本框中追加一个系列名（例如 , series: docker-tutorial），几秒钟即可完成。
• 新增语言时：
  新建一个对应语言的通用 Block，其黑名单中需排除所有其他语言（例如 wpml-current-language: zh, en）以及所有专属系列。
  同时，所有已有的通用 Block 也需要将新语言条件加入黑名单（例如在 Block 3 的黑名单中增加 wpml-current-language: ja）。

虽然不能做到“一次配置，永远不管”，但所有维护工作都在黑白名单的一个文本框内完成，逻辑清晰，成本很低。

六、总结

通过 Ad Inserter 免费版的黑名单功能，结合 Polylang 的语言参数，我们可以轻松实现：
✅ 不同语言显示不同的 CTA
✅ 特定系列文章自动替换为专属 CTA
✅ 完全避免多个 Block 同时插入的冗余问题
✅ 配置简洁（每个通用 Block 仅需两个黑名单条件起步，后续按需追加）

如果你也在运营多语言 WordPress 站点，并且需要精细化控制每篇文章末尾的广告或服务信息，希望这篇记录对你有用。

附：文中使用的 Ad Inserter 版本为最新免费版（2.7.x），Polylang 版本 3.5+。黑白名单的语法为 分类法:值，多个条件用英文逗号分隔。

---

有任何疑问或更好的方案，欢迎留言讨论。