django-welcome 0.3.0


django-welcome
==============

通过在用户注册后发送个人欢迎消息，为您的用户提供出色的客户服务。

快速开始
------------

0. 安装django-welcome

```python
pip install django-welcome
```

1. 将 "welcome" 添加到您的 INSTALLED_APPS 设置中，如下所示

```python
INSTALLED_APPS = (
...
'welcome',
)
```

3. 在您的本地设置中定义 WELCOME_FROM_EMAIL

```python
WELCOME_FROM_EMAIL = '您的姓名 <yourname@project.tld>'
```

4. 为您的电子邮件创建模板。这些模板位于 %%TEMPLATE_DIR%%/email/welcome.tpl。如果您想获取用户的完整姓名或其他个人资料信息，这些模板可以访问名为 _user_ 的用户对象。请记住包含对用户重要信息！包括一条个人消息，也许是一个反馈调查的链接，以及您的个人联系信息（电子邮件/Twitter/电话号码），以便客户可以直接联系您。

5. 使用 manage.py 执行它。_since_ 定义了自注册以来发送给新用户的分钟数，默认值为 60。

```bash
./manage.py welcome --since 60
```

6. 定义一个cron作业来自动执行它！

通知
---------

django-welcome 还可以用于向管理员发送有关新用户的常规通知。可以通过发送所有新用户的联系信息来发送摘要电子邮件。

1. 要启用此功能，您首先需要定义另一个设置

```python
NOTIFICATION_TO_EMAIL = '您的名字 <yourname@project.tld>'
```

2. 然后创建您的模板。这些模板位于与欢迎信息相同的电子邮件模板目录中，名称为
%%TEMPLATE_DIR%%/email/notify.tpl。示例模板可以在本包的源代码中找到。

3. 最后，使用 --notify 参数运行欢迎命令。（注意，此命令也会发送欢迎邮件。）

```bash
./manage.py welcome --notify
```

模板化
---------

django-welcome 使用 [django-mail-templated](https://github.com/artemrizhov/django-mail-templated) 来发送 HTML 邮件。示例在本包的源代码中可用，包括一个使用预编译的 [ModernMail](https://github.com/patrickocoffeyo/ModernMail) 模板来模拟 Twitter-Bootstrap 的示例。

这些模板允许您定义邮件的主题和正文，因此对于多部分（包括纯文本和 HTML）的邮件，您可以这样做

{% block subject %}
欢迎，{{ user.username }}！
{% endblock %}

{% block body %}
我们只是想感谢您加入我们的网站。
{% endblock %}

{% block html %}
我们只是想感谢您加入我们的网站。
{% endblock %}

选项
---------

```bash
用法：manage.py welcome [选项]

查找在过去 X 分钟内注册的用户（默认 60 分钟）并向他们发送电子邮件。

在 **TEMPALTE_DIR**/email/welcome.tpl 和 **TEMPALTE_DIR**/email/notify.tpl 中定义您的电子邮件模板

您还必须在设置文件中定义 WELCOME_FROM_EMAIL 和 NOTIFICATION_TO_EMAIL。

示例

./manage.py welcome --since 60

选项
--since=SINCE 自注册以来的分钟数。默认 60。
--test 测试运行（代替发送最老用户的邮件）。默认 False。
--dry 干运行，实际上不发送电子邮件。默认 False。
--quiet 安静发送电子邮件。默认 False。
--notify 通知管理员新用户信息。默认
False。
```