oneup / contao-mailchimp
This extension connects a Contao installation with MailChimp.
Installs: 11 005
Dependents: 0
Suggesters: 0
Security: 0
Stars: 7
Watchers: 6
Forks: 3
Open Issues: 4
Type:contao-bundle
Requires
- php: ^7.4 || ^8.0
- ext-json: *
- codefog/contao-haste: ^5.0
- contao/core-bundle: ^4.13 || ^5.0
- oneup/mailchimp-api-v3: ^2.7
- patchwork/utf8: ^1.3
- symfony/event-dispatcher: ^4.4 || ^5.4 || ^6.4 || ^7.0
Requires (Dev)
- contao/manager-plugin: ^2.0
- friendsofphp/php-cs-fixer: ^3.9
- phpunit/phpunit: ^8.4
- dev-main
- 4.10.0
- 4.9.2
- 4.9.1
- 4.9.0
- 4.8.2
- 4.8.1
- 4.8.0
- 4.7.1
- 4.7.0
- 4.6.1
- 4.6.0
- 4.5.0
- 4.4.7
- 4.4.6
- 4.4.5
- 4.4.4
- 4.4.3
- 4.4.2
- 4.4.1
- 4.4.0
- 4.3.1
- 4.3.0
- 4.2.1
- 4.2.0
- 4.1.0
- 4.0.0
- 3.1.1
- 3.1.0
- 3.0.3
- 3.0.2
- 3.0.1
- 3.0.0
- 2.2.1
- 2.2.0
- 2.1.1
- 2.0.1
- 2.0.0
- 1.0.1
- 1.0.0
- 0.3.1
- 0.3.0
- 0.2.3
- 0.2.2
- 0.2.1
- 0.2.0
- 0.1.0
- dev-support/3.x
- dev-support/2.x
This package is auto-updated.
Last update: 2024-10-19 07:49:43 UTC
README
This Contao bundle provides subscribe and unsubscribe forms for easy integration in Contao.
--
The fields that will be shown are managed through MailChimp's List fields and *|MERGE|* tags
. You may also change the order of this fields: In MailChimp, go to Signup forms > General forms > Signup Form and rearrange the fields via drag'n'drop. You then have to import the new field order into Contao, by simply re-saving the MailChimp list in the back end.
How-to
Install using the command line composer require oneup/contao-mailchimp
or by using the Contao Manager.
Requires of oneup/contao-mailchimp (Composer resolves this automatically)
After installing the Contao MailChimp bundle you have to build a connection to MailChimp.
Login into the Contao Backend and go to Content > MailChimp:
- Create a new List
- Enter a name for your list
- Enter your MailChimp API Key
- Enter your subscriber List ID
Create four pages under Layout > Site Structure:
- Subscribe to the newsletter
- Subscribe confirmation
- Unsubscribe from the newsletter
- Unsubscribe confirmation
Go to Layout > Themes > Modules:
- Add a module of the type Subscribe form
- Choose your MailChimp List
- Choose the redirection page after subscription (Page: Subscribe to the newsletter)
- Choose whether you will use double opt-in for subscription
- Choose whether you will use the HTML5-Placeholder in the form fields or not
- Choose whether you will have the Contao captcha field
- Add a module of the type Unsubscribe form
- Choose your MailChimp List
- Choose the redirection page after unsubscription (Unsubscribe from the newsletter)
- Choose whether you will use the HTML5-Placeholder in the form fields or not
- Choose whether you will have the Contao captcha field
Go to Content > Articles:
- Insert the module of the type Subscribe form on the page Subscribe to the newsletter
- Insert the module of the type Unsubscribe form on the page Unsubscribe from the newsletter
Form Generator
You can also use forms of the form generator to subscribe to Mailchimp lists.
- Go to the settings of the form.
- In the Mailchimp section Enable Mailchimp.
- Select a Mailchimp list to subscribe to.
- Optionally select interest groups that new subscriptions should be assigned to by default.
- Optionally enter the name of a field which controls whether the subscription should take place or not (e.g. the field name of a newsletter checkbox).
- Optionally enable Mailchimp's double opt-in feature.
- Define the merge tags to map the form's input to the mailchimp list's fields. Note: you always need an
EMAIL
merge tag. - Define optional added member tags.
Known limitations
- If the captcha option is activated and the same module is multiple times visible on the website, it won't work properly. E.g. if you have a subscription form in the footer and the same module somewhere in the content - it won't work. You'll have to have a different module for the footer then.