Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

This library is aimed to simplify creation of user sorted lists.

Project description


This library is aimed to simplify creation of user sorted lists.
Inspired by


1. Install with pip or

2. Add ordered_listview into `INSTALLED_APPS`. ::

INSTALLED_APPS += ['ordered__listview']

3. Add template tags lib into builtins. ::

add_to_builtins('ordered_listview.templatetags.ordered_listview') // Or load with {% load ordered_listview %}

4. Inherit your view from `OrderedListView`. And setup your ordering fields. ::

from ordered_listview import OrderedListView

class UserListView(OrderedListView):
allowed_order_by = [
('username', _('Login')),
('userfile__file__size', _('Size')),
('date_joined', _('Sing up date'))
default_order_by = 'created'

5. Add a tag into you your template. ::

{% include "ordered_listview/fields.html" %}


1. To change get attribute name, just set `OrderedListView.order_by` attribute ::

class UserListView(OrderedListView):
order_by = "order_by"

2. If you need to provide your own template create inside your `templates`
`ordered_listview` directory with `fields.html` and `field.html` in.

fields.html - list of sortable fields
field.html - order field and state template

3. If you want to ignore null values during sort, add fields to null_ignore_fields.

class UserListView(OrderedListView):
null_ignore_fields = ['quantity']

class UserListView(OrderedListView):
null_ignore_fields = '*' # For all fields

Project details

Release history Release notifications

This version
History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
django-ordered-listview-0.0.2.tar.gz (2.3 kB) Copy SHA256 hash SHA256 Source None Nov 22, 2013

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page