Poll App for Opps CMS
Project description
opps.polls
=========
Application Poll for Opps
Opps
----
Version: 0.1.x
Features
---------
* Custom urls
* Custom templates
* Single or Multiple choice pool
* Results page
* Hide/Show results page
* Block multiple votes by cookie
* End date and Start date
* Allow images for each choice
* Set min and max allowed choices for voting
Requirements
-----------
Django>1.5
Opps
Instalation
----------
``python setup.py install``
or
``pip install opps-polls``
Configuration
-------------
**App**
Include opps.polls on your django settings
```python
INSTALLED_APPS += (
'opps.polls'
)
```
**URL**
Include in your project urls.py before the opps entry
```python
urlpatterns = patterns('',
...
...
url(r'^poll/', include('opps.polls.urls', namespace='polls', app_name='polls')),
...
url(r'^', include('opps.urls')),
...
...
)
```
Create the tables
```python
python manage.py syncdb
```
You should see:
```
...
Creating table polls_poll
Creating table polls_pollpost
Creating table polls_choice
...
```
Now **opps.polls** is available on your Django admin and you can access the url *http://..../poll/*
Application URLs
----------------
* List all polls
/poll/
* List all polls by channel
/poll/channel/< channel-slug >
* Poll voting page
/poll/< poll-slug >
* Poll results page
/poll/< poll-slug >/results (you can use any word here i.e: /poll/< poll-slug >/resultados)
Application Templates
---------------
For any template the context has the following objects:
* poll (The poll)
* voted (The choices when the user has voted)
* error (A string message when there is some error)
**Default template files**
* polls/pool_list.html (List all polls)
* polls/pool_detail.html (Show details and voting form)
* polls/pool_voted.html (Showed after the user has voted)
* polls/pool_result.html (Results percentage)
* polls/pool_closed.html (Showed when poll is not opened for voting or results)
**Custom template files**
polls will try to find the most specific template to render.
You can choose some ways to force a custom template
In order of precedence:
1. Set **template_path** in each poll object
2. Create a **polls/< channel-slug >/< poll-slug >_<sufix>.html**
3. Create a **polls/< channel-slug >_< sufix >.html**
4. Create a **polls/< poll-slug >_< sufix >.html**
5. Create a **polls/poll_< sufix >.html**
Available sufix are: list, detail, voted, result, closed
Contacts
========
The place to create issues is `polls github issues <https://github.com/opps/opps.poll/issues>`_. The more information you send about an issue, the greater the chance it will get fixed fast.
If you are not sure about something, have a doubt or feedback, or just want to ask for a feature, feel free to join `our mailing list <http://groups.google.com/group/opps-developers>`_, or, if you're on FreeNode (IRC), you can join the chat #opps .
License
=======
Copyright 2013 `YACOWS <http://yacows.com.br/>`_. and other contributors
Licensed under the `MIT License <http://www.oppsproject.org/en/latest/#license>`_
=========
Application Poll for Opps
Opps
----
Version: 0.1.x
Features
---------
* Custom urls
* Custom templates
* Single or Multiple choice pool
* Results page
* Hide/Show results page
* Block multiple votes by cookie
* End date and Start date
* Allow images for each choice
* Set min and max allowed choices for voting
Requirements
-----------
Django>1.5
Opps
Instalation
----------
``python setup.py install``
or
``pip install opps-polls``
Configuration
-------------
**App**
Include opps.polls on your django settings
```python
INSTALLED_APPS += (
'opps.polls'
)
```
**URL**
Include in your project urls.py before the opps entry
```python
urlpatterns = patterns('',
...
...
url(r'^poll/', include('opps.polls.urls', namespace='polls', app_name='polls')),
...
url(r'^', include('opps.urls')),
...
...
)
```
Create the tables
```python
python manage.py syncdb
```
You should see:
```
...
Creating table polls_poll
Creating table polls_pollpost
Creating table polls_choice
...
```
Now **opps.polls** is available on your Django admin and you can access the url *http://..../poll/*
Application URLs
----------------
* List all polls
/poll/
* List all polls by channel
/poll/channel/< channel-slug >
* Poll voting page
/poll/< poll-slug >
* Poll results page
/poll/< poll-slug >/results (you can use any word here i.e: /poll/< poll-slug >/resultados)
Application Templates
---------------
For any template the context has the following objects:
* poll (The poll)
* voted (The choices when the user has voted)
* error (A string message when there is some error)
**Default template files**
* polls/pool_list.html (List all polls)
* polls/pool_detail.html (Show details and voting form)
* polls/pool_voted.html (Showed after the user has voted)
* polls/pool_result.html (Results percentage)
* polls/pool_closed.html (Showed when poll is not opened for voting or results)
**Custom template files**
polls will try to find the most specific template to render.
You can choose some ways to force a custom template
In order of precedence:
1. Set **template_path** in each poll object
2. Create a **polls/< channel-slug >/< poll-slug >_<sufix>.html**
3. Create a **polls/< channel-slug >_< sufix >.html**
4. Create a **polls/< poll-slug >_< sufix >.html**
5. Create a **polls/poll_< sufix >.html**
Available sufix are: list, detail, voted, result, closed
Contacts
========
The place to create issues is `polls github issues <https://github.com/opps/opps.poll/issues>`_. The more information you send about an issue, the greater the chance it will get fixed fast.
If you are not sure about something, have a doubt or feedback, or just want to ask for a feature, feel free to join `our mailing list <http://groups.google.com/group/opps-developers>`_, or, if you're on FreeNode (IRC), you can join the chat #opps .
License
=======
Copyright 2013 `YACOWS <http://yacows.com.br/>`_. and other contributors
Licensed under the `MIT License <http://www.oppsproject.org/en/latest/#license>`_
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
opps-polls-0.1.6.tar.gz
(17.2 kB
view details)
File details
Details for the file opps-polls-0.1.6.tar.gz
.
File metadata
- Download URL: opps-polls-0.1.6.tar.gz
- Upload date:
- Size: 17.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | c78f3ae6df59e074325ca7e1204cfe2d0e30eb9fde11d00bd1a18e5a0305d785 |
|
MD5 | e64701515682735f664f990a01227bcd |
|
BLAKE2b-256 | ec7aa5ce59988c7645da534fa146e8d74e2c82dc3a39d361184439d2fd451801 |