在 models.py
中定义好的模型类并不能在admin管理后台中显示出来,还需要在admin.py
文件中注册好,格式如
from django.contrib import admin
from hello.models import *
# Register your models here.
admin.site.register(Author)
虽然注册好了 但是在管理后台的首页中显示的是 模型类的名称,并不是很友好,我们要将他改成自定义的名称,在模型类中可以定义数据模型的扩展属性
通过内部类Meta给数据模型增加扩展属性:
class Meta:
verbose_name = '名称'
verbose_name_plural = '名称的复数形式'
ordering = ['排序字段1', '排序字段2']
。。。
更多扩展属性在 模型层的 models
下的元选项(Meta options
)中有详细介绍
在添加一条信息后 在展示页面是一个 模型名 object的形式,为了展示的可读性 我们给模型设置一个方法来设置模型类的显示名称
# 在python2.x中是__unicode__
def __str__(self):
return self.author
__repr__ = __str__
==str函数是设置 print的时候显示的内容==
==repr是设置在shell中直接输出实例时显示的内容==
在添加条目的时候可以看到 每个选项都是我们在models定义的字段名,显示成英文并不是很友好,可以在定义字段的时候加上verbose_name
高级用法
django admin是django自带的一个后台app,提供了后台管理的功能
基础知识点:
一: 认识ModelAdmin
管理界面的定制类,如需扩展特定的model界面需要从该类继承(所属于admin packages下面)
二:注册model类到admin的两种方式
- 使用register的方法
- 使用register的装饰器
三:一些常用的设置技巧
方法名 | 功能 |
---|---|
list_display | 指定要显示的字段 |
list_display_links | 指定要显示的字段, 并且能够链接到详情页面,默认只有主键能链接到 |
search_fields | 指定搜素的字段 会添加一个搜素框出来 |
list_filter | 指定列表过滤器,与搜素类似 在右侧展示一个分类列表 |
ordering | 指定排序字段 默认是id的降序 |
fields | 指定编辑表单中需要展示的 默认是所有展示 在同一个元祖或者list的数据会显示在同一行 |
exclude | 指定编辑表单中不需要展示的 |
fieldsets | 设置分组表单 |
actions | 设置批量处理的动作 |
# fieldsets的样例
fieldsets = (
(None, {
'fields': ('author', )
}),
('个人信息', {
'classes': ('collapse',),
'fields': ('sex', 'birthday', )
}),
('地址信息', {
'classes': ('collapse',),
'fields': ('email', 'address',)
}),
)
作者详情一栏中 默认显示只会作者姓名 默认全部显示出来:
class AuthorDetailAdmin(admin.ModelAdmin):
# 定义前端展示的
list_display = ('sex', 'email', 'address', 'birthday', 'author')
注册有两种方式:
# 1 在原有的注册类中加上扩展的定制类
admin.site.register(AuthorDetail, AuthorDetailAdmin)
# 2.使用注册类
给定制类加上装饰器 @admin.register(原有model类名),这样原来的注册语句
admin.site.register(AuthorDetail)都可以不写
批量动作
# 批量设置代理ip失效
def proxy_invalid(modeladmin, request, queryset):
queryset.update(available=0)
proxy_invalid.short_description = "批量设置代理ip失效"
actions = (proxy_invalid, )