Django admin自定制功能

提示：扫一扫查出行
【扫一扫了解最新限行尾号】
复制提示

一：基础设置

1、应用注册

1）方式一

若要把app应用显示在后台管理中，需要在admin.py中注册。打开admin.py文件，如下代码：

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)

2）方式二

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'

二：admin后台管理界面自定制方法

初始界面：

对admin界面进行“改造”：

1、记录列表基本设置

比较实用的记录列表设置有显示字段、每页记录数和排序等。

class BookAdmin(admin.ModelAdmin):
# listdisplay设置要显示在列表中的字段（id字段是Django模型的默认主键）
list_display = ('id', 'name', 'price', 'pub_date',"publish") # list_per_page设置每页显示多少条记录，默认是100条
list_per_page = 50 # ordering设置默认排序字段，负号表示降序排序
ordering = ('-price',) # list_editable 设置默认可编辑字段
list_editable = ['price'] # fk_fields 设置显示外键字段
fk_fields = ('publish_id',) # 设置其他字段也可以点击链接进入编辑界面。
list_display_links = ("id",'name')

2、筛选器

筛选器是Django后台管理重要的功能之一，而且Django为我们提供了一些实用的筛选器。

主要常用筛选器有下面3个：

# 筛选器
list_filter = ("name","publish__name",) # 过滤器
search_fields = ('id', 'name', 'price', 'pub_date',"publish") # 搜索字段
date_hierarchy = 'pub_date' # 详细时间分层筛选

此处注意：

使用 date_hierarchy 进行详细时间筛选的时候可能出现报错：Database returned an invalid datetime value. Are time zone definitions for your database and pytz installed?

处理方法：

命令行直接执行此命令： [root@mysql ~]# mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -u root mysql

然后重启数据库即可。

一般ManyToManyField多对多字段用过滤器；标题等文本字段用搜索框；日期时间用分层筛选。

过滤器如果是外键需要遵循这样的语法：本表字段__外键表要显示的字段。如：“user__user_name”

3、颜色显示

想对某些字段设置颜色，可用下面的设置：

from django.db import models
from django.contrib import admin
from django.utils.html import format_html class Person(models.Model):
first_name = models.CharField(max_length=50)
last_name = models.CharField(max_length=50)
color_code = models.CharField(max_length=6) def colored_name(self):
return format_html(
'<span style="color: #{};">{} {}</span>',
self.color_code,
self.first_name,
self.last_name,
) class PersonAdmin(admin.ModelAdmin):
list_display = ('first_name', 'last_name', 'colored_name')

实际代码（注意看上面代码，是写在models里，而不是admin中的ModelAdmin里）：

效果：

但是，我们看到标题并不是我们想要的，那么如何设置标题呢？

添加一行代码：colored_status.short_description = u"状态"

在函数结束之后添加上面代码即可

4.调整页面头部显示内容和页面标题

class MyAdminSite(admin.AdminSite):
site_header = '好医生运维资源管理系统' # 此处设置页面显示标题
site_title = '好医生运维' # 此处设置页面头部标题 admin_site = MyAdminSite(name='management')

需要注意的是： admin_site = MyAdminSite(name='management') 此处括号内name值必须设置，否则将无法使用admin设置权限，至于设置什么值，经本人测试，没有影响。

注册的时候使用admin_site.register，而不是默认的admin.site.register。

效果如下：

后经网友提示发现也可以这样：

from django.contrib import admin
from hys_operation.models import * # class MyAdminSite(admin.AdminSite):
# site_header = '好医生运维资源管理系统' # 此处设置页面显示标题
# site_title = '好医生运维'
#
# # admin_site = MyAdminSite(name='management')
# admin_site = MyAdminSite(name='adsff')
admin.site.site_header = '修改后'
admin.site.site_title = '哈哈'

不继承 admin.AdminSite 了，直接用admin.site 下的 site_header 和 site_title 。