本例基于以下 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',)
二者的区别就在于水平显示还是垂直显示。