Django最大的优点之一,就是体贴的为你提供了一个基于项目model创建的一个后台管理站点admin。这个界面只给站点管理员使用,并不对大众开放。
1. 创建管理员用户
(django) E:\Django\mysite>python manage.py createsuperuser Username (leave blank to use 'administrator'): #输入管理员名字 Email address:输入邮箱,可为空# Password:#密码 Password (again):#再一次输入密码 Superuser created successfully.
创建完成以后开启django服务了,访问http://127.0.0.1:8000/admin/ 出现如下
输入账号密码,你就可以登录django后台了
它仅有两个默认的管理-编辑模块:用户组(Groups)和用户(Users)。
Django设置后台中文面板和时区
Django还有一个很棒的功能,它自带了多种语言的翻译
在settings.py的MIDDLEWARE_CLASSES 下,最后一行添加'django.middleware.locale.LocaleMiddleware',即可显示中文的后台界面
除此之外我们还要设置一下时间的同步,在settings.py中修改以下这两个配置
TIME_ZONE = 'Asia/Shanghai' USE_TZ = False
USE_TZ设置为True时,Django会使用系统默认设置的时区,即America/Chicago,我们要设置为False
TIME_ZONE = 'Asia/Shanghai'即为上海UTC时间
现在我们进入用户下的管理员你会发现时间已经是上海UTC时间了,不会显示相差8小时了
将你的Models加入到Admin管理中
打开myapp下的admin.py设置如下
from django.contrib import admin from myapp.models import Publisher, Author, Book admin.site.register(Publisher) admin.site.register(Author) admin.site.register(Book)
这些代码通知管理工具为这些模块逐一提供界面。
刷新一下后台你会发现多了一个app项和一些列表,这些都是你在模型中定义的数据
自定义列表
这个页面应该提供便利,比如说:在这个列表中可以看到作者的邮箱地址。如果能按照姓氏或名字来排序,那就更好了。
为了达到这个目的,我们将为Author模块定义一个ModelAdmin类。 这个类是自定义管理工具的关键,其中最基本的一件事情是允许你指定列表中的字段。 打开admin.py并修改:
class AuthorAdmin(admin.ModelAdmin): list_display = ('email','first_name', 'last_name') admin.site.register(Publisher) admin.site.register(Author,AuthorAdmin) admin.site.register(Book)
解释一下代码:
我们新建了一个类AuthorAdmin,它是从django.contrib.admin.ModelAdmin派生出来的子类,保存着一个类的自定义配置,以供管理工具使用。 我们只自定义了一项:list_display, 它是一个字段名称的元组,用于列表显示。 当然,这些字段名称必须是模块中有的。
我们修改了admin.site.register()调用,在Author后面添加了AuthorAdmin。你可以这样理解: 用AuthorAdmin选项注册Author模块。
admin.site.register()函数接受一个ModelAdmin子类作为第二个参数。 如果你忽略第二个参数,Django将使用默认的选项。Publisher和Book的注册就属于这种情况。
这时你发现在每个列上都可以点击进行排序了
快速查询栏
向AuthorAdmin追加search_fields,如:
class AuthorAdmin(admin.ModelAdmin): list_display = ('email','first_name', 'last_name') search_fields = ('first_name', 'last_name')#追加的
这时的anthor出现了一个搜索框,可以搜索匹配的 first_name 和 last_name信息
过滤器
Django为日期型字段提供了快捷过滤方式,它包含:今天、过往七天、当月和今年。这些是开发人员经常用到的。
class BookAdmin(admin.ModelAdmin): list_display = ('title', 'publisher', 'publication_date') list_filter = ('publication_date',)#这里要以元组添加,不能去掉末尾的的逗号,否则报错
过滤器如下图显示:
另外一种过滤日期的方式是使用date_hierarchy选项,如:
class BookAdmin(admin.ModelAdmin): list_display = ('title', 'publisher', 'publication_date') list_filter = ('publication_date',) date_hierarchy = 'publication_date'
效果如下:
修改好后,页面中的列表顶端会有一个逐层深入的导航条, 它从可用的年份开始,然后逐层细分到月乃至日。
改变默认的排序方式
例如按publication date降序排列:
class BookAdmin(admin.ModelAdmin): list_display = ('title', 'publisher', 'publication_date') list_filter = ('publication_date',) date_hierarchy = 'publication_date' ordering = ('-publication_date',)
效果如下:(右上角多了一个小箭头显示排序)
自定义编辑表单
更改编辑顺序
class BookAdmin(admin.ModelAdmin): list_display = ('title', 'publisher', 'publication_date') list_filter = ('publication_date',) date_hierarchy = 'publication_date' ordering = ('-publication_date',) fields = ('publisher', 'title', 'authors', 'publication_date')#这里我们更换了编辑表单的顺序
效果如下:
隐藏编辑字段
class BookAdmin(admin.ModelAdmin): list_display = ('title', 'publisher', 'publication_date') list_filter = ('publication_date',) date_hierarchy = 'publication_date' ordering = ('-publication_date',) fields = ('publisher', 'title', 'authors')#这里少了publication_date字段,我们将不会在表单编辑中看到
效果如下:
因为我们在模型中设置了null=True,所以Django会将publication_date设置为None,以确保这个字段满足null=True的条件。
表单多选框过滤器
管理站点将每个ManyToManyField表示为多选框,这是最合乎逻辑的HTML输入小部件,但多选框可能很难使用。
我们使用filter_horizontal解决这个问题:
class BookAdmin(admin.ModelAdmin): list_display = ('title', 'publisher', 'publication_date') list_filter = ('publication_date',) date_hierarchy = 'publication_date' ordering = ('-publication_date',) fields = ('title','publisher', 'authors') filter_horizontal = ('authors',)#需要填入一个元组,注意最后要逗号
效果如下:
你会看到Authors中有一个精巧的JavaScript过滤器,它允许你检索选项,然后将选中的authors从Available框移到Chosen框,还可以移回来。
ModelAdmin类还支持filter_vertical选项。 它像filter_horizontal那样工作,除了控件都是垂直排列,而不是水平排列的。 至于使用哪个,只是个人喜好问题。
filter_vertical效果图:
filter_horizontal 和 filter_vertical选项只能用在多对多字段 上, 而不能用于 ForeignKey字段。
下拉框改为文本框
class BookAdmin(admin.ModelAdmin): list_display = ('title', 'publisher', 'publication_date') list_filter = ('publication_date',) date_hierarchy = 'publication_date' ordering = ('-publication_date',) fields = ('title','publisher', 'authors') filter_vertical = ('authors',) raw_id_fields = ('publisher',)#将publisher外键的下拉框改为文本框
效果如下:
你在这个输入框里输入什么? 发布者的数据库ID。 鉴于人类通常不会记住数据库ID,还有一个放大镜图标,您可以单击以拉出弹出窗口,您可以从中选择要添加的发布者。