django-vote 1.1.0

A simple Django app to conduct vote.

=====
Vote
=====

Vote is a simple Django app to conduct vote for each model


Quick start
-----------

1. Install ``django-vote`` by pip::

pip install django-vote

2. Add ``'vote'`` to your ``INSTALLED_APPS`` setting like this::

INSTALLED_APPS = (
...
'vote',
)

3. Run ``python manage.py syncdb`` to create the vote models.


4. Declare vote field to the model you want to vote::

from vote.managers import VotableManager

class ArticleReview(models.Model):
...
votes = VotableManager()

5. Use vote API::

>>> review = ArticleReview.objects.get(pk=1)
>>> review.votes.up(user)
>>> review.votes.down(user)

API
-----------

up(user)
==========
Adds a new vote to the object

down(user)
==========
Removes vote to the object

exists(user)
============
Check if the user already voted the object

all(user)
=========
return all instances voted by user

count()
=======
Returns the number of votes for the object

users()
=======
Returns a list of users who voted and their voting date

filter()
=======
add extra info to original queryset