Django admin 一些有用的设置 - 听风。

一、基本设置

1、应用注册

若要把app应用显示在后台管理中，需要在admin.py中注册。这个注册有两种方式，我比较喜欢用装饰器的方式。

先看看普通注册方法。打开admin.py文件，如下代码：


     #Blog模型的管理器


     class


     BlogAdmin(admin.ModelAdmin):


     list_display


     'id'


     'caption'


     'author'


     'publish_time'


     #在admin中注册绑定


     admin.site.register(Blog, BlogAdmin)


     @admin


     .register(Blog)


     class


     BlogAdmin(admin.ModelAdmin):


     #listdisplay设置要显示在列表中的字段（id字段是Django模型的默认主键）


     list_display


     'id'


     'caption'


     'author'


     'publish_time'


     #list_per_page设置每页显示多少条记录，默认是100条


     list_per_page


     #ordering设置默认排序字段，负号表示降序排序


     ordering


     '-publish_time'

,)


     #list_editable 设置默认可编辑字段


     list_editable


     'machine_room_id'


     'temperature'


     #fk_fields 设置显示外键字段


     fk_fields


     'machine_room_id'

,)


     @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?

处理方法：

命令行直接执行此命令： [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


     last_name


     models.CharField(max_length


     color_code


     models.CharField(max_length

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'


     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。

效果如下：

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


     # 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/

站点和用户组在一起

而第一种方法是分开的。

5.通过当前登录的用户过滤显示的数据

官方文档的介绍：

def get_queryset(self, request):

"""函数作用：使当前登录的用户只能看到自己负责的服务器"""

qs = super(MachineInfoAdmin, self).get_queryset(request)

if request.user.is_superuser:

return qs

return qs.filter(user=UserInfo.objects.filter(user_name=request.user))

list_display = ('machine_ip', 'application', 'colored_status', 'user', 'machine_model', 'cache',

'cpu', 'hard_disk', 'machine_os', 'idc', 'machine_group')

这样对多对多字段操作更方便。

另外，可以用fields或exclude控制显示或者排除的字段，二选一即可。

例如，我想只显示标题、作者、分类标签、内容。不想显示是否推荐字段，可以如下两种设置方式：

fields = ('caption', 'author', 'tags', 'content')

exclude = ('recommend',) #排除该字段

设置之后，你会发现这些字段都是一个字段占一行。若想两个字段放在同一行可以如下设置：

fields = (('caption', 'author'), 'tags', 'content')

效果如下：

2、编辑字段集合

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

fieldsets = (

("base info", {'fields': ['caption', 'author', 'tags']}),

("Content", {'fields':['content', 'recommend']})

效果如下：

3、一对多关联

还有一种比较特殊的情况，父子表的情况。编辑父表之后，再打开子表编辑，而且子表只能一条一条编辑，比较麻烦。

这种情况，我们也是可以处理的，将其放在同一个编辑界面中。

例如，有两个模型，一个是订单主表(BillMain)，记录主要信息；一个是订单明细(BillSub)，记录购买商品的品种和数量等。

admin.py如下：

#coding:utf-8

from django.contrib import admin

from bill.models import BillMain, BillSub

@admin.register(BillMain)

class BillMainAdmin(admin.ModelAdmin):

inlines = [BillSubInline,] #Inline把BillSubInline关联进来

list_display = ('bill_num', 'customer',)

class BillSubInline(admin.TabularInline):

model = BillSub

extra = 5 #默认显示条目的数量

这样就可以快速方便处理数据。

相关的admin比较有用的设置大致这些，若你觉得还有一些比较有用的，可以留意参与讨论。

4.设置只读字段

在使用admin的时候，ModelAdmin默认对于model的操作只有增加，修改和删除，但是总是有些字段是不希望用户来编辑的。而 readonly_fields 设置之后不管是admin还是其他用户都会变成只读，而我们通常只是想限制普通用户。这时我们就可以通过重写 get_readonly_fields 方法来实现对特定用户的只读显示。

官网介绍：（ https://docs.djangoproject.com/en/1.10/ref/contrib/admin/#django.contrib.admin.ModelAdmin.readonly_fields ）


     class


     MachineInfoAdmin(admin.ModelAdmin):

def


     get_readonly_fields(


     self


     , request, obj


     None

):


     """  重新定义此函数，限制普通用户所能修改的字段  """

if


     request.user.is_superuser:


     self


     .readonly_fields

[]


     return


     self


     .readonly_fields


     readonly_fields


     'machine_ip'


     'status'


     'user'


     'machine_model'


     'cache'


     'cpu'


     'hard_disk'


     'machine_os'


     'idc'


     'machine_group'


     import


     datetime


     import


     random


     CurrentTime


     datetime.datetime.now().strftime(


     "%Y%m%d%H%M%S"


     # 生成当前时间


     RandomNum


     random.randint(


     # 生成的随机整数n，其中0<=n<=100


     UniqueNum

str


     (CurrentTime)

str


     (RandomNum)


     return


     UniqueNum


     obj.proposer


     request.user


     obj.paper_num


     make_paper_num()


     super


     (DataPaperStoreAdmin,


     self


     ).save_model(request, obj, form, change)

def


     save_model(


     self


     , request, obj, form, change):

if


     change:


     # 更改的时候


     machine_code


     self


     .model.objects.get(pk


     obj.pk).machine


     disk_id


     self


     .model.objects.get(pk


     obj.pk).disk_id


     disk_code


     self


     .model.objects.get(pk


     obj.pk).disk


     machine.Device.objects.


     filter

(pk


     disk_id).update(device_status


     '待报废'


     data


     'server_code'


     : machine_code,


     'device_type'


     '硬盘'


     'original_code'


     : disk_code,


     'way'


     '变更'


     'current_code'


     : obj.disk}


     common.DeLog.objects.create(


     data)


     # 创建日志


     else


     # 新增的时候


     data


     'server_code'


     : obj.machine,


     'device_type'


     '硬盘'


     'original_code'


     : '',


     'way'


     '新增'


     'current_code'


     : obj.disk}


     common.DeLog.objects.create(


     data)


     # 创建日志


     super


     (MachineExDiskAdmin,


     self


     ).save_model(request, obj, form, change)

def


     delete_model(


     self


     , request, obj):


     machine.Device.objects.


     filter

(pk


     obj.pk).update(device_status


     '待报废'


     data


     'server_code'


     : obj.machine,


     'device_type'


     '硬盘'


     'original_code'


     : obj.disk,


     'way'


     '删除'


     'current_code'


     : '',


     'user_name'


     : request.user}


     common.DeLog.objects.create(


     data)


     # 创建日志


     super


     (MachineExDiskAdmin,


     self


     ).delete_model(request, obj)

def


     get_readonly_fields(


     self


     , request, obj


     None

):


     """  重新定义此函数，限制普通用户所能修改的字段  """

if


     request.user.is_superuser:


     self


     .readonly_fields


     'commit_date'


     'paper_num'


     elif


     hasattr


     (obj,


     'is_sure'

):

if


     obj.is_sure:


     self


     .readonly_fields


     'project_name'


     'to_mail'


     'data_selected'


     'frequency'


     'start_date'


     'end_date'


     else


     self


     .readonly_fields


     'paper_num'


     'is_sure'


     'proposer'


     'sql'


     'commit_date'


     return


     self


     .readonly_fields

def


     change_view(


     self


     , request, object_id, form_url


     '', extra_context


     None

):


     change_obj


     DataPaperStore.objects.


     filter

(pk


     object_id)


     self


     .get_readonly_fields(request, obj


     change_obj)


     return


     super


     (DataPaperStoreAdmin,


     self


     ).change_view(request, object_id, form_url, extra_context


     extra_context)

change_view方法，允许您在渲染之前轻松自定义响应数据。（凡是对单条数据操作的定制，都可以通过这个方法配合实现）
详细信息可见： https://docs.djangoproject.com/en/1.10/ref/contrib/admin/#django.contrib.admin.ModelAdmin.change_view

8 .修改app的显示名称

Dajngo在Admin后台默认显示的应用的名称为创建app时的名称。

我们如何修改这个app的名称达到定制的要求呢，其实Django已经在文档里进行了说明。

从Django1.7以后不再使用app_label，修改app相关需要使用AppConfig。我们只需要在应用的__init__.py里面进行修改即可：


     @admin


     .register(Blog)


     class


     BlogAdmin(admin.ModelAdmin):


     # listdisplay添加 tags_list 不存在的字段名


     list_display


     'id'


     'caption'


     'tags_list'


     # 定义tags_list，方法名和tags_list一致

def


     tags_list(


     self


     , blog):


     """自定义列表字段"""


     tag_names

map


     lambda


     x: x.tag_name, blog.tags.

all

())


     return


     ', '


     .join(tag_names)

参考网站： http://code.ziqiangxuetang.com/django/django-admin.html

http://django-intro-zh.readthedocs.io/zh_CN/latest/part2/

http://python.usyiyi.cn/translate/django_182/ref/contrib/admin/index.html

https://www.ibm.com/developerworks/cn/opensource/os-django-admin/

http://www.cnblogs.com/linxiyue/p/4074141.html