Drag-and-drop ordering for objects and inlines in Django admin using django-suit.
Project description
Drag-and-drop ordering for objects and inlines in Django admin using [django-suit](https://github.com/darklow/django-suit).
- ## Installation
pip install -e git://github.com/JP74/django-suit-sortable.git#egg=suit_sortable
## Configuration
Add suit_sortable to your INSTALLED_APPS.
Ensure django.core.context_processors.static is in your TEMPLATE_CONTEXT_PROCESSORS.
To use suit_sortable you must do following:
In your models.py file add integer property for sortable to you model:
from django.db import models
- class Category(models.Model):
… position = models.PositiveIntegerField()
### Adding Sortable to an existing model
If you’re adding Sorting to an existing model, it is recommended that you use [django-south](http://south.areacode.com/) to create a schema migration to add the “position” field to your model. You will also need to create a data migration in order to add the appropriate values for the position column.
Example assuming a model named “Category”:
- def forwards(self, orm):
- for index, category in enumerate(orm.Category.objects.all()):
category.position = index + 1 category.save()
### Django Admin Integration To enable sorting in the admin, you need to inherit from SortableAdmin and add a list_editable column for the position field:
from django.contrib import admin from myapp.models import MySortableClass from suit_sortable.admin import SortableAdmin
- class MySortableAdminClass(SortableAdmin):
list_display = (…, ‘position’,) list_editable = (‘position’,) “””Any other admin options you need go here”””
admin.site.register(MySortableClass, MySortableAdminClass)
To enable sorting on TabularInline models, you need to inherit from SortableTabularInline:
from suit_sortable.admin import SortableTabularInline
- class MySortableTabularInline(SortableTabularInline):
“””Your inline options go here”””
To enable sorting on StackedInline models, you need to inherit from SortableStackedInline:
from suit_sortable.admin import SortableStackedInline
- class MySortableStackedInline(SortableStackedInline):
“””Your inline options go here”””
### Limitations
Since sortables are based on JavaScript solution, there are known limitations:
It doesn’t work with pagination.
History
0.1.0 (2013-08-15)
First release on Github.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file django-suit-sortable-0.1.0.tar.gz
.
File metadata
- Download URL: django-suit-sortable-0.1.0.tar.gz
- Upload date:
- Size: 16.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 45b17bce6ffc0351d70df463d0af202f33579ba2f98aef7aeac40dc08d4e28ca |
|
MD5 | b37d00ac6bdab4405ff7051a9a207cf1 |
|
BLAKE2b-256 | fa68e3413f45b07eac3885358ba5cd4f7f48800278f9ed608a1eb301e286396f |