Markdown template based HTML and text emails for Django.
Project description
Django eMark↓
Markdown template based HTML and text emails for Django.
- simple email templates with markdown
- support for HTML and text emails
- i18n support
- built-in UTM tracking
- automatic CSS inliner via premailer
Setup
python3 -m pip install emark
# settings.py
INSTALLED_APPS = [
'emark',
# ...
]
python3 manage.py migrate
Usage
<!-- myapp/my_message.md -->
# Hello World
Hi {{ user.short_name }}!
# myapp/emails.py
from emark.message import MarkdownEmail
class MyMessage(MarkdownEmail):
subject = "Hello World"
template_name = "myapp/my_message.md"
# myapp/views.py
from . import emails
def my_view(request):
message = emails.MyMessage.to_user(request.user)
message.send()
Templates
You can use Django's template engine, just like you usually would. You can use translations, template tags, filters, blocks, etc.
You may also have a base template, that you inherit form in your individual emails to provide a consistent salutation and farewell.
<!-- base.md -->
{% load static i18n %}
{% block salutation %}Hi {{ user.short_name }}!{% endblock %}
{% block content %}{% endblock %}
{% block farewell %}
{% blocktrans trimmed %}
Best regards,
{{ site_admin }}
{% endblocktrans %}
{% endblock %}
{% block footer %}
Legal footer.
{% endblock %}
<!-- myapp/email.md -->
{% extends "base.md" %}
{% block content %}
This is the content of the email.
{% endblock %}
Context
The context is passed to the template as a dictionary. Furthermore, you may
override the get_context_data method to add additional context variables.
# myapp/emails.py
from emark.message import MarkdownEmail
class MyMessage(MarkdownEmail):
subject = "Hello World"
template_name = "myapp/email.md"
def get_context_data(self):
context = super().get_context_data()
context["my_variable"] = "Hello World"
return context
Tracking
Every MarkdownEmail subclass comes with automatic UTM tracking.
UTM parameters are added to all links in the email. Existing UTM params on link
that have been explicitly set, are not overridden. The default parameters are:
utm_source:websiteutm_medium:emailutm_campaign:{{ EMAIL_CLASS_NAME }}
The global UTM parameters can be overridden via the EMARK_UTM_PARAMS setting,
which is a dictionary of parameters:
# settings.py
EMARK_UTM_PARAMS = {
"utm_source": "website", # default
"utm_medium": "email", # default
}
You may also change the UTM parameters by overriding the get_utm_params
or passing a utm_params dictionary to class constructor.
# myapp/emails.py
from emark.message import MarkdownEmail
class MyMessage(MarkdownEmail):
subject = "Hello World"
template_name = "myapp/email.md"
# override the parameters for this email class
def get_utm_params(self):
return {
"utm_source": "myapp",
"utm_medium": "email",
"utm_campaign": "my-campaign",
}
# or alternatively during instantiation
MyMessage(utm_params={"utm_campaign": "my-other-campaign"}).send()
Credits
- Django eMark uses modified version of Responsive HTML Email Template as a base template
- For CSS inlining, Django eMark uses premailer
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
File details
Details for the file emark-1.0rc4.tar.gz.
File metadata
- Download URL: emark-1.0rc4.tar.gz
- Upload date:
- Size: 11.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 1ae2452de01ab236d42638a50001aeda41f450148f16d86195988db31ae04082 |
|
| MD5 | 97c9b1c24953ff310c304178f23efbaa |
|
| BLAKE2b-256 | 570b20374ab5902c8727b8dc88cf7067be4511819356a57cf28f8003c95f9b9c |
File details
Details for the file emark-1.0rc4-py3-none-any.whl.
File metadata
- Download URL: emark-1.0rc4-py3-none-any.whl
- Upload date:
- Size: 11.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 136c5e4aba4c12d5c1f487187ff2f1b3e4c355d28ec56fb2cd7c542a01f472e3 |
|
| MD5 | e2cc93be51f179e356042be000d80bc9 |
|
| BLAKE2b-256 | 156ce4e14fe3c4004e42aabfec1682cb88ac3457c7498a050981aba68c943ff5 |
