django后台admin的配置

一、基本设置

1、应用注册

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

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

上面方法是将管理器和注册语句分开。有时容易忘记写注册语句，或者模型很多，不容易对应。

还有一种方式是用装饰器，该方法是Django1.7的版本新增的功能：

该方式比较方便明显，推荐用这种方式。

2、admin界面汉化

默认admin后台管理界面是英文的，对英语盲来说用起来不方便。可以在settings.py中设置：

1. LANGUAGE_CODE='zh-CN'
2. TIME_ZONE='Asia/Shanghai'

1.8版本之后的language code设置不同：

1. LANGUAGE_CODE='zh-hans'
2. TIME_ZONE='Asia/Shanghai'

二、记录列表界面设置

记录列表是我们打开后台管理进入到某个应用看到的界面，如下所示：

我们可以对该界面进行设置，主要包括列表和筛选器。

1、记录列表基本设置

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

另外，默认可以点击每条记录第一个字段的值可以进入编辑界面。

我们可以设置其他字段也可以点击链接进入编辑界面。

2、筛选器

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

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

对应效果如下：

此处注意：

使用 date_hierarchy 进行详细时间筛选的时候 可能出现报错：Databasereturnedaninvaliddatetimevalue.Aretimezonedefinitionsforyourdatabaseandpytzinstalled?

处理方法：

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

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

3、颜色显示

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

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

fromdjango.dbimportmodels fromdjango.contribimportadmin fromdjango.utils.htmlimportformat_html classPerson(models.Model): first_name=models.CharField(max_length=50) last_name=models.CharField(max_length=50) color_code=models.CharField(max_length=6) defcolored_name(self): returnformat_html( '<span style="color: #{};">{} {}</span>', self.color_code, self.first_name, self.last_name, ) classPersonAdmin(admin.ModelAdmin): list_display=('first_name','last_name','colored_name')

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

效果：

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

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

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

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

代码：

1 2 3 4 5

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

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

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

效果如下：

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

1 2 3 4 5 6 7 8 9 10 11 12

fromdjango.contribimportadmin fromhys_operation.modelsimport* # 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.通过当前登录的用户过滤显示的数据

官方文档的介绍：

实际代码和效果：

@admin.register(MachineInfo)

class MachineInfoAdmin(admin.ModelAdmin):

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')

三、编辑界面设置

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

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

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

1、编辑界面设置

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

1. #Manytomany字段
2. filter_horizontal=('tags',)

效果如下图：

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

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

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

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

或者

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

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

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

效果如下：

2、编辑字段集合

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

1. fieldsets=(
2. ("baseinfo",{'fields':['caption','author','tags']}),
3. ("Content",{'fields':['content','recommend']})
4. )

效果如下：

3、一对多关联

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

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

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

admin.py如下：

1. #coding:utf-8
2. fromdjango.contribimportadmin
3. frombill.modelsimportBillMain,BillSub
5. @admin.register(BillMain)
6. classBillMainAdmin(admin.ModelAdmin):
7. inlines=[BillSubInline,]#Inline把BillSubInline关联进来
8. list_display=('bill_num','customer',)
10. classBillSubInline(admin.TabularInline):
11. model=BillSub
12. 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）

代码：

效果：

5、数据保存时进行一些额外的操作（通过重写ModelAdmin的save_model实现）

代码：

这样，在添加数据时，会自动保存申请人和备案号。

我们也可以在修改数据时获取保存前的数据：

通过change参数，可以判断是修改还是新增，同时做相应的操作。上述代码就是在替换磁盘的时候修改状态，并写入日志。

代码：

同样的，还有delete_model：

6. 修改模版 chang_form.html 让普通用户 无法看到 “历史” 按钮。

默认 普通用户下 是存在 “历史” 按钮的：

此时 chang_form.html 的代码为：

我们将代码修改为：

这样，就可以限制 只让管理员看到历史 按钮了。普通用户看不到了：

7.对单条数据 显示样式的修改

需求如下：

每条数据都有 个确认标识（上图红框中），如果已经确认，用户再点击进入查看信息的时候全部只读显示，即不能在做修改，如果没确认在可以修改。如下：

已确认：

未确认：

实现方法：

change_view 方法 和 get_readonly_fields 方法 配合，代码：

注：

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里面进行修改即可：

9.自定义列表字段

在DataPaperStore模型中有 end_date字段，如果当前时间大于end_date是我们想显示一个“已过期”，但admin列表显示不能直接用该字段，也显示不出来。此时可以通过自定义列表字段显示。如下设置admin：

通过自定义列表字段，获取相关数据再列表中显示，效果如下：

10.actions

参考：https://docs.djangoproject.com/en/1.11/ref/contrib/admin/actions/

def copy_one(self, request, queryset):
    # 定义actions函数
    # 判断用户选择了几条数据，如果是一条以上，则报错
    if queryset.count() == 1:
        old_data = queryset.values()[0]
        old_data.pop('id')
        # 将原数据复制并去掉id字段后，插入数据库，以实现复制数据功能，返回值即新数据的id（这是在model里__str__中定义的）
        r_pk = Record.objects.create(**old_data)
        # 修改数据后重定向url到新加数据页面
        return HttpResponseRedirect('{}{}/change'.format(request.path, r_pk))
    else:
        self.message_user(request, "只能选取一条数据！")
copy_one.short_description = "复制所选数据"

效果如下：

为每个对象自定义 action

有时候你需要在单个对象上执行特定的 action。‘actions’工具当然可以完成这个任务，不过过程会显得很麻烦：点击对象、选择 action、再点击一个按钮……肯定有更便捷的方式，对吧？

让我们想办法只点击一次就全部搞定。

我们可以先自定义一个字段（上面提到过），让这个字段可以每次点击的时候帮我们做一些事情，比如：复制本条数据

自定义字段这个功能我们没问题，但是如何让它帮我们复制数据呢？

我们知道，django里所有的业务逻辑都是通过访问url从而指向对应的views来实现的，就是说我们想要实现复制数据，就必须有对应的url和views。

而admin为我们提供了对应的方法：get_urls

这个方法可以让我们临时添加一个url，并且可以防止手动输入此url实现操作。

代码：

效果：

11.formfield_for_foreignkey

ModelAdmin.formfield_for_foreignkey(db_field,request,**kwargs)¶

这个方法可以过滤下拉列表的数据，使之显示过滤后的数据

下面的代码表示，car字段会根据当前登录的用户显示此用户所拥有的车

12.Admin中使用二级联动

参考：

https://docs.djangoproject.com/en/1.11/ref/contrib/admin/#django.contrib.admin.ModelAdmin.change_view

http://www.smallerpig.com/1125.html

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

默认的django会自动根据我们定义的模型生成form给admin使用，使用到这个form的地方分别是change和add的时候。
最终生成的结果就是可以选择所有的省，也可以选择所有的市，这并不合理，正确的应该是在选择某个省的时候在市的下拉列表里只有该省的城市。
而，django原生并不能做到这么智能。下面介绍一下实现方法：

（1）admin.py

使用change_form_template重置change_form所使用得模版

（2）在上一步配置的路径下新建html文件record_change_form.html

注意：1.继承change_form.html 2.设计好url

（3）在urls.py中添加一条对应的url

urls.py

（4）创建views函数

返回值就是过滤后的值