The django-email-html from markijbema

markijbema / django-email-html Goto Github PK

View Code? Open in Web Editor NEW

Application for switching from Django plain-text emails to html emails with 2 bodies: html and plain-text, generated automatically from html

Python 100.00%

django-email-html's Introduction

This application can be used for quickly switching all emails of site from plain-text to html. For using it you need to do 2 steps:

* add ``email_html`` to ``INSTALLED_APPS`` higher, then other third-part applications;
* change email templates to html version;

Application substitutes built-in ``send_mail`` function by new smart ``send_mail`` function.

build-in: send_mail(subject, message, from_email, recipient_list, fail_silently=False, auth_user=None, auth_password=None, connection=None)
new one: send_mail(subject, message, from_email=None, recipient_list=None, fail_silently=False, auth_user=None, auth_password=None, connection=None)

Few new features:

* message attribute using for html or plain-test message body. If it contains html, plain-text is generating automatically basing on html body;
* from_email attribute is not required. By default it will be equal to ``settings.DEFAULT_FROM_EMAIL``;
* Depending on ``settings.EMAIL_ADMIN_DUPLICATE`` all copies of email messages also sending to ``ADMIN`` emails (using bcc header);

New function cam be used:

    send_mail(subj, html, recipient_list=emails)

Requirements:

* BeautifulSoup
* w3m (for generating plain-text from html)

Important things:

* Place ``email_html`` application in ``INSTALLED_APPS`` before all other applications, which sending emails, that you need to make html based by default;
* Html body must contains <html> tag, otherwise function would think this is a plain-text body;

Recommend Projects