django-simple-poll

django-simple-poll copied to clipboard

Simple Django poll application.

Installation

pip install django-simple-poll

Install latest from github:

pip install -e git+https://github.com/applecat/django-simple-poll.git#egg=django-simple-poll

Requirements

Django 1.10+, Python 2.7, 3.4+

Usage

1. Add 'poll' application in the INSTALLED_APPS settings:

   INSTALLED_APPS = (
       ...
       'poll',
   )
   

2. Add the poll's url to your urls.py.

   urlpatterns = [
       ...
       url(r'^poll/', include('poll.urls')),
   ]
   

3. Run python manage.py migrate

4. Go to site's admin area and create a new poll:

5. Add this tags in your template file to show the poll:

   {% load poll_tags %}
   ...
   {% poll %}
   

6. Check if jQuery is already included on the page. If don't — add it:

<script src="https://code.jquery.com/jquery-3.2.1.min.js"></script>

7. Make vote, see the results:

Customization

Of course, you can (and probably, should) customize Simple Poll's templates. You can simply do this by overriding base.html, poll.html and result.html in templates/poll directory.