Skip to content
MailChimp integration for Plone.
Python CSS
Find file
Latest commit 7e32a03 @mauritsvanrees mauritsvanrees Back to development: 2.0.3
[ci skip]

README.rst

Introduction

https://secure.travis-ci.org/collective/collective.mailchimp.png https://coveralls.io/repos/collective/collective.mailchimp/badge.png?branch=master Downloads Latest Version Egg Status License Code Health

MailChimp integration for Plone 4 and 5.

MailChimp helps you design email newsletters, share them on social networks, integrate with services you already use, and track your results.

collective.mailchimp has been written from the scratch in order to replace raptus.mailchimp for newer versions of Plone (> 4.0).

The difference between collective.mailchimp and raptus.mailchimp is:

  • Directly use the MailChimp API instead of greatape as Python wrapper (because greatape is completely untested, does not support the latest MailChimp API version and seems to be not actively developed any longer)
  • z3c.form instead of formlib for forms (because formlib is deprecated)
  • plone.app.registry instead of portal_properties for storing properties (because portal_properties will be deprecated soon)
  • it is tested by automated software tests (because untested code is broken code)

collective.mailchimp is tested on Plone 4.x and 5.x and should work on Plone > 3.3 (with the appropriate version pins for plone.app.registry and z3c.form).

Installation

Install collective.mailchimp by adding it to your buildout:

[buildout]

...

eggs =
collective.mailchimp

and then running "bin/buildout"

Multiple MailChimp Lists

collective.mailchimp supports multiple MailChimp lists. The MailChimp portlet allows administators to choose a MailChimp list from a dropdown list for each portlet. The MailChimp newsletter view (@@newsletter) allows to provide a list_id (see your MailChimp account) as optional URL parameter:

http://localhost:8080/Plone/@@newsletter?list_id=f3247645gs

If no URL parameter is provided the form just chooses the first MailChimp list available (which is fine as long as you have just one list anyway).

Preselect Interest Groups

collective.mailchimp supports MailChimp's interest groups. In case there is more than one single group you might want to pre-select some of the groups. To do so add one or more 'preselect_group' parameters to the URL that points to your MailChimp newsletter form. For instance to select the first and the fifth group entry use the following link:

http://localhost:8080/Plone/@@newsletter?preselect_group=0&preselect_group=4

Note: if you used version 1.4.1 of collective.mailchimp or earlier, you may no longer see the interest groups on the subscribe form. You should visit the control panel again. This will update the data automatically.

Extend Newsletter Subscription Form

The collective.mailchimp newsletter form (used in the separate view as well as in the portlet) can be extended without touching the code of collective.mailchimp.

Issue Tracker

Please report bugs to the issue tracker on github.

Support

This package is maintained by kitconcept <info@kitconcept.com>.

If you are having issues, please let us know.

License

The project is licensed under the GPLv2.

Something went wrong with that request. Please try again.