面向django的模板/事务电子邮件抽象
django-templated-email-fork的Python项目详细描述
====
django模板电子邮件分叉
==
:信息:一个面向django的模板电子邮件发送类
:作者:bradley whittington(http://github.com/bradwittington,http://twitter.com/darb)
:测试:…图片::https://api.travis ci.org/bradwittington/django templated email.png
overview
========
这是django templated email的一个分支,用于django 1.8+。
所有信用证归原始作者所有。
django templated email面向发送模板电子邮件
用于事务处理mailers(支持mailchimpsts、
和postageapp),但作为一个默认的后端类,它使用django的
模板系统和django的core.mail函数。库支持
模板继承,添加cc'd和bcc'd收件人,可配置
模板命名和位置,通过在后端/提供程序之间轻松切换,
send_templated_email方法可以被视为电子邮件的呈现到_响应的快捷方式。
Getting Going-installation
==
安装::
pip install django templated email fork
它的工作原理如下:
templated_email_backend='templated_email.backends.vanilla_django.templated backend'
您可以使用快捷方式版本
templated_email_backend='templated_email.backends.vanilla django'
您还可以直接使用来自templated_email.backends.vanilla django的类
导入模板后端
templated_email_backend=templated backend
模板“name=”欢迎“,
来自电子邮件“from@example.com”,
收件人列表=['to@example.com',
上下文={
“用户名”:请求。用户。用户名,
“全名”:请求。用户。获取全名(),
“注册日期”:请求。用户。加入日期
,
#可选:
cc=['cc@example.com'],
bcc=['bcc@example.com'],
您可以使用**获取模板的电子邮件**,它将返回一个django**emailMessage**对象,该对象使用**香草的django**后端准备:
to=['to@example.com'],
context={
“用户名”:request.user.user name,
“全名”:request.user.get_full_name(),
“注册日期”:request.user.date_joined
,
可选:
cc=['cc@example.com'],
bcc=['bcc@example.com'],
headers={'my-custom-header':'custom value'},
template_prefix=“my_emails/”,
template_suffix=“email”,
您还可以使用**cc=['example@example.com'****来**cc**和**bcc**收件人。有些后端有其他可以覆盖的参数,请参见下文。
{%block plain%}
hi{{full_name},
r/>用户名:{{username}
加入日期:{{signup}
谢谢,摇滚!
{%endblock%}
如果要在电子邮件中包含html部分,只需使用“html”块:
{%block html%}
<;p>;您好{{{全名},<;p>;
<;p>;您刚刚注册了我的网站,使用:
<;dl>;
<;dt>;用户名<;dt>;<;dd>;{{username}<;dd>;
<;dt>;加入日期<;dt>;<;dl>;
<;p>;
<;p>;谢谢,摇滚!<;/p>;
{%endblock%}
确保在每次调用**发送模板的电子邮件**时,**Vanilla_Django**和**MailChimp_Sts**后端都有一个尾随斜杠
如果要将一组模板存储在其他目录中。记住要包含一个尾随斜杠。
请注意/警告模板继承
----
模板继承有非常基本的支持(使用**{%扩展…%}**在模板中)。如果您使用**{{block.super}**,您将遇到问题,并将导致电子邮件的空白部分。
legacy behavior
--
<0.2.x版本的库在django模板目录/加载程序中查找了**模板的电子邮件/welcome.txt**:
网站,使用:
用户名:{{username}
加入日期:{{signup}
谢谢,摇滚!
它将使用**模板化的电子邮件/welcome.html**作为电子邮件的html部分,让您可以使它变得非常漂亮。
未来计划
----
请参见https://github.com/bradwittington/django-templated-email/issues?state=open
应用程序本地的模板(虽然加载程序将在以下位置找到您的电子邮件模板:如果您将它们存储在*<;您的应用程序>;/模板/模板电子邮件*,但如果**模板电子邮件模板目录**未被过度隐藏)
*如果您(而且您应该)为**模板目录**设置了值,请记住包含一个斜杠,即.*我的应用程序的电子邮件/'*
*部署的应用程序可能使用不同的后端,该后端不使用django模板后端,因此请在自述文件中注明警告开发人员,如果他们已经使用django模板后端的电子邮件,则使用不同的后端,他们需要确保他们的电子邮件提供商可以发送您的所有模板(最好是在方便的地方枚举这些模板)
在特定后端上的注释:
==
默认情况下,它假定以下设置(如果您希望覆盖这些设置):
**{%block subject%}**在模板中)::
/>
此外,您还可以调用**send_templated_mail**,并可以选择重写以下参数:
使用模板目录
模板后缀='email';覆盖电子邮件模板的文件扩展名(或者,使用文件扩展名)
cc=['fubar@example.com']\其中,该方法查找电子邮件模板
connection=your嫒connection嫒take a django mail backend connection,created using**django.core.mail.get嫒connection**
auth嫒u user=”username'嫒覆盖django mail backend使用的用户,per**django.core.mail.send嫒mail**
auth嫒password'#根据**django.core.mail.send廑mail**
使用postagapp:
----
重写django邮件后端使用的密码以使用postagapp(http://postagapp.com)发送方法,您将需要安装python postagepp::
pip install-e git://github.com/bradwittington/python postagepp.git egg=postagepp
并将以下内容添加到您的设置中。py::
=“yourapikey”
你需要使用我的叉子):<
pip install-e git://github.com/nitinhayaran/greatape.git egg=greatape
并将以下内容添加到你的设置中。py:
>maillimb-api-api-api-key='yourapikey''yourapikey'
结束具体来说,
模板化的电子邮件@u mailcimp={
“欢迎”:{
“主题”:“欢迎访问我的网站”,
“曲目打开”:true,
“曲目单击”:false,
“标记”:[“我的”,“小的”,“小马”],
}
}
mailcimp sts发件人使用与vanilladjango后端相同的模板处理器,因此您可以全局覆盖以下设置:
调用*send_templated_mail*
时重写*template_dir*变量。_ Django:http://djangoproject.com
django模板电子邮件分叉
==
:信息:一个面向django的模板电子邮件发送类
:作者:bradley whittington(http://github.com/bradwittington,http://twitter.com/darb)
:测试:…图片::https://api.travis ci.org/bradwittington/django templated email.png
overview
========
这是django templated email的一个分支,用于django 1.8+。
所有信用证归原始作者所有。
django templated email面向发送模板电子邮件
用于事务处理mailers(支持mailchimpsts、
和postageapp),但作为一个默认的后端类,它使用django的
模板系统和django的core.mail函数。库支持
模板继承,添加cc'd和bcc'd收件人,可配置
模板命名和位置,通过在后端/提供程序之间轻松切换,
send_templated_email方法可以被视为电子邮件的呈现到_响应的快捷方式。
Getting Going-installation
==
安装::
pip install django templated email fork
它的工作原理如下:
templated_email_backend='templated_email.backends.vanilla_django.templated backend'
您可以使用快捷方式版本
templated_email_backend='templated_email.backends.vanilla django'
您还可以直接使用来自templated_email.backends.vanilla django的类
导入模板后端
templated_email_backend=templated backend
模板“name=”欢迎“,
来自电子邮件“from@example.com”,
收件人列表=['to@example.com',
上下文={
“用户名”:请求。用户。用户名,
“全名”:请求。用户。获取全名(),
“注册日期”:请求。用户。加入日期
,
#可选:
cc=['cc@example.com'],
bcc=['bcc@example.com'],
您可以使用**获取模板的电子邮件**,它将返回一个django**emailMessage**对象,该对象使用**香草的django**后端准备:
to=['to@example.com'],
context={
“用户名”:request.user.user name,
“全名”:request.user.get_full_name(),
“注册日期”:request.user.date_joined
,
可选:
cc=['cc@example.com'],
bcc=['bcc@example.com'],
headers={'my-custom-header':'custom value'},
template_prefix=“my_emails/”,
template_suffix=“email”,
您还可以使用**cc=['example@example.com'****来**cc**和**bcc**收件人。有些后端有其他可以覆盖的参数,请参见下文。
{%block plain%}
hi{{full_name},
r/>用户名:{{username}
加入日期:{{signup}
谢谢,摇滚!
{%endblock%}
如果要在电子邮件中包含html部分,只需使用“html”块:
{%block html%}
<;p>;您好{{{全名},<;p>;
<;p>;您刚刚注册了我的网站,使用:
<;dl>;
<;dt>;用户名<;dt>;<;dd>;{{username}<;dd>;
<;dt>;加入日期<;dt>;<;dl>;
<;p>;
<;p>;谢谢,摇滚!<;/p>;
{%endblock%}
确保在每次调用**发送模板的电子邮件**时,**Vanilla_Django**和**MailChimp_Sts**后端都有一个尾随斜杠
如果要将一组模板存储在其他目录中。记住要包含一个尾随斜杠。
请注意/警告模板继承
----
模板继承有非常基本的支持(使用**{%扩展…%}**在模板中)。如果您使用**{{block.super}**,您将遇到问题,并将导致电子邮件的空白部分。
legacy behavior
--
<0.2.x版本的库在django模板目录/加载程序中查找了**模板的电子邮件/welcome.txt**:
网站,使用:
用户名:{{username}
加入日期:{{signup}
谢谢,摇滚!
它将使用**模板化的电子邮件/welcome.html**作为电子邮件的html部分,让您可以使它变得非常漂亮。
未来计划
----
请参见https://github.com/bradwittington/django-templated-email/issues?state=open
应用程序本地的模板(虽然加载程序将在以下位置找到您的电子邮件模板:如果您将它们存储在*<;您的应用程序>;/模板/模板电子邮件*,但如果**模板电子邮件模板目录**未被过度隐藏)
*如果您(而且您应该)为**模板目录**设置了值,请记住包含一个斜杠,即.*我的应用程序的电子邮件/'*
*部署的应用程序可能使用不同的后端,该后端不使用django模板后端,因此请在自述文件中注明警告开发人员,如果他们已经使用django模板后端的电子邮件,则使用不同的后端,他们需要确保他们的电子邮件提供商可以发送您的所有模板(最好是在方便的地方枚举这些模板)
在特定后端上的注释:
==
默认情况下,它假定以下设置(如果您希望覆盖这些设置):
**{%block subject%}**在模板中)::
/>
此外,您还可以调用**send_templated_mail**,并可以选择重写以下参数:
使用模板目录
模板后缀='email';覆盖电子邮件模板的文件扩展名(或者,使用文件扩展名)
cc=['fubar@example.com']\其中,该方法查找电子邮件模板
connection=your嫒connection嫒take a django mail backend connection,created using**django.core.mail.get嫒connection**
auth嫒u user=”username'嫒覆盖django mail backend使用的用户,per**django.core.mail.send嫒mail**
auth嫒password'#根据**django.core.mail.send廑mail**
使用postagapp:
----
重写django邮件后端使用的密码以使用postagapp(http://postagapp.com)发送方法,您将需要安装python postagepp::
pip install-e git://github.com/bradwittington/python postagepp.git egg=postagepp
并将以下内容添加到您的设置中。py::
=“yourapikey”
你需要使用我的叉子):<
pip install-e git://github.com/nitinhayaran/greatape.git egg=greatape
并将以下内容添加到你的设置中。py:
>maillimb-api-api-api-key='yourapikey''yourapikey'
结束具体来说,
模板化的电子邮件@u mailcimp={
“欢迎”:{
“主题”:“欢迎访问我的网站”,
“曲目打开”:true,
“曲目单击”:false,
“标记”:[“我的”,“小的”,“小马”],
}
}
mailcimp sts发件人使用与vanilladjango后端相同的模板处理器,因此您可以全局覆盖以下设置:
调用*send_templated_mail*
时重写*template_dir*变量。_ Django:http://djangoproject.com