wieni / wmsubscription
为Drupal 8提供管理电子邮件营销平台订阅的通用接口
Requires
- php: >=7.1.0
- drupal/core: ^8.5 || ^9.0
Requires (Dev)
- ergebnis/composer-normalize: ^2.0
- wieni/wmcodestyle: ^1.1
This package is auto-updated.
Last update: 2024-09-15 10:42:07 UTC
README
为管理电子邮件营销平台订阅提供通用接口。
为什么?
- 轻松创建定制的新letter订阅表单,无需样板代码
- 平台无关的API,使得在不同提供商之间轻松切换,并在项目之间共享更多代码成为可能。
安装
此包需要PHP 7.1和Drupal 8或更高版本。可以使用Composer安装。
composer require wieni/wmsubscription
它是如何工作的?
选择提供商
除了核心包外,您还需要安装一个提供商模块
wmsubscription_mailchimp
,提供MailChimp实现wmsubscription_campaignmonitor
,提供Campaign Monitor实现
安装提供商模块后,更改wmsubscription.settings
配置中的tool
键。
选择直接或队列订阅
在调用外部API时,通常将操作排队是个好主意,以防连接问题,不会丢失任何操作。
默认情况下,在调用SubscriptionToolInterface::addSubscriber
后立即处理订阅。可以通过将manager
键设置为wmsubscription.manager.queued
来更改此行为。操作将被添加到队列中,因此请确保cron定期执行。
为了确保访问者在之前的操作仍在队列中时无法订阅相同的电子邮件地址,此模块提供了一个自定义队列数据库实现,用于检查重复项。要启用自定义实现,将以下代码片段添加到您的settings.php
中:
$settings['queue_service_wmsubscription_subscriptions'] = 'wmsubscription.queue.unique_subscription';
死信队列集成
此模块提供了一个子模块,可以与Dead Letter Queue模块的功能相结合,用于独特的订阅队列:wmsubscription_dead_letter_queue
。
要启用此功能,请在您的settings.php
中使用以下代码片段代替上述代码:
$settings['queue_service_wmsubscription_subscriptions'] = 'wmsubscription_dead_letter_queue.queue.database';
要添加对Dead Letter Queue UI模块的支持,请启用wmsubscription_dead_letter_queue_ui
模块。
变更日志
此项目的所有重大更改都将记录在CHANGELOG文件中。
安全
如果您发现任何安全相关的问题,请通过电子邮件security@wieni.be报告,而不是使用问题跟踪器。
许可证
在MIT许可证下分发。有关更多信息,请参阅LICENSE文件。