SparkPost 邮件传输 4.0.1

添加一个SparkPost邮件传输选项，以便所有邮件通过它发送。SparkPost这个插件支持使用SparkPost Events API处理全 bounce 和已退订邮件，无需邮箱。设置如果你还没有设置，请在SparkPost账户中配置论坛的发送域名。建议你同时设置默认 bounce 域名。
然后你需要创建一个具有以下权限的API密钥：

• [][*消息事件：只读[]传输：读写[]*注意，当前版本要求您允许使用SMTP API的权限，但这是**不是要求 – 这些说明将在未来的发布中删除。

一旦您获得了API密钥，更改电子邮件选项页面中的邮件传输方法为“SparkPost”，并将您的API密钥粘贴到提供的框中。配置有几种选项可以在SparkPost Mail中配置邮件发送和事件处理。

• []]*点击跟踪开启所有发送的邮件中的链接点击跟踪功能[]]*开放跟踪在所有发送的包含跟踪图像的邮件中添加打开追踪图像[]]*消息事件批量大小允许你配置系统在每次批次中将尝试检索的事件数量。一般来说，你不应该调整为默认值。[]]*测试模式将'.sink.sparkpostmail.com'附加到所有收件人电子邮件地址中，以便我们在不实际向收件人发送任何邮件的情况下测试与SparkPost的通信。

建议您在启用点击或打开跟踪前设置自定义追踪域名。测试使用内置的XenForo邮件测试系统可以测试插件功能 - 转到管理界面 > 工具 > 测试外发邮件
注意，邮件传输类应为\SwiftSparkPost\Transport - 如果不是，请确保未正确安装或激活插件。
还有一个用于指定发送事务性或非事务性邮件的测试设施。 转到管理界面 > 工具 > 测试SparkPost
启用发送事务性邮件的复选框 - 禁用以发送非事务性邮件。
在所有情况下，您都应检查收到的邮件头以验证是否确实通过SparkPost发送，并验证List-Unsubscribe标头的存在/不存在。交易型邮件 vs 非交易型邮件交易型电子邮件是系统发送的自动化邮件，用于与客户的账户或网站使用相关的信息进行沟通。它们通常针对特定的个人用户，并且对用户的持续使用网站非常重要。
交易性邮件的例子包括：

• []账户创建和激活邮件[]密码重置和两步验证[]安全和账户警报[]用户选择的订阅或警报选项导致的通知[]购买收据和发货通知[]*]法律和重要站点通知

非交易性电子邮件（也称为商业邮件）通常会批量发送给一组用户，虽然它们可能也会包含个性化的内容，其中包含促销或营销材料。只有选择接收此类信息的用户才会收到它们。
非交易性邮件的例子包括：

• []*]新闻邮件*][]*[销售优惠[]*[新產品更新[]*]设计用于增加用户参与和上手体验的电子邮件

SparkPost网站上有更多关于的信息。Transactional vs CommercialSparkPost默认将通过其API发送的所有邮件标记为“非交易性”。此插件改变了这种行为，并将论坛邮件设置为交易性，除了：

• []管理员UI发送的邮件 - 通信 > 邮件用户[]*]欢迎邮件

Transactional邮件和非交易性邮件通过SparkPost发送存在两个显著差异：

1. []非交易邮件添加List-Unsubscribe头信息（覆盖XenForo添加的头信息）以供某些电子邮件客户端一键取消订阅。交易邮件不包含此头信息。[]*]有分别的抑制列表用于交易性和非交易性邮件。如果有人取消订阅了非交易性邮件，你仍然可以给他们发送重要的交易性邮件，如论坛订阅和密码重置。然而，如果有人取消订阅或阻止了你发送交易性邮件，你应该禁用他们的账户，因为你将不再能够向他们发送关于重要论坛信息的邮件。

下面是关于屏蔽列表的更多信息。bounce和 unsubscribe处理自动回复和退订处理插件将检查所有可能因发送邮件而收到的标准硬软退信。这些退信由SparkPost拦截，我们可以执行查询以确定我们需要采取什么行动。
你不需要配置“退信电子邮件地址”（除非没有设置默认退信域名）或“退订电子邮件地址”在你的邮件选项中。也不需要启用“自动电子邮件处理器”或“启用自动电子邮件处理器”选项 - SparkPost 不会通过电子邮件转发退信通知和退订通知，而是查询其API以获取 bounce / unsubscribe 信息。
退订处理比标准的XenForo系统更复杂一些 - 因为我们区分了交易性和非交易性邮件，并且分别处理它们。
请注意，如果收到交易性邮件的硬退信，用户的账户将被禁用以防止进一步发送邮件。抑制列表当SparkPost收到发送邮件的硬退件或List-Unsubscribe请求时，它会将该电子邮件地址添加到屏蔽列表中，这意味着你不能再向该用户发送邮件。这是为了保护你的发送声誉——继续向无效或已取消订阅的地址发送邮件是一个垃圾邮件指标，可能会导致你在某些邮件服务商被封锁。
需要注意的是，如果用户的论坛账户因退件而被禁用，他们也很可能已被SparkPost添加到屏蔽列表中。如果你重新启用他们的账户而不更改电子邮件地址，则他们可能不会从你的网站收到任何邮件，因为SparkPost会阻止向他们发送邮件。https://app.sparkpost.com/lists/suppressions记住，有两个分开的列表——一个是交易邮件列表，另一个是非交易邮件列表。