Discourse 新闻通讯集成

[Discourse]

	摘要	Discourse Newsletter Integration 为你的实例添加可定制的通讯订阅服务。
	仓库链接	https://github.com/discourse/discourse-newsletter-integration
	安装指南	如何在 Discourse 中安装插件

由于这是由 Discourse 团队维护的 #官方插件，因此可以在 Meta 上的相应类别中提出 #支持、#贡献:bug、#贡献:ux 和 #贡献:feature 请求，并标记适当的插件标签。点击下面的链接开始提问。

 支持  Bug  UX  功能

功能

• 管理员可以配置一个全局通讯，该通讯将与通讯提供商中的邮件列表同步。
• 用户可以从网站横幅订阅通讯
  • 一旦横幅被关闭，它将不再出现在该用户面前。
• 在用户偏好设置页面 (/my/preferences/emails) 添加了一个复选框，允许用户随时更改其通讯订阅状态。
• 当用户订阅或退订时，通过其 API 将订阅者添加到或从通讯提供商的链接邮件列表中移除。
• 该插件同步 Discourse 和通讯提供商之间的订阅状态。
• 目前，该插件支持 Mailchimp 作为通讯提供商，并且仅支持面向所有用户的一个全局通讯。未来版本计划支持更多提供商和仅限特定组的通讯。

配置指南

要启用该插件，你可以使用 /admin/plugins 页面上的切换开关，或者勾选 discourse newsletter integration enabled 管理员设置。你也可以从该页面访问插件的设置：

自定义横幅和用户设置中的文本

用户将看到关于通讯的横幅，允许他们订阅或关闭它。此横幅可以根据论坛的需求进行定制，并且只有在所有与插件相关的设置都配置好后才会显示。一旦关闭，用户将不再看到它，但可以从他们的偏好设置页面选择订阅。

你可以从管理面板自定义订阅横幅文本。以下是横幅的可定制标签：

• js.discourse_newsletter_integration.banner.heading
• js.discourse_newsletter_integration.banner.description
• js.discourse_newsletter_integration.banner.subscribe

• js.discourse_newsletter_integration.banner.manage_preferences
• js.discourse_newsletter_integration.banner.thank_you
• js.discourse_newsletter_integration.banner.added_to_newsletter

你还可以自定义每个用户在他们的偏好设置页面上看到的通讯名称：

• js.discourse_newsletter_integration.preferences.section_head
• js.discourse_newsletter_integration.preferences.checkbox_description

Mailchimp 集成

有三个与 Mailchimp 集成相关的 Discourse 站点设置：

名称	描述
discourse newsletter integration mailchimp api key	你的 Mailchimp 账户的 API 密钥。
discourse newsletter integration mailchimp list id	你要与 Discourse 同步的 Mailchimp 受众的 ID。
discourse newsletter integration mailchimp server prefix	登录 Mailchimp 账户时看到的 URL 中的子域名部分，例如 us14 和 us19。

discourse newsletter integration mailchimp api key

要生成 API 密钥，请按照以下步骤操作：

1. 导航到账户的 API 密钥 部分。
2. 点击 创建新密钥。
3. 为你的密钥命名。
4. 点击 生成密钥。
5. 点击 复制密钥到剪贴板。将密钥保存在安全的地方。
6. 点击 完成。

关于 API 密钥 | Mailchimp

discourse newsletter integration mailchimp list id

每个 Mailchimp 受众都有一个唯一的受众 ID（有时称为列表 ID），集成、插件和小部件可能需要它来连接和传输订阅者数据。受众 ID 由 Mailchimp 系统在创建受众时生成，且无法更改。

要查找你的受众 ID，请按照以下步骤操作：

1. 导航到 受众
2. 选择你想要的受众
3. 点击 设置 下拉菜单并选择 受众名称和默认值。
4. 在 受众 ID 部分，你会看到一串字母和数字。这就是你的受众 ID。

查找你的受众 ID | Mailchimp

discourse newsletter integration mailchimp server prefix

登录你的 Mailchimp 账户并查看浏览器中的 URL。你会看到类似 https://us19.admin.mailchimp.com/ 的内容；us19 部分是服务器前缀。请注意，你的具体值可能不同。

已知问题

该插件具有基本功能且运行良好，但以下是一些我们将来会处理的问题：

更改 Mailchimp 账户

设置 Mailchimp 集成并建立通讯的受众后，如果更改为新账户（通过站点设置），受众将不会与新账户同步。

由我们托管？该插件在我们的企业计划中可用。

[Jagster (Jakke Flemming)]

它是否可以在没有 Mailchimp 的情况下运行，还是像其他平台上的情况一样，只是 Mailchimp 服务的某种前端？

[nat (Natalie T)]

此插件旨在帮助网站所有者与电子邮件营销提供商合作，以发送更具定制化的品牌信息。

目前插件中仅包含 Mailchimp，因此，此插件不能在没有 Mailchimp 的情况下使用。它会同步选择加入的 Discourse 论坛用户与 Mailchimp 定义的“受众”。

[ked (Kenny DuBose)]

@nat 建议您在不久的将来为 Zoho Campaigns 提供支持。

[jordan-violet]

我注意到的一点是，启用后，横幅直到我使用隐身浏览器登录后才显示出来。

我们有什么办法可以确保它显示给所有之前访问过该网站的现有用户吗？

[JammyDodger]

供参考，在我试用时，它对所有现有测试用户都显示正常。

[Jonathan5]

与Subscriptions插件一样，如果人们可以同时注册新闻通讯和论坛，那就太好了。我猜这只对已注册用户才可能。

[JammyDodger]

我认为在创建账户模态框中包含一个框会很好。不过，他们目前在登录时会看到横幅，这可能更醒目？

[denvergeeks]

@Jagster 我在上面的主题帖子中读到了这个……

目前，该插件支持 Mailchimp 作为新闻通讯提供商，并且只有一个全局新闻通讯供所有用户使用。对其他提供商和仅限于群组的新闻通讯的支持计划在未来的版本中推出。

[nat (Natalie T)]

@jordan-violet

有什么办法能确保所有现有用户都能看到这个吗？

我怀疑这可能只是一个小故障（缓存！）只针对你，因为是你开启了它。

横幅的显示逻辑是固定的（discourse-newsletter-integration/plugin.rb at 3493f2ad3f4631ec02782bffe80463412a4dea51 · discourse/discourse-newsletter-integration · GitHub

[nathank (Nathan Kershaw)]

此插件如何处理已包含许多社区成员的现有受众？

并且，是否有办法使其像“选择退出”而不是“选择加入”那样运行？
我的意思是：

1. 所有注册我们网站的人都会自动添加到受众群体中
2. 横幅提供“选择退出”选项（或者根本不显示）

[maiki]

@Jonathan5

与订阅插件一样，最好能让用户同时注册新闻通讯和论坛。我猜这只对已注册用户可行。

这个建议很不错，因为它简化了流程。

然而，作为一名多年（持续时间）运行邮件列表的人，我更希望在将电子邮件添加到我的列表之前，至少进行一个级别的账户验证。这会随着时间的推移提供更多价值，并减少随之而来的工作量。

如果我们能在注册时提供此选项，我仍然希望先等待他们登录。

[Jonathan5]

是的，您（和现在一样）将需要电子邮件验证才能成为 Discourse 会员，并在开始 Discourse 会员时开始邮件列表会员资格。

[Jagster (Jakke Flemming)]

这在西方国家仍然是某种法律行动吗？

[nathank (Nathan Kershaw)]

当然可以，如果明确表示加入网站的同时也会注册订阅新闻通讯。\n\n这实际上与以下内容是同一个请求：\n[quote="Jonathan5, post:8, topic:275509"]\n如果人们可以同时注册订阅新闻通讯和论坛就好了。\n[/quote]

[RGJ (Richard - Communiteq)]

@nathank

当然可以，如果明确表示您在注册本网站的同时也会订阅新闻通讯。

这是不正确的。@Jagster说得对，这在欧盟是不合法的。
荷兰电信法要求用户就新闻通讯给予明确和单独的许可，而GDPR对于论坛和新闻通讯的处理有不同的依据。论坛可以被视为合同的履行，而新闻通讯则需要明确同意。

所以您至少需要一个单独的复选框。如果我没记错的话，荷兰有判例法规定复选框默认需要是未勾选状态。

说了这么多，这个插件太棒了！

[Jonathan5]

我认为你也同意。根据你关于明确和单独同意的说法，可以强制要求勾选最初未勾选的电子邮件列表同意框，以便用户加入论坛。

[Jagster (Jakke Flemming)]

@RGJ

荷兰的判例法

这适用于整个欧盟。选择退出是非法的。

而且……无论如何，这在任何地方都应该是大忌，因为它只是一种糟糕的方式，强迫用户接收他们没有要求的东西。但嘿，这对营销有利，用户可以随时删除或将此类新闻通讯（又名营销线索）标记为垃圾邮件😜

好了，我要离题了，所以我就从这个分支退出了。但如果我没记错的话，Mailchimp 强烈反对选择退出。

[Jonathan5]

我应该补充一点，在我最初提出请求时，我想到的是在 Discourse 注册页面上添加一个可选的、未勾选的复选框，用于注册电子邮件列表。我认为这将符合欧盟 GDPR 和全球良好实践的任何合理解释。

[nathank (Nathan Kershaw)]

@RGJ

荷兰电信法要求用户为新闻通讯提供明确且单独的许可，

幸运的是，我不住在荷兰（嗯，至少目前不住）。有些“西方”国家不受欧盟法律管辖。

这是否包括活动摘要？这完全取决于“新闻通讯”的定义是什么，以及实际发送的电子邮件在光谱中的位置。

另外，如果有一个专门的类别，并且默认对所有用户设置为“关注”，那会怎么样？如果从宽松的解释来看，这也可以被视为新闻通讯。

话虽如此，我非常确定我们都同意，在未经用户同意的情况下向用户发送电子信息是绝对糟糕的（而且通常是非法的）。世界各地的法律在确切的可接受点上有所不同。