Fixed #15746. Clarified updated list_filter documentation.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@16010 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Simon Meers 2011-04-03 23:08:48 +00:00
parent fd309996df
commit e301899392
1 changed files with 7 additions and 5 deletions

View File

@ -531,17 +531,19 @@ subclass::
list_display = ('username', 'email', 'first_name', 'last_name', 'is_staff') list_display = ('username', 'email', 'first_name', 'last_name', 'is_staff')
list_filter = ('is_staff', 'is_superuser') list_filter = ('is_staff', 'is_superuser')
Fields in ``list_filter`` can also span relations using the ``__`` lookup::
class UserAdminWithLookup(UserAdmin):
list_filter = ('groups__name')
The above code results in an admin change list page that looks like this: The above code results in an admin change list page that looks like this:
.. image:: _images/users_changelist.png .. image:: _images/users_changelist.png
(This example also has ``search_fields`` defined. See below.) (This example also has ``search_fields`` defined. See below.)
.. versionadded:: 1.3
Fields in ``list_filter`` can also span relations using the ``__`` lookup::
class UserAdminWithLookup(UserAdmin):
list_filter = ('groups__name')
.. attribute:: ModelAdmin.list_per_page .. attribute:: ModelAdmin.list_per_page
Set ``list_per_page`` to control how many items appear on each paginated Set ``list_per_page`` to control how many items appear on each paginated