Installation

It’s easiest to install Djrill from PyPI:

$ pip install djrill

If you decide to install Djrill some other way, you’ll also need to install its one dependency (other than Django, of course): the requests library from Kenneth Reitz.

Configuration

In your project’s settings.py:

  1. Add djrill to your INSTALLED_APPS:

    INSTALLED_APPS = (
        ...
        "djrill"
    )
  2. Add the following line, substituting your own MANDRILL_API_KEY:

    MANDRILL_API_KEY = "brack3t-is-awesome"
    
  3. Override your existing EMAIL_BACKEND with the following line:

    EMAIL_BACKEND = "djrill.mail.backends.djrill.DjrillBackend"
    

Mandrill Webhooks (Optional)

Djrill includes optional support for Mandrill webhooks, including inbound email. See the Djrill webhooks section for configuration details.

Admin (Optional)

Djrill includes an optional Django admin interface, which allows you to:

  • Check the status of your Mandrill API connection
  • See stats on email senders, tags and urls

If you want to enable the Djrill admin interface, edit your base urls.py:

...
from django.contrib import admin

from djrill import DjrillAdminSite

admin.site = DjrillAdminSite()
admin.autodiscover()
...

urlpatterns = patterns('',
    ...
    url(r'^admin/', include(admin.site.urls)),
)

Project Versions

Table Of Contents

Previous topic

Djrill 1-2-3

Next topic

Sending Mail

This Page