Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Drag'n'drop support to reorder objects in the Django admin panel, both with and without Grappelli

This branch is 21 commits ahead of ff0000:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
sortable
.gitignore
AUTHORS
LICENSE
MANIFEST.in
README.md
setup.py

README.md

Quick start guide

Download

Using pip:

pip install sortable

Using git:

git clone git://github.com/ff0000/django-sortable.git
cd django-sortable
python setup.py install

or download the package from github.com/ff0000/django-sortable.

Installation

Open settings.py and add sortable to your INSTALLED_APPS:

INSTALLED_APPS = (
  [...],
  'sortable',
)

You can decide whether the new instances position is at beginning or at ending (defaults to True) defining SORTABLE_DEFAULT_AT_END in your settings:

SORTABLE_DEFAULT_AT_END = False

Reordering instances of a model with drag-and-drop in the admin

To add the sortable feature a model called Article do the following:

Edit app/articles/models.py changing models.Model with Sortable:

from sortable.models import Sortable

class Article(Sortable):
  # here the model fields, Meta, etc.

If Meta is present, inherit from Sortable.Meta:

# Old version
class Meta:
# New version
class Meta(Sortable.Meta):

Edit app/articles/admin.py changing admin.ModelAdmin with SortableAdmin:

from sortable.admin import SortableAdmin

class ArticleAdmin(SortableAdmin):
  # here the admin stuff
Something went wrong with that request. Please try again.