Allows Django models to be ordered and provides a simple admin interface for reordering them.
django-ordered-model allows models to be ordered and provides a simple admin interface for reordering them.
- Django >=1.4
$ python setup.py install
Add ordered_model to your SETTINGS.INSTALLED_APPS.
Inherit your model from OrderedModel to make it ordered:
from django.db import models from ordered_model.models import OrderedModel
- class Item(OrderedModel):
name = models.CharField(max_length=100)
- class Meta(OrderedModel.Meta):
Model instances now have a set of methods to move them relative to each other. To demonstrate those methods we create two instances of Item:
foo = Item.objects.create(name=”Foo”) bar = Item.objects.create(name=”Bar”)
### Swap positions
This swaps the position of two objects.
### Move position up on position
Moving an object up or down just makes it swap its position with the neighouring object directly above of below depending on the direction.
### Move to arbitrary position
Move the object to an arbitrary position in the stack. This essentially sets the order value to the specified integer. Objects between the original and the new position get their order value increased or decreased according to the direction of the move.
### Move object above or below reference
Move the object directly above or below the reference object, increasing or decreasing the order value for all objects between the two, depending on the direction of the move.
### Move to top of stack
This sets the order value to the lowest value found in the stack and increases the order value of all objects that were above the moved object by one.
### Move to bottom of stack
This sets the order value to the highest value found in the stack and decreases the order value of all objects that were below the moved object by one.
## Subset Ordering
In some cases, ordering objects is required only on a subset of objects. For example, an application that manages contact lists for users, in a many-to-one/many relationship, would like to allow each user to order their contacts regardless of how other users choose their order. This option is supported via the order_with_respect_to parameter.
A simple example might look like so:
- class Contact(OrderedModel):
- user = models.ForeignKey(User) phone = models.CharField() order_with_respect_to = ‘user’
To add arrows in the admin change list page to do reordering, you can use the OrderedModelAdmin and the move_up_down_links field:
from django.contrib import admin from ordered_model.admin import OrderedModelAdmin from models import Item
- class ItemAdmin(OrderedModelAdmin):
- list_display = (‘name’, ‘move_up_down_links’)