mediabeast/campaign-monitor-userform

此包最新版本(1.2.4)的许可证信息不可用。

与 Campaign Monitor 集成的自定义用户表单字段

1.2.4 2020-07-06 04:49 UTC

This package is auto-updated.

Last update: 2024-09-06 14:53:19 UTC


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)

field configuration example