This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

Introduction

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.

Contributors

  • Timo Stollenwerk, Original Author
  • Maurits van Rees, MailChimp API 3, Plone 5 compatibility
  • Jean-Paul Ladage
  • Jean-Michel Francois

Changelog

2.0.2 (2016-02-02)

  • Fixed MANIFEST.in so all files are added. Releases 2.0 and 2.0.1 were missing non Python files. [maurits]

2.0.1 (2016-01-29)

2.0 (2016-01-28)

  • Move code to src folder to follow best practice. [timo]
  • Set default value for interests to ‘{}’ instead of None. This fixes https://github.com/collective/collective.mailchimp/issues/19. [timo]
  • Added support for Plone 5, kept 4.3 compatibility. [jladage, didrix, maurits]
  • Updated to version 3.0 of the mailchimp api. The data that we get from mailchimp with this api version is changed. When you have interest groups in your lists, and you do not see them anymore on the subscribe form, you should visit the control panel again. This will update the data automatically. [jladage, didrix, maurits]
  • Remove bare excepts. [timo]

1.4.1 (2015-05-04)

  • Try to avoid some needless registry updates. [maurits]
  • Disable inline validation in the mailchimp control panel. It may change the cache based on a new api key that the user has not yet saved. [maurits]
  • Remove mailchimp object before updating cache. Otherwise a change in the api key is not picked up until after a restart. [maurits]

1.4.0 (2015-04-29)

  • Fix invalid pypi classifier. [timo]
  • Show control panel even when api key is invalid. Fixes issue #8. [maurits]
  • Fix fallback for missing cache after startup. [pbauer]
  • Add italian translation. [gborelli]
  • Fix UnicodeEncodeError [pbauer]
  • Add persistent cache in the registry for the connection. [toutpt]
  • Add french translations [toutpt]
  • Add brazilian translation. [cleberjsantos]

1.3.1 (2013-03-03)

  • Fix broken group subscription which has been introduced in 1.3.0. [timo]

1.3.0 (2013-03-03)

  • Add option to preselect interest groups in the newsletter form. [timo]

1.2.1 (2013-02-13)

  • Fix 1.2.0 upgrade step. [timo]

1.2.0 (2013-02-13)

  • Make newsletter view not fail if no default_list has been selected. [timo]
  • German translation updated. [timo]
  • Styles for newsletter subscription form added. [timo]

1.1.1 (2013-02-01)

  • Fix mailchimp control panel which fails if no valid MailChimp API key has been provided. [timo]

1.1.0 (2013-01-23)

  • Dutch translation added. [sjoerdve]
  • Make NewsletterForm extendable. [timo]
  • Use MailChimp list settings from the control panel. Note: You have to reinstall collective.mailchimp, otherwise you will end up with a “KeyError: ‘Interface .. defines a field .., for which there is no record.’” [timo]
  • Support for MailChimp interest groups added. For now this feature only works with one single list. [timo]
  • Email type option added. [timo]
  • Rename AvailableListsVocabulary to AvailableLists. [timo]
  • Add fieldsets to MailChimp control panel. [timo]
  • Add a MailchimpLocator utility to encapsulate all MailChimp API calls. [timo]
  • Allow multiple lists for newsletter view; add mailchimp locator to encapsulate api calls. [timo]
  • Add new default_list setting to allow administrators to choose their default MailChimp list for the @@newsletter view. [timo]
  • Add email_type_is_optional setting to allow administrators to choose if they want to allow users to choose their own email_type. [timo]
  • Make README and CHANGES .rst files. [timo]

1.0.3 (2012-12-05)

  • Missing .mo files added. [timo]

1.0.2 (2012-12-05)

  • Raise a more specific error when an email has been already subscribed to a newsletter. [timo]
  • German translations updated. [timo]

1.0.1 (2012-10-28)

Fix MANIFEST.in to include readme and changelog. [jone]

1.0 (2012-10-17)

  • Initial release [timo]
Release History

Release History

2.0.2

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

2.0.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

2.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.4.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.4.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.3.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.3.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.2.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.2.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.1.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.1.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.0.3

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.0.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.0.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
collective.mailchimp-2.0.2.tar.gz (53.0 kB) Copy SHA256 Checksum SHA256 Source Feb 2, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting