文档章节

django admin 配置

易野
 易野
发布于 2017/09/08 16:46
字数 2722
阅读 731
收藏 0

精选30+云产品,助力企业轻松上云!>>>

DJANGO ADMIN 一些有用的设置

 

Django自带的后台管理是Django明显特色之一,可以让我们快速便捷管理数据。后台管理可以在各个app的admin.py文件中进行控制。以下是我最近摸索总结出比较实用的配置。若你有什么比较好的配置,欢迎补充。

 

一、基本设置

1、应用注册

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

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

1

2

3

4

5

6

7

8

9

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)

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

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

1

2

3

4

5

6

7

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中设置:

  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、记录列表基本设置

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

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

from django.contrib import admin

from blog.models import Blog

  

#Blog模型的管理器

@admin.register(Blog)

class BlogAdmin(admin.ModelAdmin):

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

    list_display = ('id''caption''author''publish_time')

    

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

    list_per_page = 50

    

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

    ordering = ('-publish_time',)

  

    #list_editable 设置默认可编辑字段

    list_editable = ['machine_room_id''temperature']

  

    #fk_fields 设置显示外键字段

     fk_fields = ('machine_room_id',)

  

此处比较简单,自己尝试一下即可。

 

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

 

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

1

2

3

4

5

6

7

8

from django.contrib import admin

from blog.models import Blog

  

#Blog模型的管理器

@admin.register(Blog)

class BlogAdmin(admin.ModelAdmin):   

    #设置哪些字段可以点击进入编辑界面

    list_display_links = ('id''caption')

  

2、筛选器

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

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

1

2

3

4

5

6

7

8

9

10

11

12

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

     

    #筛选器

    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、颜色显示

想对某些字段设置颜色,可用下面的设置:

 

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

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.调整页面头部显示内容和页面标题

代码:

1

2

3

4

5

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。

效果如下:

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

1

2

3

4

5

6

7

8

9

10

11

12

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/

 站点和用户组在一起

而第一种方法是分开的。

 

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. #Many to many 字段
  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.     ("base info", {'fields': ['caption', 'author', 'tags']}),
  3.     ("Content", {'fields':['content', 'recommend']})
  4. )

效果如下:

 

 

3、一对多关联

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

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

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

admin.py如下:

 
  1. #coding:utf-8
  2. from django.contrib import admin
  3. from bill.models import BillMain, BillSub
  4.  
  5. @admin.register(BillMain)
  6. class BillMainAdmin(admin.ModelAdmin):
  7.     inlines = [BillSubInline,]    #Inline把BillSubInline关联进来
  8.     list_display = ('bill_num', 'customer',)
  9.     
  10. class BillSubInline(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

代码:

1

2

3

4

5

6

7

8

9

10

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

  效果:

 

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

 

代码:

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

def save_model(self, request, obj, form, change):

    """  重新定义此函数,提交时自动添加申请人和备案号  """

 

    def make_paper_num():

        """ 生成随机备案号 """

        import datetime

        import random

        CurrentTime = datetime.datetime.now().strftime("%Y%m%d%H%M%S")  # 生成当前时间

        RandomNum = random.randint(0100)  # 生成的随机整数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)

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

 

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

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

此时  chang_form.html  的代码为:

我们将代码修改为:

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

 

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

 需求如下:

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

已确认:

 

未确认:

 

 实现方法:

change_view 方法 和 get_readonly_fields 方法 配合,代码:

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

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

 

参考了博客:http://yshblog.com/blog/

 

参考网站: 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/

易野
粉丝 6
博文 208
码字总数 170015
作品 0
深圳
私信 提问
加载中
请先登录后再评论。
Django基础(5): Admin

陆续更新中: Django基础(1): 目录文件简介 Django基础(2): 创建应用 Django基础(3): 配置url Django基础(4): 建立Templates Admin是Django中自带的一个自动化数据管理界面,功能强大。被授权...

AryaHooper
2017/12/27
0
0
Django-环境安装/项目&app创建

环境安装 开发Django之前,我们需要先安装以下软件(基础配置): Python Virtualenv ←非强制性,但是强烈建议 Django 安装Python 安装最新版本的Python。(https://www.python.org/) # 安装...

hpmomocha
2018/04/10
0
0
django admin后台插件:django-suit入门

去年9月底开始用django来做公司内部项目,开始对django有了一些了解,感觉django真的蛮强大的(也有很多人推荐flask,将来有空的话我会试试)。今天的话只是介绍一个小东西,django管理员后台...

osc_iqk0y05x
2018/12/20
5
0
四 Django框架,models.py模块,数据库操作——创建表、数据类型、索引、admin后台,补充Django目录说明以及全局配置文件配置

Django框架,models.py模块,数据库操作——创建表、数据类型、索引、admin后台,补充Django目录说明以及全局配置文件配置 数据库配置 django默认支持sqlite,mysql, oracle,postgresql数据库...

osc_oajhjcoo
2018/01/03
2
0
Django:快速搭建简单的Blog

一,创建项目 我这里是基于python虚拟环境下做的开发, 先进入虚拟环境 workon py3_django 1, 为blog创建名为mysite的工程项目 django-admin.py startproject mysite 2.创建app应用 cd到项目...

xxl714
2017/11/01
0
0

没有更多内容

加载失败,请刷新页面

加载更多

你看起来很好吃

你看起来很好吃 本文分享自微信公众号 - ZackSock(ZackSock)。 如有侵权,请联系 support@oschina.cn 删除。 本文参与“OSC源创计划”,欢迎正在阅读的你也加入,一起分享。...

ZackSock
2019/10/25
19
0
Python绘制日历图和热力图

日历热力图 实现某商店2018年10月1号至2019年3月1号期间每一天盈利额(产生5000至30000区间的随机数)的数据可视化。 要求在鼠标放置每个单元格上时显示具体日期和对应数据 import datetime ...

气象学家公众号
07/03
10
0
#乔布简历#计协纳新季福利!乔布简历20元会员卡免费送

#乔布简历#计协纳新季福利!@乔布简历 20元会员卡免费送!活动规则:1)转发本微博/说说@ 三个好友;2)搜索关注“乔布堂”微信公众号,回复“BC016@你的QQ号”;截图发给计协微信公众号:j...

若川
2014/09/22
12
0
第十一届蓝桥第一场省赛题 走方格

走方格 问题描述: 在平面上有一些二维的点阵。这些点的编号就像二维数组的编号一样。从上到下依次为第 1 至第 n 行,从左到右依次为第 1 至第 m 列,每一个点可以用行号和列号来表示。现在有...

osc_kf7nv2km
37分钟前
29
0
HTTP/2协议之Stream【原理笔记】

前言 前面三篇介绍了HPPT/2的“连接前言”、“二进制桢”、“头部压缩”。本文从“流及多路复用”、“流状态”、“流量控制”、“流优先级”、“HTTP/2扩展”介绍HTTP/2协议流相关知识。 一、...

瓜农老梁
05/31
13
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部