Commit c1692fa2 authored by Tim Graham's avatar Tim Graham
Browse files

[1.6.x] Fixed #22547 -- Added some links to tutorial 2.

Thanks bjb at sourcer.ca for the suggestion.

Backport of b0d032f9 from master
parent 2a0f942c
Loading
Loading
Loading
Loading
+15 −7
Original line number Diff line number Diff line
@@ -193,7 +193,8 @@ up into fieldsets::

    admin.site.register(Poll, PollAdmin)

The first element of each tuple in ``fieldsets`` is the title of the fieldset.
The first element of each tuple in
:attr:`~django.contrib.admin.ModelAdmin.fieldsets` is the title of the fieldset.
Here's what our form looks like now:

.. image:: _images/admin08t.png
@@ -323,8 +324,9 @@ Here's what it looks like at this point:

By default, Django displays the ``str()`` of each object. But sometimes it'd be
more helpful if we could display individual fields. To do that, use the
``list_display`` admin option, which is a tuple of field names to display, as
columns, on the change list page for the object::
:attr:`~django.contrib.admin.ModelAdmin.list_display` admin option, which is a
tuple of field names to display, as columns, on the change list page for the
object::

    class PollAdmin(admin.ModelAdmin):
        # ...
@@ -361,7 +363,9 @@ attributes, as follows::
        was_published_recently.short_description = 'Published recently?'

Edit your :file:`polls/admin.py` file again and add an improvement to the Poll
change list page: Filters. Add the following line to ``PollAdmin``::
change list page: filters using the
:attr:`~django.contrib.admin.ModelAdmin.list_filter` attribute. Add the
following line to ``PollAdmin``::

    list_filter = ['pub_date']

@@ -387,9 +391,13 @@ scenes, limiting the number of search fields to a reasonable number will make
it easier for your database to do the search.

Now's also a good time to note that change lists give you free pagination. The
default is to display 100 items per page. Change-list pagination, search boxes,
filters, date-hierarchies and column-header-ordering all work together like you
think they should.
default is to display 100 items per page. :attr:`Change-list pagination
<django.contrib.admin.ModelAdmin.list_per_page>`, :attr:`search boxes
<django.contrib.admin.ModelAdmin.search_fields>`, :attr:`filters
<django.contrib.admin.ModelAdmin.list_filter>`, :attr:`date-hierarchies
<django.contrib.admin.ModelAdmin.date_hierarchy>`, and
:attr:`column-header-ordering <django.contrib.admin.ModelAdmin.list_display>`
all work together like you think they should.

Customize the admin look and feel
=================================