本例基于以下 model：

from django.db import models
import datetime

STATUS_CHOICES = (
    ('d', 'Draft'),
    ('p', 'Published'),
    ('w', 'Withdrawn'),
)

class Article(models.Model):
    title = models.CharField(max_length=100)
    body = models.TextField()
    pub_date = models.DateTimeField(default=datetime.datetime.now())
    status = models.CharField(max_length=1, choices=STATUS_CHOICES)
    author = models.ManyToManyField('Author')

    def __str__(self):
        return self.title


class Author(models.Model):
    name = models.CharField(max_length=100)

    def __str__(self):
        return self.name

ModelAdmin 的可选项

actions

自定义管理操作方法，即：

详细信息请看下一篇：自定义管理操作（actions ）

date_hierarchy

在 model 中的 DateField 或 DateTimeField 的字段使用 date_hierarchy ，管理界面会出现一个基于这个日期字段的导航菜单，可以通过这个菜单筛选特定日期的条目。

注意，这里有一个坑，第一次使用时会出现以下错误：

This query requires pytz, but it isn't installed.

首先我们需要安装 pytz 这个库：

pip install pytz

然后把 settings.py 中的 USE_TZ = True 修改为 USE_TZ = False

在 admin.py 中的 ModelAdmin 设置：

# pub_date 是你在 Model 设置的使用 DateField 或 DateTimeField 的字段
date_hierarchy = 'pub_date'

管理界面将会显示日期选项：

exclude / fields

这两个选项用来控制管理界面某条目详情页面要出现哪些内容。

如果我们的 Model 有以下几个字段：title、body 、pub_date 、status。

如果只想让 title 和 pub_date 出现在管理界面，可以使用 **fields ** 来设置 ModelAdmin：

fields = ('title', 'pub_date')

如果想改变 fields 显示的顺序，改变 fields 的元组中的参数顺序即可：

fields = ('pub_date', 'title')

要在同一行显示多个字段，把这些字段打包在同一个元组里即可：

fields = (('title', 'body'), 'pub_date',)

如果不想某个字段出现，则可以使用 exclude 来设置：

exclude = ('body',)

fieldsets

fieldsets 能让我们更自由地去设置管理界面的内容。

fieldsets 的格式是一个二元元组：(name, field_options)，其中 name 是一个字符串表示 fieldset 的标题， field_options 是一个关于 fieldset 的字典。

以下是一个简单例子：

fieldsets = (
        ('标题与内容', {'fields': ('title', 'body'), },),
        ('状态', {'fields': ('status',), },),
        ('发布日期', {'fields': ('pub_date',), },), 
        )

管理界面将变成这样：

field_options 字典有以下关键字：

fields

控制哪些字段显示在管理界面上，以及控制其显示顺序，此键必选。

**classes **

为管理器添上额外的 CSS 样式。

description

为管理界面添加描述。

下面是一个改进后的例子：

fieldsets = (
        ('标题与内容', {'fields': ('title', 'body'), },),
        ('状态', {'fields': ('status',), },),
        ('发布日期', {
            'fields': ('pub_date',),
            'classes': ('collapse',),  # 为管理器添上额外的 CSS 样式
            'description': ('发布日期而非最新修改日期',)  # 为管理界面添加描述
            },),
        )

管理界面将变成这样（只修改了发布日期，所以只截图日期相关的页面）：

filter_horizontal / filter_vertical

当使用 ManyToManyField 时，会在管理站点上显示一个<select multiple>.（多选框），但是，当选择多个时多选框非常难用。这时候使用 filter_horizontal 或 filter_vertical 将会出现一个基于 JavaScript 的“过滤器”界面，使选择变得易用。

Article 有一个 ManyToManyField 外键指向 Author，字段名为 author，我们来使用 filter_horizontal 来看看效果：

filter_horizontal = ('author',)

管理界面给我们提供了一个搜索框来快速找到要找的作者。

再来试试 filter_vertical：

filter_vertical = ('author',)

二者的区别就在于水平显示还是垂直显示。