django-mail-templated 0.1.2

Send emails with Django template system
django-mail-templated is a tiny wrapper around standard EmailMessage class and send_mail() function. Just pass the template_name and context as first parameters, and use it as usually.

Installation

Run::

  pip install -e git+git://github.com/artemrizhov/django-mail-templated.git#egg=mail_templated

And register the app in your settings file::

    INSTALLED_APPS = (
        ...
        mail_templated
    )


Usage

Write a template to send a plain text message. Note that first and last \n\r will be removed::

    {% block subject %}
    Hello {{ user.name }}
    {% endblock %}

    {% block body %}
    This is a plain text message.
    {% endblock %}


Or for html message::

    {% block subject %}
    Hello {{ user.name }}
    {% endblock %}

    {% block html %}
    This is an < strong >html< /strong > message.
    {% endblock %}


Or for multipart message just use both blocks::

    {% block subject %}
    Hello {{ user.name }}
    {% endblock %}

    {% block body %}
    This is a plain text message.
    {% endblock %}

    {% block html %}
    This is an < strong >html< /strong > message.
    {% endblock %}

Or forget some block to set it manually later with EmailMessage class::

    {% block body %}
    This is a plain text message.
    {% endblock %}


Now you can send it::

    from mail_templated import send_mail
    send_mail('email/hello.tpl', {'user': user}, from_email, [user.email])


Or if you wish to add more control over message creating then user the class::

    from mail_templated import EmailMessage
    message = EmailMessage('email/hello.tpl', {'user': user}, to=[user.email])
    # ... attach a file, etc
    message.send()

last updated on:
February 27th, 2012, 11:47 GMT
price:
FREE!
developed by:
Artem Rizhov
homepage:
github.com
license type:
MIT/X Consortium License 
category:
ROOT \ Internet \ HTTP (WWW)

FREE!

In a hurry? Add it to your Download Basket!

user rating

UNRATED
0.0/5
 

0/5

Rate it!

Add your review!

SUBMIT