Создание шаблонов писем с Django

Я хочу отправлять HTML-письма, используя такие шаблоны Django:

<html>
<body>
hello <strong>{{username}}</strong>
your account activated.
<img src="mysite.com/logo.gif" />
</body>

Я ничего не могу найти о send_mail, а django-mailer отправляет только HTML-шаблоны без динамических данных.

Как использовать механизм шаблонов Django для создания электронных писем?


person Anakin    schedule 11.05.2010    source источник
comment
Обратите внимание, что Django 1.7 предлагает html_message в send_email stackoverflow.com/a/28476681/953553   -  person andilabs    schedule 12.02.2015
comment
Привет @anakin, я долго боролся с этой проблемой и решил создать для этого пакет. Я был бы очень рад получить ваш отзыв: github.com/charlesthk/django-simple-mail < / а>   -  person Charlesthk    schedule 10.08.2018


Ответы (12)


Из документов для отправки HTML e -mail вы хотите использовать альтернативные типы контента, например:

from django.core.mail import EmailMultiAlternatives

subject, from_email, to = 'hello', '[email protected]', '[email protected]'
text_content = 'This is an important message.'
html_content = '<p>This is an <strong>important</strong> message.</p>'
msg = EmailMultiAlternatives(subject, text_content, from_email, [to])
msg.attach_alternative(html_content, "text/html")
msg.send()

Возможно, вам понадобится два шаблона для электронной почты - простой текстовый, который выглядит примерно так, хранящийся в каталоге ваших шаблонов в email.txt:

Hello {{ username }} - your account is activated.

и HTMLy, хранящийся в email.html:

Hello <strong>{{ username }}</strong> - your account is activated.

Затем вы можете отправить электронное письмо, используя оба этих шаблона, используя _ 6_, например:

from django.core.mail import EmailMultiAlternatives
from django.template.loader import get_template
from django.template import Context

plaintext = get_template('email.txt')
htmly     = get_template('email.html')

d = Context({ 'username': username })

subject, from_email, to = 'hello', '[email protected]', '[email protected]'
text_content = plaintext.render(d)
html_content = htmly.render(d)
msg = EmailMultiAlternatives(subject, text_content, from_email, [to])
msg.attach_alternative(html_content, "text/html")
msg.send()
person Dominic Rodger    schedule 11.05.2010
comment
Я думаю, вы можете упростить это с помощью render_to_string, что позволит вам потерять отдельные строки, назначающие шаблоны для plaintext и htmly, и просто установить шаблоны и контексты при определении text_content и html_content. - person cms_mgr; 01.05.2013
comment
@cms_mgr Не могли бы вы уточнить, что вы хотите сказать, и как мы можем это использовать? - person akki; 04.08.2014
comment
@akki см. ответ Andi ниже, который также упрощает альтернативную часть благодаря добавлению параметра html_message в send_email () в Django 1.7. - person Mike S; 24.02.2015
comment
Простите меня, но почему мы используем txt и htmly одновременно для почты. Я не понял этой логики - person Shashank Vivek; 21.02.2016
comment
это просто примеры, демонстрирующие разные методы, вы можете использовать любой из них @ShashankVivek - person erdemlal; 21.04.2017
comment
Некоторые старые почтовые клиенты не поддерживают почту в формате HTML, поэтому они будут отображать текстовую версию. См. docs.djangoproject.com/en/2.0/ темы / электронная почта / - person Davy; 19.01.2018
comment
Спасибо за полезный ответ. В настоящее время контекст должен быть только диктовкой. Так что вместо d = Context ({...}) правильный путь - d = {...};) - person Hafnernuss; 13.11.2019
comment
Ответ @Hafnernuss применяется к Django 3.1.5 2021 года с питоном 3.8.5. Не нужно from django.template import Context. Просто сделай d = { 'username': username }. - person Erwol; 02.06.2021

Мальчики и девочки!

Начиная с версии 1.7 Django в методе send_email был добавлен параметр html_message.

html_message: если html_message предоставлен, результирующее электронное письмо будет составным / альтернативным электронным письмом с сообщением в качестве типа содержимого text / plain и html_message в качестве типа содержимого text / html.

Итак, вы можете просто:

from django.core.mail import send_mail
from django.template.loader import render_to_string


msg_plain = render_to_string('templates/email.txt', {'some_params': some_params})
msg_html = render_to_string('templates/email.html', {'some_params': some_params})

send_mail(
    'email title',
    msg_plain,
    '[email protected]',
    ['[email protected]'],
    html_message=msg_html,
)
person andilabs    schedule 12.02.2015
comment
Обратите внимание, если 'email.txt' и 'email.html' находятся в шаблонах каталогов, как определено в настройках, чем просто render_to_string ('email.txt', {'some_params': some_params} _ - person Bruno Vermeulen; 09.01.2019
comment
Спасибо за render_to_string подсказку, очень удобно. - person hoefling; 20.02.2019
comment
Хорошее решение! Однако с send_mail невозможно установить какой-либо настраиваемый заголовок, например, Return-Path, который можно установить с помощью EmailMultiAlternatives's constructor header parameter - person Qlimax; 03.09.2019

Я сделал django-templated-email, чтобы решить эту проблему, вдохновленный этим решение (и необходимость в какой-то момент переключиться с использования шаблонов django на использование набора шаблонов mailchimp и т. д. для транзакционных, шаблонных писем для моего собственного проекта). Тем не менее, это все еще незавершенная работа, но для приведенного выше примера вы бы сделали:

from templated_email import send_templated_mail
send_templated_mail(
        'email',
        '[email protected]',
        ['[email protected]'],
        { 'username':username }
    )

С добавлением следующего в settings.py (для завершения примера):

TEMPLATED_EMAIL_DJANGO_SUBJECTS = {'email':'hello',}

Это будет автоматически искать шаблоны с именами 'templated_email / email.txt' и 'templated_email / email.html' для частей plain и html соответственно в обычных каталогах / загрузчиках шаблонов django (жалуясь, если он не может найти хотя бы один из них) .

person Darb    schedule 16.03.2011
comment
Мне нравится. Я обрезал это и бросил в тикет, чтобы добавить django.shortcuts.send_templated_mail: code.djangoproject.com/ticket/ 17193 - person Tom Christie; 10.11.2011
comment
Круто, рад видеть, что его предлагают в качестве инструмента для ядра django. Мой прецедент / фокус для библиотеки немного больше, чем просто ярлык (простое переключение между почтовыми провайдерами, у которых есть ключ / значение api для отправки почты), но это похоже на отсутствующую функцию в ядре - person Darb; 03.01.2012

Используйте EmailMultiAlternatives и render_to_string, чтобы использовать два альтернативных шаблона (один в виде обычного текста и один в HTML):

from django.core.mail import EmailMultiAlternatives
from django.template import Context
from django.template.loader import render_to_string

c = Context({'username': username})    
text_content = render_to_string('mail/email.txt', c)
html_content = render_to_string('mail/email.html', c)

email = EmailMultiAlternatives('Subject', text_content)
email.attach_alternative(html_content, "text/html")
email.to = ['[email protected]']
email.send()
person Rick Westera    schedule 31.01.2014

Я знаю, что это старый вопрос, но я также знаю, что некоторые люди такие же, как я, и всегда ищут актуальные ответы, поскольку старые ответы иногда могут содержать устаревшую информацию, если не обновляются.

Сейчас январь 2020 года, я использую Django 2.2.6 и Python 3.7

Примечание. Я использую DJANGO REST FRAMEWORK, приведенный ниже код для отправки электронной почты был в модель просмотра в моем views.py

Итак, прочитав несколько хороших ответов, я сделал это.

from django.template.loader import render_to_string
from django.core.mail import EmailMultiAlternatives

def send_receipt_to_email(self, request):

    emailSubject = "Subject"
    emailOfSender = "[email protected]"
    emailOfRecipient = '[email protected]'

    context = ({"name": "Gilbert"}) #Note I used a normal tuple instead of  Context({"username": "Gilbert"}) because Context is deprecated. When I used Context, I got an error > TypeError: context must be a dict rather than Context

    text_content = render_to_string('receipt_email.txt', context, request=request)
    html_content = render_to_string('receipt_email.html', context, request=request)

    try:
        #I used EmailMultiAlternatives because I wanted to send both text and html
        emailMessage = EmailMultiAlternatives(subject=emailSubject, body=text_content, from_email=emailOfSender, to=[emailOfRecipient,], reply_to=[emailOfSender,])
        emailMessage.attach_alternative(html_content, "text/html")
        emailMessage.send(fail_silently=False)

    except SMTPException as e:
        print('There was an error sending an email: ', e) 
        error = {'message': ",".join(e.args) if len(e.args) > 0 else 'Unknown Error'}
        raise serializers.ValidationError(error)

Важно! Так как же render_to_string получить receipt_email.txt и receipt_email.html? В моем settings.py, у меня TEMPLATES и ниже как это выглядит

Обратите внимание на DIRS, там есть строка os.path.join(BASE_DIR, 'templates', 'email_templates'). Эта строка делает мои шаблоны доступными. В моем project_dir у меня есть папка с именем templates и подкаталог с именем email_templates, как этот project_dir->templates->email_templates. Мои шаблоны receipt_email.txt и receipt_email.html находятся в email_templates подкаталоге.

TEMPLATES = [
{
    'BACKEND': 'django.template.backends.django.DjangoTemplates',
    'DIRS': [os.path.join(BASE_DIR, 'templates'), os.path.join(BASE_DIR, 'templates', 'email_templates')],
    'APP_DIRS': True,
    'OPTIONS': {
        'context_processors': [
            'django.template.context_processors.debug',
            'django.template.context_processors.request',
            'django.contrib.auth.context_processors.auth',
            'django.contrib.messages.context_processors.messages',
        ],
    },
},
]

Позвольте мне просто добавить, что мой recept_email.txt выглядит так;

Dear {{name}},
Here is the text version of the email from template

И мой receipt_email.html выглядит так;

Dear {{name}},
<h1>Now here is the html version of the email from the template</h1>
person manpikin    schedule 06.01.2020

Я создал Django Simple Mail, чтобы иметь простой, настраиваемый и многоразовый шаблон для каждого транзакционного электронного письма. вы хотите отправить.

Содержимое и шаблоны писем можно редактировать прямо из администратора django.

В вашем примере вы зарегистрируете свой адрес электронной почты:

from simple_mail.mailer import BaseSimpleMail, simple_mailer


class WelcomeMail(BaseSimpleMail):
    email_key = 'welcome'

    def set_context(self, user_id, welcome_link):
        user = User.objects.get(id=user_id)
        return {
            'user': user,
            'welcome_link': welcome_link
        }


simple_mailer.register(WelcomeMail)

И отправьте это так:

welcome_mail = WelcomeMail()
welcome_mail.set_context(user_id, welcome_link)
welcome_mail.send(to, from_email=None, bcc=[], connection=None, attachments=[],
                   headers={}, cc=[], reply_to=[], fail_silently=False)

Я хотел бы получить любую обратную связь.

person Charlesthk    schedule 10.08.2018
comment
Было бы очень полезно, если бы вы загрузили демонстрационное приложение своего пакета в свое репо. - person ans2human; 06.09.2018
comment
Привет, @ ans2human, спасибо за предложение, добавляю его в список улучшений! - person Charlesthk; 06.09.2018

В примере есть ошибка .... если вы используете его так, как написано, возникает следующая ошибка:

‹Type 'exceptions.Exception'>: объект 'dict' не имеет атрибута 'render_context'

Вам нужно будет добавить следующий импорт:

from django.template import Context

и измените словарь на:

d = Context({ 'username': username })

См. http://docs.djangoproject.com/en/1.2/ref/templates/api/#rendering-a-context

person idbill    schedule 03.01.2011

Django Mail Templated - это многофункциональное приложение Django для отправки электронные письма с системой шаблонов Django.

Установка:

pip install django-mail-templated

Конфигурация:

INSTALLED_APPS = (
    ...
    'mail_templated'
)

Шаблон:

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

{% block body %}
{{ user.name }}, this is the plain text part.
{% endblock %}

Python:

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

Дополнительная информация: https://github.com/artemrizhov/django-mail-templated

person raacer    schedule 05.10.2012
comment
Привет, как я могу установить для всех моих получателей скрытую копию? - person aldesabido; 20.10.2016
comment
@aldesabido Это просто оболочка для стандартного класса EmailMessage Django. Поэтому вам следует прочитать официальную документацию при поиске таких функций: docs.djangoproject.com/ ru / 1.10 / themes / email Также обратите внимание на аналогичный вопрос: stackoverflow.com/questions/3470172/ - person raacer; 20.10.2016
comment
Если быть более точным, стандартное сообщение EmailMessage не упаковывается в оболочку, а наследуется. Т.е. это расширение стандартного класса :) - person raacer; 20.10.2016
comment
Можно ли включить JS / CSS в шаблон? - person Daniels Šatcs; 12.05.2018
comment
Не уверен, что это будет работать для большинства читателей электронной почты, если вы вставите встроенный js / css в тело html, но это возможно, почему бы и нет. - person raacer; 22.05.2018

send_emai() у меня не работал, поэтому я использовал EmailMessage здесь, в django docs.

Я включил две версии ансера:

  1. Только с версией электронной почты html
  2. С обычным текстовым электронным письмом и электронным письмом в формате HTML
from django.template.loader import render_to_string 
from django.core.mail import EmailMessage

# import file with html content
html_version = 'path/to/html_version.html'

html_message = render_to_string(html_version, { 'context': context, })

message = EmailMessage(subject, html_message, from_email, [to_email])
message.content_subtype = 'html' # this is required because there is no plain text email version
message.send()

Если вы хотите включить текстовую версию своего электронного письма, измените приведенное выше следующим образом:

from django.template.loader import render_to_string 
from django.core.mail import EmailMultiAlternatives # <= EmailMultiAlternatives instead of EmailMessage

plain_version = 'path/to/plain_version.html' # import plain version. No html content
html_version = 'path/to/html_version.html' # import html version. Has html content

plain_message = render_to_string(plain_version, { 'context': context, })
html_message = render_to_string(html_version, { 'context': context, })

message = EmailMultiAlternatives(subject, plain_message, from_email, [to_email])
message.attach_alternative(html_message, "text/html") # attach html version
message.send()

Мои версии plain и html выглядят так: plain_version.html:

Plain text {{ context }}

html_version.html

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
 <head>
 ...
 </head>
<body>
<table align="center" border="0" cellpadding="0" cellspacing="0" width="320" style="border: none; border-collapse: collapse; font-family:  Arial, sans-serif; font-size: 14px; line-height: 1.5;">
...
{{ context }}
...
</table>
</body>
</html>
person alkadelik    schedule 25.06.2020
comment
Ваше первое решение подействовало на меня как шарм. Я не хотел иметь ничего общего с файлом txt, поэтому использовал класс EmailMessage. Спасибо за это замечательное решение, приятель! :-) - person Moi Myazz; 16.07.2021

Мне нравится использовать этот инструмент, позволяющий легко отправлять электронные письма в формате HTML и TXT с простой обработкой контекста: https://github.com/divio/django-emailit.

person matinfo    schedule 20.04.2017

Я написал фрагмент, который позволяет отправлять электронные письма, созданные с использованием шаблонов, хранящихся в базе данных. Пример:

EmailTemplate.send('expense_notification_to_admin', {
    # context object that email template will be rendered with
    'expense': expense_request,
})
person Andrii Zarubin    schedule 17.02.2018

Если вам нужны динамические шаблоны электронной почты для вашей почты, сохраните содержимое электронной почты в таблицах базы данных. Это то, что я сохранил как HTML-код в базе данных =

<p>Hello.. {{ first_name }} {{ last_name }}.  <br> This is an <strong>important</strong> {{ message }}
<br> <b> By Admin.</b>

 <p style='color:red'> Good Day </p>

По вашему мнению:

from django.core.mail import EmailMultiAlternatives
from django.template.loader import get_template

def dynamic_email(request):
    application_obj = AppDetails.objects.get(id=1)
    subject = 'First Interview Call'
    email = request.user.email
    to_email = application_obj.email
    message = application_obj.message

    text_content = 'This is an important message.'
    d = {'first_name': application_obj.first_name,'message':message}
    htmly = FirstInterviewCall.objects.get(id=1).html_content #this is what i have saved previously in database which i have to send as Email template as mentioned above HTML code

    open("partner/templates/first_interview.html", "w").close() # this is the path of my file partner is the app, Here i am clearing the file content. If file not found it will create one on given path.
    text_file = open("partner/templates/first_interview.html", "w") # opening my file
    text_file.write(htmly) #putting HTML content in file which i saved in DB
    text_file.close() #file close

    htmly = get_template('first_interview.html')
    html_content = htmly.render(d)  
    msg = EmailMultiAlternatives(subject, text_content, email, [to_email])
    msg.attach_alternative(html_content, "text/html")
    msg.send()

Это отправит динамический HTML-шаблон, который вы сохранили в Db.

person Javed    schedule 26.07.2018