Django一些有用的admin设置

  • 发布时间:2016年11月17日 14:04
  • 作者:杨仕航
  • 分类标签: Django
  • 阅读(4178)
  • 评论(0)

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


一、基本设置

1、应用注册

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

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

#coding:utf-8
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的版本新增的功能:

#coding:utf-8
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'


二、记录列表界面设置

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

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


1、记录列表基本设置

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

#coding:utf-8
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',)

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


另外,默认可以点击每条记录第一个字段的值可以进入编辑界面。若第一个字段是id主键,可以点击的区域比较小。

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

#coding:utf-8
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_display_links = ('id', 'caption')


2、筛选器

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

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

#coding:utf-8
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 = ('tags', 'publish_time') #过滤器
    search_fields = ('caption', )          #搜索字段
    date_hierarchy = 'publish_time'        #详细时间分层筛选

对应效果如下:

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


三、编辑界面设置

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

若不任何设置,如下图所示:

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


1、编辑界面设置

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

#Many to many 字段
filter_horizontal=('tags',)

效果如下图:

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

另外,可以用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 #默认显示条目的数量

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


4、自定义列表字段

上面的一对多和多对多可以数据编辑中显示,但在列表中没有显示。有时还需要显示一些其他东西。例如两个字段相乘计算结果等等。这些都可以通过自定义列表字段处理和显示。

例如,两个模型Blog和Tag。多对多关系。简单模型代码如下:

class Tag(models.Model):
    tag_name = models.CharField(max_length=20,blank=True)
    
class Blog(models.Model):
    caption = models.CharField(max_length=20,blank=True)
    tags = models.ManyToManyField(Tag,blank=True)


在Blog模型中有tags字段,但admin列表显示不能直接用该字段,也显示不出来。可以通过自定义列表字段显示。如下设置admin:

#coding:utf-8
from django.contrib import admin
from blog.models import Blog, Tag

# Blog模型的管理器
@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)


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

20170527/20170527103220737.png


相关的admin比较有用的设置大致这些,若你觉得还有一些比较有用的,可以留言大家一起讨论。

上一篇:VSTO获取公共对象:Excel篇

下一篇:Django的raw方法执行SQL查询

评论列表

智慧如你,不想发表一下意见吗?

新的评论

清空

猜你喜欢

  • 猜测中,请稍等...