|||
| 摘要 | Discourse Newsletter Integration 为您的实例添加了可自定义的邮件列表订阅服务。
| 代码库链接 | https://github.com/discourse/discourse-newsletter-integration
| 安装指南 | 如何在 Discourse 中安装插件
功能 
管理员可以配置一个全局邮件列表，该列表将与邮件列表提供商中的一个邮件列表同步。
用户可以从站点横幅订阅邮件列表
横幅关闭后，用户将不会再次看到它。
用户偏好设置页面（/my/preferences/emails）中会添加一个复选框，允许用户随时更改其邮件列表订阅。
当用户订阅或取消订阅时，通过 API 将订阅者添加到邮件列表提供商的链接邮件列表中或从中删除。
该插件在 Discourse 和邮件列表提供商之间同步订阅状态。
目前，该插件支持 Mailchimp 作为邮件列表提供商，并且只支持一个全局邮件列表供所有用户使用。未来版本计划支持其他提供商和仅限于组的邮件列表。
配置指南
要启用该插件，您可以使用 /admin/plugins 页面上的切换开关，或通过勾选 discourse newsletter integration enabled 管理员设置。您也可以从此页面访问插件的设置：
自定义横幅和用户设置中的文本
用户将看到一个关于邮件列表的横幅，允许他们订阅或关闭它。此横幅可以自定义以更好地满足您论坛的需求，并且只有在配置了所有与插件相关的设置后才会显示。关闭后，用户将不会再次看到它，但可以选择从其偏好设置页面进行订阅。
您可以从管理面板自定义订阅横幅文本。以下是横幅中可自定义的标签：
js.discourse_newsletter_integration.banner.headingjs.discourse_newsletter_integration.banner.descriptionjs.discourse_newsletter_integration.banner.subscribe
js.discourse_newsletter_integration.banner.manage_preferencesjs.discourse_newsletter_integration.banner.thank_youjs.discourse_newsletter_integration.banner.added_to_newsletter
您还可以自定义用户在其偏好设置页面上看到的邮件列表名称：
js.discourse_newsletter_integration.preferences.section_headjs.discourse_newsletter_integration.preferences.checkbox_description
Mailchimp 集成
有三个 Discourse 站点设置与 Mailchimp 集成相关：
| 名称 | 描述 |
|---|---|
| discourse newsletter integration mailchimp api key | 您 Mailchimp 帐户的 API 密钥。 |
| discourse newsletter integration mailchimp list id | 您要与 Discourse 同步的 Mailchimp Audience 的 ID。 |
| discourse newsletter integration mailchimp server prefix | 您登录 Mailchimp 帐户时看到的 URL 的子域名部分，例如 us14 和 us19。 |
discourse newsletter integration mailchimp api key
要生成 API 密钥，请按照以下步骤操作：
- 导航到您帐户的 API Keys 部分。
- 点击 Create New Key。
- 为您的密钥命名。
- 点击 Generate Key。
- 点击 Copy Key to Clipboard。将您的密钥保存在安全的地方。
- 点击 Done。
discourse newsletter integration mailchimp list id
每个 Mailchimp Audience 都有一个唯一的 Audience ID（有时称为 List ID），集成、插件和小部件可能需要它来连接和传输订阅者数据。Audience ID 由 Mailchimp 的系统在创建 Audience 时生成，并且无法更改。
要查找您的 Audience ID，请按照以下步骤操作：
- 导航到 Audience
- 选择您想要的 Audience
- 点击 Settings 下拉菜单并选择 Audience name and defaults。
- 在 Audience ID 部分，您将看到一串字母和数字。这就是您的 Audience ID。
discourse newsletter integration mailchimp server prefix
登录您的 Mailchimp 帐户并查看浏览器中的 URL。您会看到类似 https://us19.admin.mailchimp.com/ 的内容；us19 部分就是服务器前缀。请注意，您的具体值可能有所不同。
已知问题
此插件具有基本功能，运行良好，但这里有一些我们将在未来处理的已知问题：
更改 Mailchimp 帐户
在设置 Mailchimp 集成并为邮件列表建立 Audience 后，如果您更改为新帐户（通过站点设置），Audience 将不会与新帐户同步。
由我们托管？此插件在我们的 Enterprise 计划中可用。
