Django snippets: Alphabetic filter for admin

# Authors: Marinho Brandao <marinho at gmail.com>
#          Guilherme M. Gondim (semente) <semente at taurinus.org>
# File: <your project>/admin/filterspecs.py

from django.db import models
from django.contrib.admin.filterspecs import FilterSpec, ChoicesFilterSpec
from django.utils.encoding import smart_unicode
from django.utils.translation import ugettext as _

class AlphabeticFilterSpec(ChoicesFilterSpec):
    """
    Adds filtering by first char (alphabetic style) of values in the admin
    filter sidebar. Set the alphabetic filter in the model field attribute
    'alphabetic_filter'.

    my_model_field.alphabetic_filter = True
    """

    def __init__(self, f, request, params, model, model_admin):
        super(AlphabeticFilterSpec, self).__init__(f, request, params, model,
                                                   model_admin)
        self.lookup_kwarg = '%s__istartswith' % f.name
        self.lookup_val = request.GET.get(self.lookup_kwarg, None)
        values_list = model.objects.values_list(f.name, flat=True)
        # getting the first char of values
        self.lookup_choices = list(set(val[0] for val in values_list if val))
        self.lookup_choices.sort()

    def choices(self, cl):
        yield {'selected': self.lookup_val is None,
                'query_string': cl.get_query_string({}, [self.lookup_kwarg]),
                'display': _('All')}
        for val in self.lookup_choices:
            yield {'selected': smart_unicode(val) == self.lookup_val,
                    'query_string': cl.get_query_string({self.lookup_kwarg: val}),
                    'display': val.upper()}
    def title(self):
        return _('%(field_name)s that starts with') % \
            {'field_name': self.field.verbose_name}

# registering the filter
FilterSpec.filter_specs.insert(0, (lambda f: getattr(f, 'alphabetic_filter', False),
                                   AlphabeticFilterSpec))

This snippet is based on #748.

Adds filtering by first char (alphabetic style) of values in the admin filter sidebar. The example below results in this filter:

By name that starts with
 All
 A
 B
 G
 M
 X

urls.py example (only for register the filter):

import <your project>.admin.filterspecs

models.py example:

from django.db import models

class Person(models.Model):
    name = models.CharField(max_length=40)
    name.alphabetic_filter = True

admin.py example:

class Admin:
    list_filter = ['name']

Author:: semente
Posted:: September 12, 2008
Language:: Python
Tags:: admin filter filterspec
Score:: 5 (after 5 ratings)

Tools

Comments

magicrebirth (on April 23, 2009):

super!

magicrebirth (on May 13, 2009):

Line 55 is better changed like this:

self.lookup_choices = list(set(val[0] for val in values_list if val))

BY adding 'if val' it prevents the routine to crash when indexing items that are blank!

semente (on May 29, 2009):

snippet updated.

magicrebirth, thanks for the tip.

urosh (on August 12, 2009):

Request Method: GET Request URL: http://vi/voip/phonebook/ Exception Type: TypeError Exception Value:

'long' object is unsubscriptable

bradmontgomery (on January 14, 2010):

Thanks! This is very helpful.

Django snippets

Alphabetic filter for admin

Tools

Comments

Snippets

About