README

MailChimp集成插件

此插件实现了OctoberCMS的MailChimp订阅表单功能。

配置

为了使用此插件，您需要从您的MailChimp账户获取API密钥。

1. 在OctoberCMS后端，转到系统/设置页面，然后单击MailChimp链接。
2. 在MailChimp API密钥字段中粘贴API密钥。

创建注册表单

您可以将MailChimp注册表单放在任何前端页面上。将MailChimp注册表单组件添加到页面或布局中。单击添加的组件，在MailChimp列表ID字段中粘贴您的MailChimp列表标识符。关闭检查器并保存页面。

添加注册表单最简单的方法是使用组件的默认部分和{% component %}标签。将其添加到您想显示表单的页面或布局中

{% component 'mailSignup' %}

如果默认部分不适合您的网站，请用自定义代码替换组件标签，例如

<form
    id="subscribe-form"
    data-request="mailSignup::onSignup"
    data-request-update="'mailSignup::result': '#subscribe-form'"
>
    <input type="text" name="email" placeholder="Newsletter subscription">
    <input type="submit" class="btn btn-default" value="Subscribe"/>
</form>

示例使用标准部分mailSignup::result来显示订阅确认消息。如果您不喜欢标准消息，您可以在主题中创建自己的部分并指定其名称在data-request-update属性中。默认部分位于plugins/rainlab/mailchimp/components/signup/result.htm。

可以在订阅请求中包含更多字段

<input type="text" name="merge[fname]" placeholder="First Name" />
<input type="text" name="merge[lname]" placeholder="Last Name" />

就是这样！