Metadata-Version: 2.0
Name: django-emailit
Version: 0.2.3
Summary: Make sending html emails easy.
Home-page: http://github.com/divio/django-emailit
Author: Stefan Foulis
Author-email: stefan@foulis.ch
License: BSD
Description-Content-Type: UNKNOWN
Platform: OS Independent
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP
Requires-Dist: Django (<2.0,>=1.6)
Requires-Dist: premailer (>=1.12)
Requires-Dist: django-absolute

==============
django-emailit
==============

TODO: make the docs nicer

Deadsimple html email sending.

add ``emailit`` for the bundled templates and ``absolute`` for easy full absolute urls to ``INSTALLED_APPS``.

usage::

  import emailit.api
  context = {
      'my_obj': 'whatever',
  }
  emailit.api.send_mail(['email@domain.com'], context, 'mymails/example_email')

now add these templates::

  mymails/example_email.body.html
  mymails/example_email.body.txt
  mymails/example_email.subject.txt

the convention is, that the body templates should extend ``emailit/base_email.body.html`` /
``emailit/base_email.body.txt`` and overrid the ``content`` block. This makes it easy to provide a site-wide look
to all emails using this system by overriding ``emailit/base_email.body.*``.

If the ``body.html`` template is not found, a simple text email is sent. If the ``body.txt`` template is missing,
it will be a pure html email.

HTML emails are passed through ``premailer``.

``language`` can be passed into the ``send_mail`` function to override the active language while rendering the mail.

The body templates will contain the rendered ``subject`` variable in their context. ``subject`` can also be passed directly into
``send_mail``.


