README

The Craft CMS Mailchimp Sync plugin allows you to send email addresses collected via a newsletter subscribe form on your Craft CMS website to your Mailchimp audience.

安装

1. 通过Craft CMS控制面板或命令行安装插件

   composer require datastone/craft-mailchimp-sync

   ./craft plugin/install datastone-mailchimp-sync

2. 在Craft CMS控制面板中转到“设置 → 插件 → Datastone mailchimp 同步”以配置插件。

   • 配置Mailchimp API密钥：在使用插件之前，您需要配置您的Mailchimp API密钥：https://mailchimp.com/developer/marketing/guides/quick-start/

     确保API密钥以mailchimp服务器结尾，例如：us3。在提供的字段中输入您的Mailchimp API密钥并保存设置。

   • 创建Mailchimp受众：为了收集电子邮件地址并将它们发送到Mailchimp，您需要创建一个Mailchimp受众（列表）并配置插件以使用它：https://mailchimp.com/help/find-audience-id/

3. 现在您可以在网站上添加一个收集电子邮件地址的订阅表单。当用户通过此表单提交他们的电子邮件地址时，插件会将电子邮件地址发送到您配置的Mailchimp受众。

<form method="post" target="_self">
    {{ actionInput('datastone-mailchimp-sync/news-letter/subscribe') }} 
    {{ csrfInput() }}
    <input type="email" name="email" placeholder="E-mailadres" required>
    <button type="submit">Subscribe</button>
</form>

对于Craft Commerce，您还可以在用户保存用户表单上添加一个注册新闻通讯复选框，其值为'checked'，以便通过队列发送电子邮件到Mailchimp。

翻译

您可以通过以下步骤翻译闪存消息

1. 在Craft CMS根目录中添加一个翻译目录。

2. 在您的翻译目录内，在您希望的语言目录中创建一个名为datastone-mailchimp-sync.php的文件，例如，荷兰语翻译为translations/nl/。

以下是一个PHP翻译文件的示例（datastone-mailchimp-sync.php）

<?php

return [
   'subscription-error' => 'Aanmelden op de nieuwsbrief is niet gelukt of je bent al geregistreerd.',
   'subscription-success' => 'Succesvol aangemeld op de nieuwsbrief!',
];

在此文件中，您可以根据您特定语言的需求自定义闪存消息的翻译。

现在，Craft CMS将根据用户的语言设置使用这些翻译。

故障排除

只有电子邮件将被发送到Mailchimp。请确保您在Mailchimp中没有设置其他必需的字段，例如姓名和姓氏。

路线图

• 添加更多字段到表单中，如姓名和姓氏

• 为自定义API密钥提供单独的服务器ID

• 退订功能

许可

本插件采用MIT许可。有关详细信息，请参阅LICENSE文件。

鸣谢

Craft CMS Mailchimp Sync由Datastone开发和维护。

支持和反馈

如果您遇到任何问题或有问题或反馈，请在GitHub存储库中创建问题。