README

此包提供了一种简单的方法将MailChimp与Statamic表单和用户注册集成。

要求

• PHP 8.2+
• Statamic v5

安装

您可以通过以下方式使用composer安装此包：

composer require statamic-rad-pack/mailchimp

此包将自动注册自身。

配置

在您的.env文件中设置您的Mailchimp API密钥。您可以从https://admin.mailchimp.com/account/api-key-popup/获取它并创建一个新的密钥。

MAILCHIMP_API_KEY=your-key-here

在控制面板中配置Mailchimp

使用方法

按照常规方式创建您的Statamic 表单。当编辑表单时，您将看到一个“Mailchimp集成”部分，其中可以配置该表单是否以及如何与您的Mailchimp账户集成。

别忘了将同意字段添加到您的蓝图。

您还可以通过控制面板中专门的设置视图管理是否将新用户添加到列表。

兴趣

为了将它们添加到您的表单，您需要知道兴趣的id。

<div class="form-group">
    <label>Interests</label>
    <input type="checkbox" name="interests[]" value="4e4b2bc6ae" class="form-control"/>
    <input type="checkbox" name="interests[]" value="3e1e51dbae" class="form-control"/>
    <input type="checkbox" name="interests[]" value="f79652f791" class="form-control"/>
</div>

要获取这些ID，首先运行php artisan mailchimp:groups your_form_handle以获取组ID。然后运行php artisan mailchimp:interests your_form_handle the_group_id以获取兴趣及其ID的列表。使用这些ID在您的模板中（如上例所示）。

您的表单蓝图中的兴趣字段最终应看起来像这样（假设您使用默认的interests作为字段的处理程序）

-
  handle: interests
  field:
    options:
      e25a8f41d6: 'Interest group 1'
      cd1g2413a2: 'Interest group 2'
      1b1a842842: 'Interest group 3'
    type: checkboxes

营销许可

为了与Mailchimp的营销许可一起工作，您需要做几件事情

1. 通过为Mailchimp中的每个表单运行php artisan mailchimp:permissions {form-handle}来获取每个表单的权限和ID。例如，我的看起来像

❯ php please mailchimp:permissions contact_us
+-------------------------------+------------+
| Marketing Permission          | ID         |
+-------------------------------+------------+
| Email                         | 2d904xxxxx |
| Customized Online Advertising | 3560exxxxx |
+-------------------------------+------------+

1. 添加这些Mailchimp配置
2. 添加将具有这些权限的表单字段

.

然后在您的表单中，有如下字段

<div class="form-group">
    <label>GDPR</label>
    <label for=""email>Email</label>
    <input type="checkbox" name="gdpr[email]" value="true" class="form-control"/>
    <label for=""email>Online</label>
    <input type="checkbox" name="gdpr[customized_online_advertising]" value="true" class="form-control"/>
</div>

别忘了在表单的蓝图中将gdpr字段添加进去。

数据存储

默认情况下，任何与用户相关的设置都存储在resources/mailchimp.yaml中。

如果您想更改此或使用不同的数据存储，可以在您的应用程序服务提供者中将\StatamicRadPack\Mailchimp\UserConfig::class绑定。您应根据要求修改getSavedSettings、save和exists方法。

测试

使用以下命令运行测试：

vendor/bin/phpunit

更改日志

请参阅CHANGELOG以获取有关最近更改的更多信息。

贡献

请参阅CONTRIBUTING获取详细信息。

安全

请参阅SECURITY获取详细信息。