django-saas-email 0.1.9

An email manager for sending emails with templates, mail history and admin.

An email manager for sending emails with templates, mail history and admin.

Features

• Use of Mailhog for local email testing.

• Send emails via django-anymail (using Sendgrid as default).

• Serving dynamic HTML E-Mail Templates, editable with Tinymce.

• Use of the awesome Transactional email templates from Mailgun.

Documentation

The full documentation is at https://django-saas-email.readthedocs.io.

Quickstart

Installation

Installation with pip:

pip install django-saas-email

Add it to your INSTALLED_APPS:

INSTALLED_APPS = (
    ...
    'django_saas_email.apps.DjangoSaasEmailConfig',
    ...
)

JSONField

We are using the Postgres JSONField as default. If you installed psycopg2, everything should work fine.

If you are using a different database, you also need to install jsonfield:

pip install jsonfield

Adding the Sendgrid API Key to your settings

In settings.py:

SENDGRID_API_KEY=<....>

Other optional settings:

DJANGO_SAAS_TEST_EMAIL_ADDRESS=[e-mail]
DJANGO_SAAS_FOOTER="""Follow <a href="#" style="font-family: 'Helvetica Neue',Helvetica,Arial,sans-serif; box-sizing: border-box; font-size: 12px; color: #999; text-decoration: underline; margin: 0;">@yourcompany</a> on Twitter"""

Sending emails

Basic example:

from django_saas_email.utils import create_and_send_emails

context={
    'first_name': 'John',
    'last_name': 'Doe',
}

create_and_send_mail(
    template_name="hello_world",
    context=context,
    to_address=[e-mail]
)

This will create an email and send it with Sengrid.

You should use http://premailer.dialect.ca or django-premailer to create Inline CSS in HTML

Running Tests

Does the code actually work?:

source <YOURVIRTUALENV>/bin/activate
(myenv) $ pip install tox
(myenv) $ tox

History

0.1.0 (2017-07-24)

• First release on PyPI.