mediabeast / campaign-monitor-userform
此包最新版本(1.2.4)的许可证信息不可用。
与 Campaign Monitor 集成的自定义用户表单字段
1.2.4
2020-07-06 04:49 UTC
Requires
- campaignmonitor/createsend-php: 5.*
- silverstripe/cms: ~3.1
- silverstripe/framework: ~3.1
- silverstripe/userforms: ^4.0
README
# Campaign Monitor UserForm 字段向用户表单添加一个自定义字段,允许您从 Campaign Monitor 选择列表、设置自定义字段并在提交时订阅。
安装
通过 composer
composer require mediabeast/campaign-monitor-userform
配置
要连接到您的 Campaign Monitor 字段,您需要在 config.yml 中设置两个字段。
EditableCampaignMonitorField:
api_key: 'API KEY GOES HERE'
client_id: 'CLIENT ID GOES HERE'
^ 这些设置可以在 Campaign Monitor 的客户端设置区域找到。
定制
您还可以更改 UserForm 中实际使用的字段类型。默认情况下是复选框字段。您可以通过 config.yml 或 CMS 中的每个表单来更改此设置。如果您选择使用下拉字段,可以在“自定义选项”选项卡下添加选项。
EditableCampaignMonitorField:
defaultFieldType: 'DropdownField'
添加自定义字段
您可以将您的活动自定义字段与表单上的字段集成。为此,您必须使用前缀 'customfields_' 命名字段(s),例如,如果您的自定义字段名为 interests
,则表单上的字段名称必须是 customfield_interests
。如果存在匹配项,模块将自动将所有字段推送到 Campaign Monitor。注意:这里有几个限制,例如,如果字段是必填的,那么两端都需要必填。
扩展
有一些扩展钩子可以在整个过程中处理保存前后数据非常有用。
$this->extend('beforeValueFromData', $data)
$this->extend('afterValueFromData', $data)
$this->extend('updateLists', $data)
$this->extend('updateCustomFields', $custom_fields)