Django admin自定制功能

2022-03-15 06:11:13

一：基础设置

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 。

更加简单方便，容易理解。唯一的区别就是这种方法是登录http://ip/admin/

站点和用户组在一起

三、编辑界面设置

编辑界面是我们编辑数据所看到的页面。我们可以对这些字段进行排列设置等。

若不任何设置，如下图所示：

这个界面比较简陋，需要稍加设置即可。

1、编辑界面设置

首先多ManyToMany多对多字段设置。可以用filter_horizontal或filter_vertical：

#Many to many 字段
filter_horizontal = ("authors",)

效果如下图：

2、编辑字段集合

不过，我不怎么用fields和exclude。用得比较多的是fieldsets。该设置可以对字段分块，看起来比较整洁。如下设置：

fieldsets = (
("Top", {"fields": ["name", "price", "pub_date"]}),
("Bottom", {"fields": ["publish", "authors"]})
)