一个django应用程序,允许用户使用易于集成的开发人员api编辑电子邮件内容。
django-emailmessagetemplates的Python项目详细描述
要求
Django电子邮件模板支持Python2.7下的Django版本1.9-1.11。
< div >安装
django电子邮件模板是标准django应用程序。
要将其添加到项目中,只需在 安装的应用程序
如果要对HTML模板使用文本版本自动生成, 在您的安装中包括 文本自动生成 附加功能(例如 pip install django emailmessagetemplates[text\u autogen] )或确保 您已经分别安装了 html2text 。
用法
这个应用程序的核心功能是 emailMessageTemplate类,它是一个django模型,也继承了 来自Django的 emailMultiAlternatives 类。用法派生自 其父项:要选择要发送的模板,请将其作为模型进行查询。到 发送电子邮件,首先用模板上下文填充消息, 然后调用 send 方法。为了 例子:
< dl >从emailMessageTemplates.models导入emailMessageTemplate
t=emailMessageTemplate.objects.get(name='hello world') t.context={'a':'hello','b':'world'} t.to=[ 'michael @ mcoconnor net ',] 附加文件('/docs/hello.pdf') T.()
电子邮件模板支持与 电子邮件多个备选方案,包括 到 , 抄送 , 密件抄送 , 来自电子邮件、标题和附件
HTML/多部分消息
django电子邮件模板可以发送纯文本电子邮件或html 具有纯文本可选内容的格式化邮件。启用HTML 电子邮件,电子邮件模板允许HTML消息设置必须 设置为 true ,并且 emailMessageTemplate 实例必须设置为"html"。纯文本 备选方案可以从呈现的html正文中自动生成 内容(通过html2text库,将消息转换为 标记)或手动维护单独的纯文本正文 模板。
便利功能
Django提供的电子邮件便利功能 消息模板。其中包括 发送邮件 , 发送群发邮件 , 邮件管理员 , 邮件管理员 的用法类似:
< dl >与 电子邮件多个备选方案的区别
而emailMessageTemplate的行为与django的类似 通过电子邮件发送多个备选方案 在许多方面都有一些不同:
- 不能直接设置subject和body值;而是 根据模型中保存的模板构造 指定上下文
- 如果在准备邮件时未指定from_email,则 值首先默认为模板模型上设置的 发送方, 然后转到电子邮件中的默认电子邮件模板设置
- 无法在中设置邮件所需的值(例如收件人) 电子邮件模板的构造函数 电子邮件 实例而不是构造实例)。相反,它们必须被设置 单独在实例上。
- 对于带有HTML的邮件,将自动添加HTML替代项 类型(当应用程序设置允许HTML消息时)。一 还提供了纯文本替代方案,可以从 从HTML内容中分离模板或自动生成。
设置
电子邮件模板默认来自电子邮件
默认值:项目设置中的默认值。
用于从模板发送邮件的默认电子邮件地址。这个 可以通过设置 发送方在每个模板的基础上重写 模板模型实例上的字段。它可以在 通过在 实例化的 emailMessagetemaple 对象或使用 from\u email 任何便利函数的参数。
电子邮件模板允许HTML消息
默认值:false
如果为true,模板可以生成html格式的消息并提供 纯文本替代内容。将显示启用此选项 django管理表单中的其他字段,并将启用html 生成 类型为 文本/html 的模板
历史记录
0.1.3(2019-5-11)
- django 1.11的更新
0.1.2(2016-5-6)
- django的更新>;=1.9
0.1.1(2015-3-19)
- 修复打包错误
- 添加南方初始迁移
0.1.0(2015-3-18)
- pypi上的第一个版本。