SingleDiego
SingleDiego

ModelAdmin 的可选项

本例基于以下 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

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

ModelAdmin 的可选项_第1张图片

详细信息请看下一篇：自定义管理操作（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'

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

ModelAdmin 的可选项_第2张图片



exclude / fields

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

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

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

fields = ('title', 'pub_date')
ModelAdmin 的可选项_第3张图片

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

fields = ('pub_date', 'title')
ModelAdmin 的可选项_第4张图片

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

fields = (('title', 'body'), 'pub_date',)
ModelAdmin 的可选项_第5张图片

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

exclude = ('body',)
ModelAdmin 的可选项_第6张图片



fieldsets

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

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

以下是一个简单例子：

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

管理界面将变成这样：

ModelAdmin 的可选项_第7张图片

field_options 字典有以下关键字：

  • fields

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

  • **classes **

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

  • description

为管理界面添加描述。

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

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

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

ModelAdmin 的可选项_第8张图片



filter_horizontal / filter_vertical

当使用 ManyToManyField 时，会在管理站点上显示一个