Creating e-mail messages, with multiple layouts and multilingual content.
Project description
fluentcms-emailtemplates
An email template system, that uses django-fluent-contents blocks to define the e-mail templates.
Features:
Multilingual content.
Multisite support.
Custom layouts (=Django templates).
Custom context variables
Installation
First install the module, preferably in a virtual environment. It can be installed from PyPI:
pip install fluentcms-emailtemplates
First make sure the project is configured for django-fluent-contents.
Then add the following settings:
INSTALLED_APPS += ( 'fluentcms_emailtemplates', 'fluentcms_emailtemplates.plugins.emailtext', ) FLUENTCMS_EMAILTEMPLATES_PLUGINS = ( 'EmailTextPlugin', )
The database tables can be created afterwards:
./manage.py migrate
Configuration
The following settings are defined by default:
FLUENTCMS_EMAILTEMPLATES_LAYOUTS = (
# A layout points to a template named:
# fluentcms_emailtemplates/emails/{slug}/{layout}.html
# fluentcms_emailtemplates/emails/{layout}.html
('default', _("Default")),
)
# Possible plugins to use in the email template.
# By default, that is FLUENT_CONTENTS_PLACEHOLDER_CONFIG['email_templates']
FLUENTCMS_EMAILTEMPLATES_PLUGINS = (
'EmailTextPlugin',
)
# Add extras context data for an e-mail preview.
FLUENTCMS_EMAILTEMPLATES_PREVIEW_CONTEXT = {}
# Optionally allow developers to share email templates between all sites in a multisite setup.
FLUENTCMS_EMAILTEMPLATES_ENABLE_CROSS_SITE = False
# Enable multisite support by default
FLUENTCMS_EMAILTEMPLATES_FILTER_SITE_ID = True
Usage
Create email templates in the admin. Use the following code to create an email:
from email.utils import formataddr
from fluentcms_emailtemplates.models import *
template = EmailTemplate.objects.get_for_slug('order-confirmation')
email = template.get_email_message(
base_url='http://example.org/',
context={
'order_number': "123-xy"
},
to=[
formataddr(('You', 'you@example.org')),
],
)
email.send()
Contributing
If you like this module, forked it, or would like to improve it, please let us know! Pull requests are welcome too. :-)
Project details
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 fluentcms-emailtemplates-0.2.4.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 60dd4517d3eb33d0c194194ba4765392f7f55396fe307977464145728d4f44b7 |
|
MD5 | 9068268dba10b5bf4ddf0257789df9d6 |
|
BLAKE2b-256 | f56ddfa1cbe65bbb9b99bef64e1681198c8f1bb77254af67d6bc1fe8278f9937 |
Hashes for fluentcms_emailtemplates-0.2.4-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 11791a5f59d8f4ae331b26cfe8daf5f65ac12d83f631ce05169f621cc2b245e2 |
|
MD5 | 64fdd1460bafb3d18ff2978e51f7b053 |
|
BLAKE2b-256 | 536e03277080cdd3d7c9a735eac08323199b6434bab6f7a0038e747a92d62fbe |