admin 组件的使用
Django 提供功能十分强大的后台管理组件 admin 来实现自动管理。
admin 是一个组件,与 APP 一样,项目启动一开始就加载了。在 setting.py 中的 INSTALLED_APPS 能够看到。
# Application definition
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'Xadmin.apps.XadminConfig',
'app01.apps.App01Config',
'app02.apps.App02Config',
]
激活 admin
通常在 urls.py 文件中设置好有关 admin 的 url 就算是激活了。
from django.conf.urls import url
from django.contrib import admin
urlpatterns = [
url(r'^admin/', admin.site.urls),
]
使用 admin
admin 是后台管理工具,可以通过 http://127.0.0.1:8000/admin/ 访问到后台管理界面,管理员用户可以通过 python manage.py createsuperuser 命令创建。
想要某个数据模型可以被 admin 管理需要提前进行注册。
在每个 APP 下面都有 admin.py 这个文件,在该文件中进行数据模型的注册。
from django.contrib import admin
# Register your models here.
from .models import *
admin.site.register(Book)
定制 admin
在 admin.py 中对数据模型注册完事后就可以使用简单的增删改查等功能,如果想要定制更多的操作,需要通过 ModelAdmin 类进行操作。
首先,创建继承于 ModelAdmin 的配置类:
class BookConfig(admin.ModelAdmin):
...定制信息
然后,对数据模型进行注册时加上配置类:
admin.site.register(Book, BookConfig)
ModelAdmin 提供的定制功能有:
1.list_display 设置在列表中显示的列
class BookConfig(admin.ModelAdmin):
def deletes(self):
return mark_safe("<a href=''>删除</a>")
# 在展示页面会显示哪些字段内容,除了已有的字段,还可以添加自定义函数为字段显示
list_display = ["title", "price", "publishDate", "publish", deletes]
2.list_display_links 设置哪些列可以点击跳转到修改界面
class BookConfig(admin.ModelAdmin):
# 设置哪些字段内容转成可点击的链接,转到更改页面
list_display_links = ["title", "price"]
3.list_filter 在右侧设置可以筛选过滤的列
class BookConfig(admin.ModelAdmin):
# 设置可以用哪些字段进行分组过滤
list_filter = ["title", "price", "publish"]
4.search_fields 设置搜索时所搜索的列
class BookConfig(admin.ModelAdmin):
# 设置可以按照哪些字段进行搜索
search_fields = ["title", "price"]
5.actions 设置批处理的动作
class BookConfig(admin.ModelAdmin):
def patch_init(self, request, queryset):
queryset.update(price=100)
# 设置批量处理动作的描述名称
patch_init.short_description = "批量初始化"
# 设置批量处理的动作
actions = [patch_init]