Easy sorting of tables with Django
Project description
webstack-django-sorting allows for easy sorting, and sorting links generation without modifying your views. It is the perfect companion of linaro-django-pagination”,
There are really 5 steps to setting it up with your projects.
List this application in the INSTALLED_APPS portion of your settings file. Your settings file might look something like:
INSTALLED_APPS = ( # ... 'webstack_django_sorting', )
Install the sorting middleware. Your settings file might look something like:
MIDDLEWARE_CLASSES = ( # ... 'webstack_django_sorting.middleware.SortingMiddleware', )
If it’s not already added in your setup, add the ‘request’ context processor:
TEMPLATE_CONTEXT_PROCESSORS = ( 'django.contrib.auth.context_processors.auth', 'django.core.context_processors.debug', 'django.core.context_processors.i18n', 'django.core.context_processors.media', 'django.core.context_processors.static', 'django.core.context_processors.tz', 'django.core.context_processors.request', 'django.contrib.messages.context_processors.messages', )
This example comes from Django 1.6, take care to check against your Django version which context processors are supported (see global_settings.py file of your Django installation).
Add this line at the top of your template to load the sorting tags:
{% load sorting_tags %}
Decide on a variable that you would like to sort, and use the autosort tag on that variable before iterating over it:
{% autosort object_list %}
Now, you want to display different headers with links to sort your objects_list:
<tr> <th>{% anchor first_name _("Name") %}</th> <th>{% anchor creation_date _("Creation") %}</th> </tr>
The first argument is a field or an attribute of the objects list, and the second one (optional) is a title that would be displayed. The previous snippet will be rendered like this in French:
<tr> <th><a href="/path/to/your/view/?sort=first_name" title="Nom">Nom</a></th> <th><a href="/path/to/your/view/?sort=creation_date" title="Création">Création</a></th> </tr>
If your application doesn’t support internationalization, you can use a simple {% anchor first_name Name %}.
That’s it!
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
Hashes for webstack-django-sorting-0.4.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | df0206fe09fca21ae04873edb37801d91952260fc36e6c41459298ba347e86fc |
|
MD5 | 4e50eb9e64f9d71754cf7687d5f42e47 |
|
BLAKE2b-256 | 84a0140984442581bb1390ae49b1226683e8e69b41acab51db42926971fe0f85 |