README

WooCommerce MailChimp注册

此插件可能会破坏您的网站 💀 或甚至MailChimp账户 💀💀💀。请在开发环境中使用。

此插件实际上做什么？

在Atomic Smash创建和维持的几乎所有WordPress网站上，我们都会进行某种形式的MailChimp同步。大多数现有的插件都依赖于在WP中记录信息，然后在稍后与MailChimp同步。

我们发现这可能会变得非常繁琐。列表成员可以通过列表通信偏好（甚至只是通过退订列表）在网站之外与MailChimp互动。这归结为成员可以更改他们的详细信息，而无需您的WP网站介入。当然，您可以设置webhooks在通过MailChimp进行更改时通知您的网站…… 但是…… 保持简单。保持MailChimp为“唯一真实来源”，并忘记需要将订阅偏好与WP网站保持一致。

多亏了这种分离，WordPress和MailChimp在未来可以完全替代。

如果您需要迁移到新的CMS，所有内容都在MailChimp中。
如果您需要从MailChimp迁移，只需从MailChimp导出即可。您的WordPress网站上没有关于用户通信偏好的用户工件。

此插件何时与MailChimp通信？

此插件在这些点上与MailChimp通信

通过WooCommerce成功的订单。 - woocommerce_checkout_update_order_meta

未来将添加更多交互点。

知道您想与MailChimp通信的另一个时间吗？请添加问题！ 😉

注册表单

用户将看到MailChimp作为营销平台的功能描述，然后 .. CHECKBOX OPTIONS

所有这些文本都可以通过这些过滤器进行编辑。 😎

功能

内置符合GDPR的新闻通讯描述
向MailChimp发送自定义合并字段
在MailChimp内部与GDPR字段交互
此插件仅同步已订阅或挂起的用户，如果他们已退订，则永远不会发送到MC

完整的网站设置

步骤1 - 将项目添加到您的composer文件

在您的项目根目录中运行此命令

composer require atomicsmash/ultimate-mailchimp-plugin

步骤2 - 添加配置

将这些配置详细信息添加到您的wp-config.php

define('ULTIMATE_MAILCHIMP_LIST_ID', '');
define('ULTIMATE_MAILCHIMP_API_KEY', '');
define('ULTIMATE_MAILCHIMP_GDPR_FIELDS', true);

ULTIMATE_MAILCHIMP_LIST_ID - 这是您要同步的列表。这可以在这里找到。

ULTIMATE_MAILCHIMP_API_KEY - 这是您的密钥，可以在您的账户中找到。

ULTIMATE_MAILCHIMP_GDPR_FIELDS -

步骤3 - 在您的MailChimp列表中启用双 Opt-in（鼓励）

默认情况下，当某人勾选“让我订阅MailChimp新闻通讯”时，订阅者状态设置为“挂起”。这将触发MailChimp的确认电子邮件。

为确保此功能处于激活状态，请前往您的主列表 > 设置 > '列表名称和活动'，并勾选“启用双确认”复选框并保存。

步骤 4 - GDPR 字段

MailChimp 已经在它的 API 中添加了一系列的“营销许可”（GDPR）字段。为了与这些字段交互，我们需要一些信息。

字段 ID
字段名称
字段值（是否勾选）

其他配置

以下是一些额外的配置选项。我们建议只在开发或测试环境中使用这些选项。

define('ULTIMATE_MAILCHIMP_LOGGING', true);
define('ULTIMATE_MAILCHIMP_DEBUG', true);

ULTIMATE_MAILCHIMP_LOGGING - 这将启用通过 monolog 记录到文件：wp-content/uploads/ultimate-mailchimp.log。

ULTIMATE_MAILCHIMP_DEBUG - 当处于调试模式时，WooCommerce 结账将不会完成（会出现 JSON 错误），但 MailChimp 会被调用。这允许您在不每次都创建新订单的情况下运行结账过程。

ULTIMATE_MAILCHIMP_DOUBLE_OPTIN - 如果您想禁用双确认并强制新用户在同步时默认订阅，请将此常量添加到您的配置中并将其设置为 false。

合并字段

以下默认发送的合并字段是

**FNAME** - This is taken from the first name in the billing details.
**LNAME** - This is taken from the last name in the billing details.

要编辑发送到 MailChimp 的合并字段，请使用此处的合并字段过滤器。

所有可用过滤器

在此查看过滤器

即将推出的功能

从 WordPress 到 MailChimp 批量同步用户
随购买发送交易信息
- 同步产品/商店信息
添加用于加载注册表单的短代码和代码片段
在 composer 文件中单独开发（monolog）要求
添加 user_register：这是一个全局钩子，在 WordPress 中创建用户时会触发。这意味着它从前端注册表单、后端用户添加屏幕、任何用于注册用户的插件或自定义脚本以及几乎所有中间部分触发。

atomicsmash / ultimate-mailchimp-plugin

维护者

详细信息