python2.0_day18_django_admin

Django admin的个性化定制
首先我们看下,前面章节中定义的models在admin后台管理界面的样子:

然后我们看下老男孩教育点名平台的admin管理表的后台界面样子:

admin管理后台常用的就是上面操作的这几种吧,我们来看下如何实现?

首先我们知道,使用admin后台管理表,需要将表注册到admins.py文件中:

from django.contrib import admin
# Register your models here.
from app01 import models
admin.site.register(models.Author)    # 注册进来
admin.site.register(models.Book)      # 注册进来
admin.site.register(models.Publisher)

这样就简单实现了图一中的管理界面.
配置成图2中的显示多个字段的管理界面其实也很简单,在admins.py配置文件两步实现:
1.创建一个管理表单的admin类
2.将这个admin类在注册表的时候关联起来.

class BookAdmin(admin.ModelAdmin):
list_display = ('title','publisher','publication_date')  #指定显示的字段

admin.site.register(models.Author)
admin.site.register(models.Book,BookAdmin)  # 注册的时候,把定义的BookAdmin类作为参数传入进来
admin.site.register(models.Publisher)

保存后,访问http://127.0.0.1:8000/admin/app01/book/
结果如下:

这里我们有一点关于显示Book表中定义的关于manytomany关系表的显示.
Django admin后台管理是不支持显示这种many_to_many关系的,如果你配置了,

class BookAdmin(admin.ModelAdmin):
list_display = ('title','authors','publisher','publication_date')  #指定显示的字段

访问时会报如下错误:

<class 'app01.admin.BookAdmin'>: (admin.E109) The value of 'list_display[1]' must not be a ManyToManyField.

为什么呢?
因为一行显示不了多个作者.并且这样显示,效率非常底,因为它要另外一张表一个一个查找出来.多一次查询.

了解了怎么实现个性化定制admin的方法.下面我们定义其他想图2中的配置.

from django.contrib import admin

# Register your models here.
from app01 import models

class BookAdmin(admin.ModelAdmin):
list_display = ('id','title','publisher','publication_date')  #指定显示的字段
search_fields = ('title','publisher__name') #添加搜索字段
# 这里我们定义了两个可以提供搜寻的字段 Book.title 和一个外键表.name
# 我们知道外键关联的是另外一个orm类,如果你想在本张表中通过搜索关联表字段来做帅选,是不是要搜外间表.Django admin里使用publisher__字段名 的方式实现了让你在当前表搜外键表的功能
list_filter = ('publisher','publication_date') # 添加按照字段过滤的关键字list_filter
# 这里外键就可以直接写字段了.
list_editable = ('title','publisher','publication_date')  #让后台界面上可以直接修改字段值的关键字定义list_editable
#这里注意Django admin后台默认显示的第一个表字段是不能修改的.
list_per_page = 10 # 让每页显示几条记录的设置

filter_horizontal = ('authors',)  #只针对多对多
raw_id_fields = ('publisher',)    # 只针对外键的

admin.site.register(models.Author)
admin.site.register(models.Book,BookAdmin)  # 注册的时候,把定义的BookAdmin类作为参数传入进来
admin.site.register(models.Publisher)

首页里显示的东西差不多就这些定制.

访问页面看下效果:

接下来就是点到条目内的个性化定制
filter_horizontal = ('authors',)  #只针对多对多
raw_id_fields = ('publisher',)    # 只针对外键的
我们看下效果:

Django的后台管理只适用内容管理,像监控平台这种不能用admin后台管理!!

Admin Actions
配置admin后台的Admin Actions 来进行批量操作.
假如,Book有一个状态:已出版\待出版\禁书
首先我们先给models.py文件中的Book 类,加一个字段为status,并且这个字段的值只能选择3个状态中的一个

class Book(models.Model):
title = models.CharField(max_length=100)
authors = models.ManyToManyField(Author)
publisher = models.ForeignKey(Publisher)
publication_date = models.DateField()

# 添加状态的选择范围,用户在创建的时候只能从这里选择三个状态
status_choices = (('published',u"已出版"),
('producing',u"待出版"),
('forbidden',u"禁书"),

)
# 前面定义了选项,这里要创建一个字段用到前面的选项
status = models.CharField(choices=status_choices,max_length=32)
def __str__(self):
return "<%s>"%(self.title)

我们完成上面的更改后,在执行同步数据库的操作.这里会碰到一个问题,因为我们是给一个已存在的表添加字段,那么添加之前的记录都没有这个字段,我们添加字段的时候,就要给一个默认值.
如果不给我们在使用命令生成配置文件也会提示我们,让我们设置一个.如:

$ python3.5 manage.py  makemigrations
You are trying to add a non-nullable field 'status' to book without a default; we can't do that (the database needs something to populate existing rows).
Please select a fix:
1) Provide a one-off default now (will be set on all existing rows)
2) Quit, and let me add a default in models.py
Select an option:

那我们最后是在添加status字段的时候定义.如:

class Book(models.Model):
title = models.CharField(max_length=100)
authors = models.ManyToManyField(Author)
publisher = models.ForeignKey(Publisher)
publication_date = models.DateField()

# 添加状态的选择范围,用户在创建的时候只能从这里选择三个状态
status_choices = (('published',u"已出版"),
('producing',u"待出版"),
('forbidden',u"禁书"),

)
# 前面定义了选项,这里要创建一个字段用到前面的选项
status = models.CharField(choices=status_choices,max_length=32,default='producing') #这里加一个default属性
def __str__(self):
return "<%s>"%(self.title)

然后我们在同步数据库,就不会报错了,如:

$ python3.5 manage.py  makemigrations
Migrations for 'app01':
0002_book_status.py:
- Add field status to book
zhoumingdeMacBook-Pro:day18_site tedzhou$ python3.5 manage.py  migrate
Operations to perform:
Apply all migrations: admin, app01, auth, sessions, contenttypes
Running migrations:
Rendering model states... DONE
Applying app01.0002_book_status... OK

然后让status显示在admin管理后台

class BookAdmin(admin.ModelAdmin):
list_display = ('id','title','publisher','publication_date','status')  #把status加入到显示列表
search_fields = ('title','publisher__name') #添加搜索字段
list_filter = ('publisher','publication_date') # 添加按照字段过滤的关键字list_filter
list_editable = ('title','publisher','publication_date','status')  # 把status加入可编辑列表
list_per_page = 10 # 让每页显示几条记录的设置

filter_horizontal = ('authors',) #只针对多对多字段
raw_id_fields = ('publisher',)    # 只针对外键的

admin.site.register(models.Author)
admin.site.register(models.Book,BookAdmin)  # 注册的时候,把定义的BookAdmin类作为参数传入进来
admin.site.register(models.Publisher)

这时候我们访问后台http://127.0.0.1:8000/admin/app01/book/?

然后我们就是如何实现把更高status放到admin Action中,进行批量更改记录了.
两步:都是在admin.py文件里操作
1.定义更改字段的函数
2.在ModelAdmin类里添加actions=[]属性
代码如下:

def make_forbidden(modelAdmin,request,queryset):  #这里必须是三个参数,modelAdmin指的是调用此函数的modelAdmin的类,queryset指的是我们在后台中选中的记录
print('--->',request,queryset)
queryset.update(status='forbidden')
make_forbidden.short_description = "Set to forbidden"   # 定义在action后台中显示的文本内容

class BookAdmin(admin.ModelAdmin):
list_display = ('id','title','publisher','publication_date','status')
search_fields = ('title','publisher__name')
list_filter = ('publisher','publication_date')
list_editable = ('title','publisher','publication_date','status')
list_per_page = 10

filter_horizontal = ('authors',)
raw_id_fields = ('publisher',)
actions = [make_forbidden,] #定义actions属性
admin.site.register(models.Author)
admin.site.register(models.Book,BookAdmin)  # 注册的时候,把定义的BookAdmin类作为参数传入进来
admin.site.register(models.Publisher)

此时我们就可以批量操作记录了http://127.0.0.1:8000/admin/app01/book/

django admin 扩展之根据不同的status状态,显示不同颜色
引入图片010.png
代码如何显示呢?
1.首先要在models.py文件里的Book类里写一个函数如下:

class Book(models.Model):
title = models.CharField(max_length=100)
authors = models.ManyToManyField(Author)
publisher = models.ForeignKey(Publisher)
publication_date = models.DateField()

# 添加状态的选择范围,用户在创建的时候只能从这里选择三个状态
status_choices = (('published',u"已出版"),
('producing',u"待出版"),
('forbidden',u"禁书"),

)
# 前面定义了选项,这里要创建一个字段用到前面的选项
status = models.CharField(choices=status_choices,max_length=32,default='producing')
def __str__(self):
return "<%s>"%(self.title)

# 新Book类中新定义colored_status方法
def colored_status(self):
if self.status == "published":
# format_td = format_html('<span stype="padding:2px;color:white">已报名</span>')
format_td = '<span stype="padding:2px;background-color:yellowgreen;color:white">已出版</span>'
elif self.status == 'producing':
format_td = '<span stype="padding:2px;background-color:pink;color:white">待出版</span>'
elif self.status == 'forbidden':
format_td = '<span stype="padding:2px;background-color:orange;color:white">禁书</span>'

return format_td

2.定义好后,如何在后台中显示该内容呢?在admin里定义的显示列表中直接将此方法加入即可

class BookAdmin(admin.ModelAdmin):
list_display = ('id','title','publisher','publication_date','colored_status','status')  #指定显示的字段

3.然后我们在浏览器访问http://127.0.0.1:8000/admin/app01/book/
显示如下

4.我们看到虽然admin后台中显示新加的字段内容.但是却不是前端的代码,而是一个字符串.这个在Django1.7及以前都是直接解析成前端代码的.而现在我们用的1.9,就需要在models.py文件中定义Book类中方法时调用format_html方法.
代码如下:

from django.utils.html import format_html  # 引入format_html方法
class Book(models.Model):
title = models.CharField(max_length=100)
authors = models.ManyToManyField(Author)
publisher = models.ForeignKey(Publisher)
publication_date = models.DateField()

# 添加状态的选择范围,用户在创建的时候只能从这里选择三个状态
status_choices = (('published',u"已出版"),
('producing',u"待出版"),
('forbidden',u"禁书"),

)
# 前面定义了选项,这里要创建一个字段用到前面的选项
status = models.CharField(choices=status_choices,max_length=32,default='producing')
def __str__(self):
return "<%s>"%(self.title)

def colored_status(self):
if self.status == "published":
format_td = format_html('<span stype="padding:2px;background-color:yellowgreen;color:white">已出版</span>') # 实例化format_html类
elif self.status == 'producing':
format_td = format_html('<span stype="padding:2px;background-color:pink;color:white">待出版</span>')
elif self.status == 'forbidden':
format_td = format_html('<span stype="padding:2px;background-color:orange;color:white">禁书</span>')

return format_td

5.再次访问http://127.0.0.1:8000/admin/app01/book/