django-support-form 0.1.0

# django-support-form

[](https://travis-ci.org/cbmi/django-support-form)
[](https://coveralls.io/r/cbmi/django-support-form?branch=master)

Django应用的简单联系/支持表单。

## 安装

```bash
pip安装django-support-form
```

## 设置

将 `supportform` 添加到 `INSTALLED_APPS` 中，并包括以下Django contrib应用

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

将 `supportform.urls` 包含在 `ROOT_URLCONF` 中

```python
from django.conf.urls import url, patterns, include

urlpatterns = patterns('',
url(r'^support/', include('supportform.urls')),
...
)
```

## 设置

- `SUPPORT_EMAIL` - 支持电子邮件将发送到的接收者电子邮件地址，例如 'support@example.com'。默认为 `DEFAULT_FROM_EMAIL` Django设置。
- `SUPPORT_EMAIL_SUBJECT` - 默认电子邮件主题，预先填充在支持表单中。默认为 '支持信息'。
- `SUPPORT_WAIT_SEND` - 等待电子邮件成功发送。如果设置为false，电子邮件将在后台（通过线程）发送。默认 `True`

## 模板

django-supportform附带的功能模板，但非常简单

- `supportform/form.html` - 渲染支持表单，如果用户已登录则省略电子邮件字段。提交时如果电子邮件发送失败，将显示一个回退消息，直接将电子邮件发送到 `SUPPORT_EMAIL`。
- 接收到的上下文
- `form` - `SupportForm` 实例
- `supportform/success.html` - 渲染静态成功/感谢页面。这是发送消息成功后重定向到的页面。
接收到的上下文：（无）

还提供了一个电子邮件模板，也可以进行自定义。

- `supportform/email_body.txt`
- 接收到的上下文
- `message` - 用户留下的消息
- `request` - 请求对象
- `user` - 如果消息是由已认证用户留下的