Django新手指南(4)

lampeter123

于 2009-09-18 14:05:46 发布

阅读量130

点赞数

分类专栏： Django 文章标签： Django 配置管理 HTML

Django 专栏收录该内容

8 篇文章

订阅专栏

本文介绍如何通过Django内置功能定制管理界面，包括添加、显示和编辑模型对象，以及定制列表展示、过滤、搜索和日期分组等功能。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

编写你的第一个Django程序，第二部分(下）

添加关系对象

现在我们就有了Poll的管理页面了。但是Poll对应的是多个Choice，而管理页面里并没有显示Choice。我们有两种方法来解决这个问题。第一种就想刚才我们注册Poll的管理功能一样，很容易就能实现：

from mysite.polls.models import Choice

admin.site.register(Choice)

现在Django管理后台中“Choices”也出现了。“Add choice”表单看起来就像下面这样：

在这个表单中，“Poll”字段对应一个包含数据库内所有投票记录的选择框。Django知道在管理界面中应该用选择框来表示外键关系。在我们的案例中，这里只会有一个投票。

注意一下“Poll”旁边的“Add Another”链接。每个有外键关系的对象都会有这个链接。点击“Add Another”，会有一个“Add poll”的弹出窗口显示。当你添加数据点击“Save”后，Django会向数据库添加一条新纪录，并将刚才添加的纪录加入到“Add choice”选择框中。

但是，这实在不是一个有效地添加Choice纪录的方法。如果在添加Poll记录的时候能够直接添加批量的Choice纪录是更好的方式。

移除掉Choice模型的register()方法调用，然后修改Poll的管理模型的代码：

class ChoiceInline(admin.StackedInline):

model = Choice

extra = 3

class PollAdmin(admin.ModelAdmin):

fieldsets = [

(None, {'fields': ['question']}),

('Date information', {'fields': ['pub_date'], 'classes': ['collapse']}),

]

inlines = [ChoiceInline]

admin.site.register(Poll, PollAdmin)

上面的代码告诉Django：“在Poll的管理界面编辑Choice，预留3个Choice的空位。”

现在重新加载“Add poll”页面来看看：

现在管理页面上多了3个Choice的输入框——这是有extra字段定制的——当你在“Change”页面修改一个已经存在的数据时，除了已有的Choice之外，也有3个输入框。

但是还有一个小问题。Choice输入框占用的空间太大了。Django还有一种以表格形式显示的方法，你只需要把ChoiceInline做一下修改就可以了：

class ChoiceInline(admin.TabularInline):

#...

ChoiceInline改成继承自TabularInline（取代了原来的StackedInline），现在输入框显得更加紧凑了：

定制列表界面

现在Poll的管理页面看起来不错了，下面我们来改善改善“change list”页面。

下面是现在的列表页面：

默认情况下，Django显示的是对所有对象进行str()处理后的结果。但是如果我们能够显示字段名称的话就更直观了。在管理模型中加入list_display字段，这字段是元组类型，字段的元素就是要在列表页面上要显示的数据库字段的名称。

class PollAdmin(admin.ModelAdmin):

# ...

list_display = ('question', 'pub_date')

另外，我们也要加上在第一部分中提到的was_published_today方法：

class PollAdmin(admin.ModelAdmin):

# ...

list_display = ('question', 'pub_date', 'was_published_today')

现在页面看起来就像这样：

你可以点击表头列来进行排序——除了was_published_today这一列，因为并不支持根据方法排序。还要注意到表头上默认情况下显示的就是方法名（下划线会被空格替换）。你可以添加方法的short_description属性来改变这个显示值：

def was_published_today(self):

return self.pub_date.date() == datetime.date.today()

was_published_today.short_description = 'Published today?'

现在加上给Poll的列表页面坐垫改进：筛选。在PollAdmin类中加入下面的代码：

list_filter = ['pub_date']

右边多了个“Filter”边栏，现在用户可以根据pub_date字段对数据做筛选了。

显示的筛选类型是根据筛选字段的类型决定的。pub_date是DateTimeField类型，Django知道对应的筛选选项："Any date"、 "Today"、 "Past 7 days"、 "This month"、 "This year"。

现在来加上搜索的功能：

search_fields = ['question']

上面的代码会在列表页面的上方加上搜索框。输入搜索词时，Django会根据搜索词在question字段进行匹配。你喜欢用多少字段查询都可以——但是为了数据库性能，尽量合理地使用字段，因为在底层部分搜索使用的是LIKE查询。

最后，因为Poll对象有日期字段，根据日期来对纪录进行分层是很便捷的。加上下面这一行：

date_hierarchy = 'pub_date'

现在在列表页面的上方加上了基于日期的分级导航功能。在最高级，显示所有的年份，然后详细显示所有有记录的月份和天。

在列表页面还有分页功能。默认每页显示50条纪录。列表页面的分页、搜索、筛选、日期分组和表头列排序功能都能和谐地一起工作。

定制管理页面外观

显而易见，在管理页面的上方显示“Django Administration”是有点雷人的。其实这里只是一段占位文字而已，可以进行替换。

使用Django的模板系统可以很容易的修改。Django管理后台是由Django自身生成的，使用Django自身的模版系统就可以修改界面。

打开配置文件（mysite/settings.py），看到TEMPLATE_DIRS设置。TEMPLATE_DIRS是由一串文件路径组成的元组，在读取Django模板时会依次检查这些路径。

默认情况下TEMPLATE_DIRS是空的，所以我们加上一行代码告诉Django模板文件放在哪里：

TEMPLATE_DIRS = (

"/home/my_username/mytemplates", # Change this to your own directory.

)

现在从Django默认的管理后台模板路径（django/contrib/admin/templates）下拷贝admin/base_site.html文件到TEMPLATE_DIRS中任何一个目录的admin子目录下。比如你的TEMPLATE_DIRS包含“/home/my_username/mytemplates”，按照上面所说的，拷贝django/contrib/admin/templates/admin/base_site.html到/home/my_username/mytemplates/admin/base_site.html，不要忘了admin子目录。然后编辑文件，根据你的需要把原来的文本替换成你自己站点的名字。