Possible options which can be added to the FormIt tag
Parameter
Description
mcApiKey
[optional] The Mailchimp API Key (can be also specified via system setting mcApiKey)
mcListId
[optional] The Mailchimp list id to subscribe to (can be also specified via system setting mcListId)
mcEmailField
The name of the email field in the form. Default: email.
mcMergeTags
The merge tags of Mailchimp combined with the form fields. Default: FNAME:firstname,LNAME:lastname,FULLNAME:firstname:lastname.
Subscribe parameters
Parameter
Description
mcEmailType
Email type preference for the email (html, text, or mobile).Default: html.
mcDoubleOptin
To control whether a double opt-in confirmation message is sent. Default: 1
mcUpdateExisting
To control whether a existing subscribers should be updated instead of throwing and error. Default: 0.
mcReplaceInterests
To determine whether we replace the interest groups with the groups provided, or we add the provided groups to the member's interest groups. Default: 1.
mcSendWelcome
if your double_optin is false and this is true, we will send your lists Welcome Email if this subscribe succeeds - this will not fire if we end up updating an existing subscriber. If double_optin is true, this has no effect. Default: 0.
Error parameters
Parameter
Description
mcDebug
Debug messages in MODX error log, when needed.Default: 0.
mcFailOnApiKey
Return API key errors to the front-end form. Default: 0
mcFailOnListNotExists
Return 'list not exists' error to the front-end form. Default: 0.
mcFailOnAlreadySubscribed
Return 'already subscribed' error to the front-end form. Default: 0.
mcFailOnNotSubscribed
Return 'not subscribed' error to the front-end form. Default: 0.
mcFailOnMissingRequired
Return 'missing required' error to the front-end form.. Default: 0.
Hey @himurovich - looks like you've written out some nice documentation. Would you like to send a pull request to add it here so it's on the new docs.modx.org website?
mChimpX
A FormIt hook provided to subscribe an emailaddress to your Mailchimp list. Fully configurable.
Author: Bert Oost at OostDesign.nl bert@oostdesign.nl
Author: Oleg Pryadko oleg@websitezen.com - Adapt for MailChimp API v.2
Author: Anton Tarasov contact@antontarasov.com - Further maintenance & support
This extra stable works with Maichimp API 2.0 support (only 1.x versions support has been stopped), 3.0 version will be implemented soon.
Example snippet call
Possible options which can be added to the FormIt tag
mcApiKey
)mcListId
)email
.FNAME:firstname,LNAME:lastname,FULLNAME:firstname:lastname
.Subscribe parameters
html
.1
0
.1
.0
.Error parameters
0
.0
0
.0
.0
.0
.Development and Bug Reporting
mChimpX is stored and developed using GitHub, and can be found here: https://github.com/himurovich/MODX-mChimpX
Bugs and feature requests can be filed here: https://github.com/himurovich/MODX-mChimpX/issues/