• MODX.com

    446 downloads

MailChimp for FormIt

MailChimp for FormIt is an extra by sterc, first released on 2018-11-23.

Package Description

This extra adds subscribers to MailChimp lists using FormIt and the MailChimp API. It adds a snippet for retrieving Mailchimp lists in a single select TV and a FormIt hook for subscribing Mailchimp users to the list provided in the pages Template Variable

Usage/Installation Instructions

Package for subscribing users in Mailchimp lists using FormIt.

Adds a snippet for retrieving Mailchimp lists in a single select TV and a

FormIt hook for subscribing Mailchimp users to the list provided in the pages Template Variable.

Functionalities

* FormIt hook for subscribing users to Mailchimp lists based on TV value

* MailChimpGetLists: Snippet for creating a select list of MailChimp lists.

How to get set up

* Add MailChimp API Key in systemsettings: mailchimpsubscribe.mailchimp_api_key

* Create a new single select TV variable and set the input option values to:

    @EVAL return $modx->runSnippet('MailChimpGetLists');

* Add MailChimp List ID TV in systemsettings: mailchimpsubscribe.list_tv

* Add MailChimpSubscribe to your FormIt hooks

* Add in your chunk the placeholder fi.error.mailchimp, which holds all MailChimp error messages.

* Add a field called newsgroup, if the value of this field is set to yes, the user will be subscribed to the mailchimp list.

Properties

* mailchimpListId: Mailchimp List ID.

* mailchimpFields: Configuration containing the field mapping between FormIt form and Mailchimp merge tags.

* mailchimpSubscribeField: Field name to use for subscribing users to mailchimp.

* mailchimpSubscribeFieldValue: Field value to use for subscribing users to mailchimp.

Example usage

[[!FormIt?

&hooks=`MailChimpSubscribe,redirect`

&validate=`email:email:required,name:required`

&redirectTo=`[[++page_newsletter_thanks]]`

&validationErrorMessage=`true`

&store=`1`

&submitVar=`newsletter-submit`

&mailchimpListId=`12345678abc`

&mailchimpFields=`name=FNAME,email=EMAIL`

&mailchimpSubscribeField=`newsletter`

&mailchimpSubscribeFieldValue=`1`

]]

Details

Developer(s)
sterc
Released
2018-11-23
First seen
2018-11-23
License
GPLv2
Supported databases
MySQL
Minimum MODX Requirement
2.5

MailChimp for FormIt Releases

Vendor Signature Released on
MODX.com 1.0.1-pl 2018-11-23 (1 month ago)
MODX.com 1.0.0-pl 2017-12-20 (1 year ago)

We've also seen 1 unverified versions of MailChimp for FormIt in use, but don't list those as we've been unable of confirming they are official releases from an official source.