django-courriers

.. image:: https://secure.travis-ci.org/ulule/django-courriers.png?branch=master :alt: Build Status :target: http://travis-ci.org/ulule/django-courriers

A generic application to manage your newsletters

What it does?

django-courriers has four models:

• NewsletterList which represents a newsletter list
• Newsletter which represents a newsletter
• NewsletterItem an item of a newsletter. It could be a content-type
• NewsletterSubscriber which represents a user who is subscribed to a newsletter

You have the choice between two backends to manage and send your emails:

• SimpleBackend, a simple backend to send emails with Django and your current smtp configuration
• MailJetBackend, a Mailjet_ backend which uses mailjet library_

Installation

1. Download the package on GitHub_ or simply install it via PyPi

2. Add courriers to your INSTALLED_APPS ::

   INSTALLED_APPS = ( 'courriers', )

3. Sync your database using syncdb command from django command line

4. Configure settings

You have to specify which backend you want to use in your settings ::

COURRIERS_BACKEND_CLASS = 'courriers.backends.simple.SimpleBackend'

A quick reminder: you can also set your custom DEFAULT_FROM_EMAIL in Django settings.

Backends

courriers.backends.simple.SimpleBackend ........................................

A simple backend to send your emails with Django and your current smtp configuration

courriers.backends.mailjet.MailjetBackend ..............................................

A backend to manage your newsletters with Mailjet.

What you need to do for mailjet .................................

• Create an account on Mailjet
• Get your API key and API Secret key
• Add it to your settings with others options as described below
• Install the mailjet library_
• Create a list or more if you have users from different countries

With this backend you have to provide additional settings ::

COURRIERS_MAILJET_API_KEY = 'Your API key'
COURRIERS_MAILJET_API_SECRET_KEY = 'Your API Secret key'
COURRIERS_DEFAULT_FROM_NAME = 'Your name'

.. _GitHub: https://github.com/ulule/django-courriers .. _Mailjet: https://eu.mailjet.com/ .. _mailjet library: https://pypi.python.org/pypi/mailjet/