Skip to content

ulule/django-courriers

Repository files navigation

django-courriers

Build Status

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'