django-lime 0.3

先决条件

• Django 1.5.+

• Python 2.7.+, 3.3.+

安装

1. 在虚拟环境中安装

   $ pip install django-lime

2. 将lime添加到Django settings模块的INSTALLED_APPS中

>>> INSTALLED_APPS = (
>>>     # ...
>>>     'lime',
>>>     # ...
>>> )
>>>
>>> LIME_SITE_LOGO = 'img/logo.png' # Relative path to logo
>>> LIME_SITE_TEAM = ugettext("Example site team") # Team name (see the base email template)

3. 将lime中的模板复制到您的主模板目录。

4. 在您的settings模块中定义变量LIME_SITE_LOGO和LIME_SITE_TEAM。

5. 确保您的django.contrib.sites.models.Site具有合理的数据，因为site_name和domain值将从那里获取。或者，您可以在settings模块中定义（覆盖）以下变量。

   • LIME_SITE_NAME

   • LIME_SITE_DOMAIN

使用示例

从lime基本模板继承您的应用模板或您的lime模板副本（复制到templates目录）。默认情况下，以下参数传递给您的模板

• site_name：从您的django.contrib.sites.models.Site获取。

• 域名：来自您的 django.contrib.sites.models.Site

• site_team：站点团队名称。

• site_logo：站点标志的相对URL。

发送混合内容电子邮件就像以下这样简单。

• subject（str）：电子邮件主题。

• from_email（str）：发件人电子邮件。

• to（str或list）：要发送电子邮件的电子邮件或电子邮件列表。

• context（dict）：您想在电子邮件模板中访问的变量。

• plain_template（str）：纯模板名称。

• html_template（str）：HTML模板名称。

• bcc（str或list）：作为BCC发送电子邮件的电子邮件或电子邮件列表。

>>> from lime import send_email
>>>
>>> send_email(
>>>     subject = _("You've got mail"),
>>>     from_email = 'ramzes.4@example.come', # From
>>>     to = 'someone.else@example.com', # To
>>>     context = {
>>>         'date_submitted': datetime.datetime.now().strftime("%Y-%m-%dT%H:%M:%S"),
>>>         'url': 'http://example.com/check-this-fantastic-link.html',
>>>         'full_name': 'John Doe',
>>>         'from_name': 'Ramzes the 4th',
>>>     },
>>>     plain_template = 'foo/emails/foo_test.txt', # Text template
>>>     html_template = 'foo/emails/foo_test.html' # HTML tempalte
>>> )

运行示例项目

有关工作示例（包括设置Django环境），请查看 https://bitbucket.org/barseghyanartur/django-lime（example 目录）。

1. 转到 example/example 目录

   $ cd example/example

2. 安装需求（在您的虚拟环境中）

   $ pip install -r requirements.txt

3. 将 local_settings.example 复制到 local_settings.py

   $ cp local_settings.example local_settings.py

4. 创建数据库

   $ ./manage.py syncdb

5. 运行项目

   $ ./manage.py runserver

许可证

GPL 2.0/LGPL 2.1

支持

如有任何问题，请联系作者部分中提供的电子邮件。

作者

Artur Barseghyan <artur.barseghyan@gmail.com>