Updated README to provide example of usage of SortableForeignKey.

master
Brandon Taylor 2012-02-24 22:51:22 -06:00
parent 0eb5c86dc8
commit 4e918cbe4b
1 changed files with 6 additions and 9 deletions

15
README
View File

@ -45,27 +45,24 @@ have an inner Meta class that inherits from ``Sortable.Meta``
return self.title return self.title
For models that you want sortable relative to a ``ForeignKey`` field, you need to It is also possible to order objects relative to another object that is a ForeignKey:
specify a property: ``sortable_by`` that is equal to the class defined as your ForeignKey field.
If you're upgrading from a version < 1.2, you do not need to redefine sortable_by.
1.2 is backwards compatible to 1.0.
#admin.py from adminsortable.fields import SortableForeignKey
#models.py
class Category(models.Model): class Category(models.Model):
title = models.CharField(max_length=50) title = models.CharField(max_length=50)
... ...
class MySortableClass(Sortable): class Project(Sortable):
class Meta(Sortable.Meta) class Meta(Sortable.Meta)
category = models.ForeignKey(Category) category = SortableForeignKey(Category)
title = models.CharField(max_length=50) title = models.CharField(max_length=50)
def __unicode__(self): def __unicode__(self):
return self.title return self.title
sortable_by = Category
Sortable has one field: `order` and adds a default ordering value set to `order`. Sortable has one field: `order` and adds a default ordering value set to `order`.