opps-polls 0.1.6

opps.polls
=========

Opps的应用投票


Opps
----

版本： 0.1.x


功能
---------
* 自定义URL
* 自定义模板
* 单选或多选题
* 结果页面
* 隐藏/显示结果页面
* 通过cookie阻止多次投票
* 结束日期和开始日期
* 允许每个选项使用图片
* 设置投票的最小和最大选项

要求
-----------
Django>1.5
Opps

安装
----------
``python setup.py install``

或

``pip install opps-polls``

配置
-------------

**应用**

在 Django 设置中包含 opps.polls

```python
INSTALLED_APPS += (
'opps.polls'
)
```

**URL**

在项目 urls.py 中 opps 条目之前包含

```python
urlpatterns = patterns('',
...
...
url(r'^poll/', include('opps.polls.urls', namespace='polls', app_name='polls')),
...
url(r'^', include('opps.urls')),
...
...
)
```

创建表

```python
python manage.py syncdb
```
你应该会看到

```
...
创建表 polls_poll
创建表 polls_pollpost
创建表 polls_choice
...
```

现在 **opps.polls** 在你的 Django 管理后台可用，你可以访问 URL *http://..../poll/*

应用 URL
----------------

* 列出所有投票
/poll/
* 按频道列出所有投票
/poll/channel/< channel-slug >
* 投票页面
/poll/< poll-slug >
* 投票结果页面
/poll/< poll-slug >/results (你可以使用任何词，例如：/poll/< poll-slug >/resultados)

应用模板
---------------

对于任何模板，上下文具有以下对象

* poll (投票)
* voted (用户投票时的选项)
* error (出现错误时的字符串消息)

**默认模板文件**

* polls/pool_list.html (列出所有投票)
* polls/pool_detail.html (显示详细信息和投票表单)
* polls/pool_voted.html (用户投票后显示)
* polls/pool_result.html (结果百分比)
* polls/pool_closed.html (投票或结果未开放时显示)


**自定义模板文件**

polls 将尝试找到最具体的模板进行渲染。
你可以选择一些方法来强制使用自定义模板
优先级顺序

1. 在每个投票对象中设置 **template_path**
2. 创建 **polls/< channel-slug >/< poll-slug >_<sufix>.html**
3. 创建 **polls/< channel-slug >_< sufix >.html**
4. 创建 **polls/< poll-slug >_< sufix >.html**
5. 创建 **polls/poll_< sufix >.html**

可用的后缀有：list、detail、voted、result、closed


联系方式
========
创建问题的位置是 `polls github issues <https://github.com/opps/opps.poll/issues>`_. 你发送的关于问题的信息越多，它被快速修复的机会就越大。

如果你对某事不确定，有疑问或反馈，或者只是想要请求一个功能，请随意加入 `我们的邮件列表 <http://groups.google.com/group/opps-developers>`_，或者，如果你在 FreeNode (IRC) 上，你可以加入 chat #opps .


许可证
=======

版权 2013 `YACOWS <http://yacows.com.br/>`_ 和其他贡献者

根据 `MIT 许可证 <http://www.oppsproject.org/en/latest/#license>`_ 许可