面向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

欢迎加入QQ群-->: 979659372 Python中文网_新手群

推荐PyPI第三方库


热门话题
java IntelliJ找不到依赖项选项卡   java向字符串数组string[]添加元素并在Junit中测试结果   如何在eclipse中获取活动java项目的名称   如何使用java在mysql中插入时间   java ArrayList更新了插入一行,但Jtable仍然没有刷新   如何在JavaSwing中命名坐标(点)   java Matcher/模式不打印   java错误地设置了arraylist   使用UsernamePasswordCredential提供程序的java列表Azure AD   java在HTTP请求中设置UTC时间   未加载事件:jquery完整日历Java集成   java Maven插件依赖项无法从内部repo解析依赖项   Maven更新重置Java版本   java如何向中添加图片。带有Apache POI XWPF的docx,但不指定其大小   Java最大函数递归