An email manager for sending emails with templates, mail history and admin.
Project description
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',
...
)
Add a template engine TEMPLATES:
TEMPLATES = [
...
{
"BACKEND": "django.template.backends.django.DjangoTemplates",
"APP_DIRS": True,
"DIRS": ["django_saas_email/templates/"],
"NAME": "email",
"OPTIONS": {"string_if_invalid": "{%s}"},
}
]
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=youremailfortesting@example.org 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
from django_saas_email.utils import create_and_send_mail
context={
'first_name': 'John',
'last_name': 'Doe',
}
create_and_send_mail(
template_name="hello_world",
context=context,
to_address="john.doe@example.org"
)
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
Background sending
This module sends emails asynchronously. To do that, it uses celery. You will need to run and configure celery to really send emails using the library.
The best source to do that is First Steps with Celery.
But you may use the following simple guide if you want to make it fast:
Create a celery.py file aside your wsgi.py file with the following content:
from __future__ import absolute_import, unicode_literals
import os
from celery import Celery
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'config.settings')
app = Celery(<YOUR_APP_NAME>)
app.config_from_object('django.conf:settings', namespace='CELERY')
app.autodiscover_tasks()
Change <YOUR_APP_NAME> to the name of your app.
Install RabbitMQ.
Run celery:
celery -A <YOUR_APP_NAME> worker -B -l debug
Change <YOUR_APP_NAME> to the name of your app.
Now you might just send the email with no problem using create_and_send_mail function.
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django_saas_email-0.1.22-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1fdcc93d59de882b6003f2e1b8c6c258502ac188c3d39135554d3c5b781e72aa |
|
MD5 | f529b21439839fac6e3e7e861192df75 |
|
BLAKE2b-256 | 48d94853bb593ded18669a7165708ed81fa81e17ef7d87ea3df66d2fc8888d31 |