Django自带的后台管理是Django明显特色之一,可以让我们快速便捷管理数据。后台管理可以在各个app的admin.py文件中进行控制。以下是我最近摸索总结出比较实用的配置。若你有什么比较好的配置,欢迎补充。
一、基本设置
1、应用注册
若要把app应用显示在后台管理中,需要在admin.py中注册。这个注册有两种方式,我比较喜欢用装饰器的方式。
先看看普通注册方法。打开admin.py文件,如下代码:
1
2
3
4
5
6
7
8
9
|
from
django.contrib
import
admin
from
blog.models
import
Blog
#Blog模型的管理器
class
BlogAdmin(admin.ModelAdmin):
list_display
=
(
'id'
,
'caption'
,
'author'
,
'publish_time'
)
#在admin中注册绑定
admin.site.register(Blog, BlogAdmin)
|
上面方法是将管理器和注册语句分开。有时容易忘记写注册语句,或者模型很多,不容易对应。
还有一种方式是用装饰器,该方法是Django1.7的版本新增的功能:
1
2
3
4
5
6
7
|
from
django.contrib
import
admin
from
blog.models
import
Blog
#Blog模型的管理器
@admin
.register(Blog)
class
BlogAdmin(admin.ModelAdmin):
list_display
=
(
'id'
,
'caption'
,
'author'
,
'publish_time'
)
|
该方式比较方便明显,推荐用这种方式。
2、admin界面汉化
默认admin后台管理界面是英文的,对英语盲来说用起来不方便。可以在settings.py中设置:
- LANGUAGE_CODE = 'zh-CN'
- TIME_ZONE = 'Asia/Shanghai'
1.8版本之后的language code设置不同:
- LANGUAGE_CODE = 'zh-hans'
- TIME_ZONE = 'Asia/Shanghai'
二、记录列表界面设置
记录列表是我们打开后台管理进入到某个应用看到的界面,如下所示:
我们可以对该界面进行设置,主要包括列表和筛选器。
1、记录列表基本设置
比较实用的记录列表设置有显示字段、每页记录数和排序等。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
from
django.contrib
import
admin
from
blog.models
import
Blog
#Blog模型的管理器
@admin
.register(Blog)
class
BlogAdmin(admin.ModelAdmin):
#listdisplay设置要显示在列表中的字段(id字段是Django模型的默认主键)
list_display
=
(
'id'
,
'caption'
,
'author'
,
'publish_time'
)
#list_per_page设置每页显示多少条记录,默认是100条
list_per_page
=
50
#ordering设置默认排序字段,负号表示降序排序
ordering
=
(
'-publish_time'
,)
#list_editable 设置默认可编辑字段
list_editable
=
[
'machine_room_id'
,
'temperature'
]
#fk_fields 设置显示外键字段
fk_fields
=
(
'machine_room_id'
,)
|
此处比较简单,自己尝试一下即可。
另外,默认可以点击每条记录第一个字段的值可以进入编辑界面。
我们可以设置其他字段也可以点击链接进入编辑界面。
1
2
3
4
5
6
7
8
|
from
django.contrib
import
admin
from
blog.models
import
Blog
#Blog模型的管理器
@admin
.register(Blog)
class
BlogAdmin(admin.ModelAdmin):
#设置哪些字段可以点击进入编辑界面
list_display_links
=
(
'id'
,
'caption'
)
|
2、筛选器
筛选器是Django后台管理重要的功能之一,而且Django为我们提供了一些实用的筛选器。
主要常用筛选器有下面3个:
1
2
3
4
5
6
7
8
9
10
11
12
|
from
django.contrib
import
admin
from
blog.models
import
Blog
#Blog模型的管理器
@admin
.register(Blog)
class
BlogAdmin(admin.ModelAdmin):
list_display
=
(
'id'
,
'caption'
,
'author'
,
'publish_time'
)
#筛选器
list_filter
=
(
'trouble'
,
'go_time'
,
'act_man__user_name'
,
'machine_room_id__machine_room_name'
)
#过滤器
search_fields
=
(
'server'
,
'net'
,
'mark'
)
#搜索字段
date_hierarchy
=
'go_time'
# 详细时间分层筛选
|
对应效果如下:
此处注意:
使用 date_hierarchy 进行详细时间筛选的时候 可能出现报错:Database returned an invalid datetime value. Are time zone definitions for your database and pytz installed?
处理方法:
一般ManyToManyField多对多字段用过滤器;标题等文本字段用搜索框;日期时间用分层筛选。
过滤器如果是外键需要遵循这样的语法:本表字段__外键表要显示的字段。如:“user__user_name”
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
from
django.db
import
models
from
django.contrib
import
admin
from
django.utils.html
|