学习Django如何玩转admin组件?

    /    2018-12-11

Django Admin介绍

admin 是django 自带的用来让你进行数据库管理的web app.提供了很多定制化功能,你甚至可以用它来进行公司内部的内容管理。

启用admin

你用startproject命令创建项目时django admin就默认启用了

admin 访问地址

http://localhost:yourport/admin/, by default.

为什么会让登录?哪来的用户信息?django自带了一套用户认证系统,admin就用了这个, 所以你想登录,先创建管理员账号。

python manage.py createsuperuser

然后你就开心的登录进去了呀

发现只有这么个东西, 什么东东?

这就是django自带的用户认证系统的2张表,用于管理账户和账户组信息。

那接下来要干什么呢? 注意django admin的作用是让你管理各app下的数据库表,实现可以通过Web页面就完成对数据的增删改查噢。 admin不会没事闲的自己把你创建的表拿过来管理,你得把你写的表在admin里注册一下才行。

在每个app下有个admin.py文件 ,在那里面注册你想要被管理的表

from django.contrib import admin
 
# Register your models here.
 
from app01 import models
 
admin.site.register(models.Article)
admin.site.register(models.Account)

然后刷新下页面,新添加的2个表就出来了

admin定制

你可以定义每张表显示哪些字段、对某些字段进行过滤、允许搜索等功能,这就需要定制一下admin的类了

class ArticleAdmin(admin.ModelAdmin):
    list_display = ('title','pub_date','account','read_count')
     
admin.site.register(Article, ArticleAdmin)

一下子就好看了,真是神奇呀。

就喜欢你这没见识的样子,别急,还有很多nb的功能呢,一起来看下。

看来这个list_display就是定义表数据要展示哪些字段的,除了这个属性,admin 还提供了哪些其它功能呢?

fields 决定对表进行修改时展示哪些字段

class ArticleAdmin(admin.ModelAdmin):
    list_display = ('title','pub_date','account','read_count')
    fields = ['title','account','pub_date']

还可以多个字段显示在一行。

fields = ['title','account',('pub_date','read_count')]

exclude 不展示哪些字段

date_hierarchy = 'pub_date' 按日期分类显示数据

fieldsets 分组显示

class ArticleAdmin(admin.ModelAdmin):
    list_display = ('title','pub_date','account','read_count')
    date_hierarchy = 'pub_date'
 
    fieldsets = (('文章相关',{
        'fields':('title','content'),
        'classes': ('wide', 'extrapretty'),
    }),('高级',{
        'classes':('collapse',),
        'fields':(('account','read_count'),'pub_date')
    }))

上面的classes 是用于设定字段样式,2个默认自带的样式是collapse 和wide

filter_horizontal,filter_vertical 均用于多对多字段

filter_horizontal = ['tags',]

list_display 定义表数据显示哪些列

除了表中有的字段,models自己定义的字段也能放入list_display

from django.db import models
from django.contrib import admin
 
class Person(models.Model):
    name = models.CharField(max_length=50)
    birthday = models.DateField()
 
    def decade_born_in(self):
        return self.birthday.strftime('%Y')[:3] + "0's"
    decade_born_in.short_description = 'Birth decade'
 
class PersonAdmin(admin.ModelAdmin):
    list_display = ('name', 'decade_born_in')

甚至还能玩出花样

<br>class Tag(models.Model):
    """文章标签表"""
    name = models.CharField(max_length=64,unique=True)
    date = models.DateTimeField(auto_now_add=True)
    color_code = models.CharField(max_length=6)
 
    def colored_name(self):
        return format_html(
            '<span style="color: #{};">{}</span>',
            self.color_code,
            self.name,
        )
 
    def __str__(self):
        return self.name
class TagAdmin(admin.ModelAdmin):
    list_display = ['name','colored_name']

竟然出现了样式,神奇。

list_display_links = ('first_name', 'last_name') 点下这2个字段就跳到修改页

list_filter 过滤,把要过滤的字段放到对应列表里就可以

list_filter = ('register_date',)

list_per_page = 20 每页显示20条数据

radio_fields 把外键或choice字段由下拉框变成单选框

class ArticleAdmin(admin.ModelAdmin):
    list_display = ('title','pub_date','account','read_count')
    date_hierarchy = 'pub_date'
    filter_horizontal = ['tags',]
    radio_fields = {'account': admin.VERTICAL}

自动补全

autocomplete_fields = ['account',] 自动补全,外键查询数据多时,方便查找

raw_id_fields 言语无法表示的字段

就把外键变成这样子

readonly_fields = ('address_report',) 只读字段

search_fields 模糊查找

好啦,就先讲这些吧, 当然admin还有很多更高级的功能,不过先会这些就够了,以后会深入再讲的。

(20)

分享至