Metadata-Version: 1.1
Name: collective.mailchimp
Version: 1.4.0
Summary: MailChimp integration for Plone.
Home-page: http://github.com/collective/collective.mailchimp
Author: Timo Stollenwerk
Author-email: contact@timostollenwerk.net
License: GPL
Description: Introduction
        ============
        
        .. image:: https://secure.travis-ci.org/collective/collective.mailchimp.png
            :target: http://travis-ci.org/collective/collective.mailchimp
        
        .. image:: https://coveralls.io/repos/collective/collective.mailchimp/badge.png?branch=master
            :target: https://coveralls.io/r/collective/collective.mailchimp
        
        .. image:: https://pypip.in/d/collective.mailchimp/badge.png
            :target: https://pypi.python.org/pypi/collective.mailchimp/
            :alt: Downloads
        
        .. image:: https://pypip.in/v/collective.mailchimp/badge.png
            :target: https://pypi.python.org/pypi/collective.mailchimp/
            :alt: Latest Version
        
        .. image:: https://pypip.in/egg/collective.mailchimp/badge.png
            :target: https://pypi.python.org/pypi/collective.mailchimp/
            :alt: Egg Status
        
        .. image:: https://pypip.in/license/collective.mailchimp/badge.png
            :target: https://pypi.python.org/pypi/collective.mailchimp/
            :alt: License
        
        .. image:: https://landscape.io/github/collective/collective.mailchimp/master/landscape.svg?style=plastic
           :target: https://landscape.io/github/collective/collective.mailchimp/master
           :alt: Code Health
        
        MailChimp integration for Plone.
        
        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).
        
        .. _MailChimp: http://mailchimp.com
        .. _raptus.mailchimp: http://plone.org/products/raptus.mailchimp
        
        The difference between collective.mailchimp and raptus.mailchimp is:
        
        - postmonkey_ 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)
        
        .. _postmonkey: http://pypi.python.org/pypi/postmonkey
        .. _greatape: http://pypi.python.org/pypi/greatape
        .. _z3c.form: http://pypi.python.org/pypi/z3c.form
        .. _plone.app.registry: http://pypi.python.org/pypi/plone.app.registry
        
        collective.mailchimp is tested on Plone 4.x and should work on Plone > 3.3
        (with the appropriate version pins for plone.app.registry and z3c.form).
        
        
        Installation
        ============
        
        Just add collective.mailchimp to the eggs section of your 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
        
        
        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.
        
        .. note::
        
          - https://github.com/collective/collective.mailchimp/blob/master/collective/mailchimp/browser/extender.py
        
          - https://github.com/collective/collective.mailchimp/blob/master/collective/mailchimp/browser/extender.zcml
        
          - http://packages.python.org/plone.app.discussion/howtos/howto_extend_the_comment_form.html.
        
        
        Issue Tracker
        =============
        
        Please report bugs to the `issue tracker on github`_.
        
        .. _`issue tracker on github`: https://github.com/collective/collective.mailchimp/issues
        
        Changelog
        =========
        
        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]
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 4.0
Classifier: Framework :: Plone :: 4.1
Classifier: Framework :: Plone :: 4.2
Classifier: Framework :: Plone :: 4.3
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
