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/](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. 通过运行 php artisan mailchimp:permissions {form-handle} 为 Mailchimp 中的每个表单获取您的权限和 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 了解详细信息。

安全

请参阅安全文档以获取详细信息。