django-sortedm2m 0.3.0

django-sortedm2m is a drop in replacement for Django's own ManyToManyField. The provided SortedManyToManyField behaves like the original one but remembers the order of added relations.<br /><br />sortedm2m requires at least django 1.2. Django 1.1 or earlier is not supported.<br /><br />Usecases<br /><br />Imagine that you have a gallery model and a photo model. Usually you want a relation between these models so you can add multiple photos to one gallery but also want to be able to have the same photo on many galleries.<br /><br />This is where you usually can use many to many relation. The downside is that django's default implementation doesn't provide a way to order the photos in the gallery. So you only have a random ordering which is not suitable in most cases.<br /><br />You can work around this limitation by using the SortedManyToManyField provided by this package as drop in replacement for django's ManyToManyField.<br /><br />Usage<br /><br />Use SortedManyToManyField like ManyToManyField in your models:<br /><br />from django.db import models<br />from sortedm2m.fields import SortedManyToManyField<br /><br />class Photo(models.Model):<br /> name = models.CharField(max_length=50)<br /> image = models.ImageField(upload_to='...')<br /><br />class Gallery(models.Model):<br /> name = models.CharField(max_length=50)<br /> photos = SortedManyToManyField(Photo)<br /><br />If you use the relation in your code like the following, it will remember the order in which you have added photos to the gallery.<br /><br />gallery = Gallery.objects.create(name='Photos ordered by name')<br />for photo in Photo.objects.order_by('name'):<br /> gallery.photos.add(photo)<br /><br />Admin<br /><br />SortedManyToManyField provides a custom widget which can be used to sort the selected items. It renders a list of checkboxes that can be sorted by drag'n'drop.<br /><br />It's also possible to use the SortedManyToManyField with admin's raw_id_fields option in the ModelAdmin definition. Add the name of the SortedManyToManyField to this list to get a simple text input field. The order in which the ids are entered into the input box is used to sort the items of the sorted m2m relation.<br /><br />Example:<br /><br />from django.contrib import admin<br /><br />class GalleryAdmin(admin.ModelAdmin):<br /> raw_id_fields = ('photos',)<br /><br />#md5=cbbdcff4703eb425457adb7cc64af450

Requirements:	No special requirements
Platforms:	*nix, Linux
Keyword:	Added,  Django,  Gallery,  Import,  Input,  Items,  Manytomanyfield,  Model,  Modelscharfieldmax Length,  Modelsfrom,  Order,  Photo,  Photos,  Provided,  Raw Fields,  Relation,  Replacement,  Sorted,  Sortedmanytomanyfield
Users rating:	0/10