mediabeast/campaign-monitor-userform

Custom Userform Field which integrates with Campaign Monitor

Campaign Monitor UserForm Field

Adds a custom field to UserForms which allows you to select a list from campaign monitor, set custom fields and subscribe on submission., _(*1)

Installation

Via composer, _(*2)

composer require mediabeast/campaign-monitor-userform

Configuration

To connect to your campaign monitor field you will need to set two fields in your config.yml., _(*3)

EditableCampaignMonitorField:
    api_key: 'API KEY GOES HERE'
    client_id: 'CLIENT ID GOES HERE'

^ These setting can be found in client settings area in Campaign Monitor., _(*4)

Customisation

You can also change what type of field is actually used on the UserForm. By Default it's a checkbox field. You can change this via your config.yml OR via the CMS per form. If you choose to use a DropdownField you can add options under the Custom Options tab., _(*5)

EditableCampaignMonitorField:
    defaultFieldType: 'DropdownField'

Adding Custom Fields

You can integrate your campaigns custom fields with the fields on your form. To do so you must name the field(s) with the prefix 'customfields_', so for example if your custom field was called interests then the field name on your form must be named customfield_interests. The module will automatically push all fields to Campaign Monitor if there's a match. Note: there are a few caveats here e.g. you have to ensure if a field is required then it needs to be required at both ends., _(*6)

Extensions

There are a few extension hooks which can be useful to handle data before and after saving throughout the process. + $this->extend('beforeValueFromData', $data) + $this->extend('afterValueFromData', $data) + $this->extend('updateLists', $data) + $this->extend('updateCustomFields', $custom_fields), _(*7)

, _(*8)