django-courriers 0.5.14

A generic application to manage your newsletters

A generic application to manage your newsletters

Compatibility

This library is compatible with:

• python2.6, django1.4

• python2.6, django1.5

• python2.6, django1.6

• python2.7, django1.4

• python2.7, django1.5

• python2.7, django1.6

• python3.3, django1.5

• python3.3, django1.6

What it does?

django-courriers has three 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 three backends to manage and send your emails:

• SimpleBackend, a simple backend to send emails with Django and your current smtp configuration

• MailchimpBackend, a Mailchimp backend which uses mailchimp library

• 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.mailchimp.MailchimpBackend

A backend to manage your newsletters with Mailchimp.

courriers.backends.mailjet.MailjetBackend

A backend to manage your newsletters with Mailjet.

What you need to do for mailchimp

• Create an account on Mailchimp

• Get your API key

• Add it to your settings with others options as described below

• Install the mailchimp library

• Create a list or more if you have users from different countries

With this backend you have to provide additional settings

COURRIERS_MAILCHIMP_API_KEY = 'Your API key'
COURRIERS_DEFAULT_FROM_NAME = 'Your name'

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'