django-simple-ratings 0.2.0

a simple, extensible rating system.<br />With a little bit more<br /><br />also, a playground for different stuff i've been reading about in programming collective intelligence, by toby segaran.<br /><br />this stuff lives in utils.py and is there if you want to experiment (or contribute!).<br />Getting started<br /><br />you'd like to add ratings to some model:<br /><br />from django.db import models<br />from rating.models import Ratings<br /><br />class Food(models.Model):<br /> name = models.CharField(max_length=50)<br /><br /> ratings = Ratings()<br /><br />now, you can:<br /><br /># add ratings to things<br />>>> apple.ratings.rate(user=john, score=1)<br /><RatedItem: apple rated 1 by john><br /><br />>>> apple.ratings.rate(user=jane, score=5)<br /><RatedItem: apple rated 5 by jane><br /><br /># get interesting aggregate data<br />>>> apple.ratings.all()<br />[<RatedItem: apple rated 1 by john>, <RatedItem: apple rated 5 by jane>]<br /><br />>>> apple.ratings.cumulative_score()<br />6<br /><br />>>> apple.ratings.average_score()<br />3.0<br /><br /># order things by their rating<br />>>> Food.ratings.order_by_rating()<br />[<Food: apple>, <Food: orange>]<br /><br />Use GFKs, FKs, whatever<br /><br />By default, whenever you add Ratings() to your model it uses the RatedItem model which has a GFK on it. Suppose you are only rating one thing, or would like to have an explicit database constraint -- that's no problem. You can provide a custom RatedItem model with a ForeignKey instead of a GFK. Here's the example from the tests:<br /><br />class BeverageRating(RatedItemBase):<br /> content_object = models.ForeignKey('Beverage')<br /><br /><br />class Beverage(models.Model):<br /> name = models.CharField(max_length=50)<br /><br /> ratings = Ratings(BeverageRating)<br /><br /> def __unicode__(self):<br /> return self.name<br /><br />The API is exactly the same.<br /><br />#md5=572cb4ce063604a4818c67d4e91f1d4b

Requirements:	No special requirements
Platforms:	*nix, Linux
Keyword:	Apple,  Appleratingsaverage Score,  Import,  Model,  Modelscharfieldmax Length,  Order,  Rated,  Rateditem,  Rating,  Ratinggtgtgt,  Ratings,  Stuff,  Suppose,  Thing,  Things,  Whateverby
Users rating:	0/10