一、admin组件使用
Django 提供了基于 web 的管理工具。
Django 自动管理工具是 django.contrib 的一部分。你可以在项目的 settings.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', "app01" ]
django.contrib是一套庞大的功能集,它是Django基本代码的组成部分。
1、激活管理工具
通常我们在生成项目时会在 urls.py 中自动设置好,
from django.conf.urls import url from django.contrib import admin urlpatterns = [ url(r'^admin/', admin.site.urls), ] from django.contrib import admin from django.urls import path urlpatterns = [ path('admin/', admin.site.urls), ]
当这一切都配置好后,Django 管理工具就可以运行了。
2、使用管理工具
启动开发服务器,然后在浏览器中访问 http://127.0.0.1:8000/admin/,得到登陆界面,你可以通过命令 python manage.py createsuperuser 来创建超级用户。
为了让 admin 界面管理某个数据模型,我们需要先注册该数据模型到 admin
from django.db import models # Create your models here. class Author(models.Model): name=models.CharField( max_length=32) age=models.IntegerField() def __str__(self): return self.name class Publish(models.Model): name=models.CharField( max_length=32) email=models.EmailField() def __str__(self): return self.name class Book(models.Model): title = models.CharField( max_length=32) publishDate=models.DateField() price=models.DecimalField(max_digits=5,decimal_places=2) publisher=models.ForeignKey(to="Publish") authors=models.ManyToManyField(to='Author') def __str__(self): return self.title
3、admin的定制
在admin.py中只需要讲Model中的某个类注册,即可在Admin中实现增删改查的功能,如:
from django.contrib import admin from app01.models import * admin.site.register(UserInfo) admin.site.register(Book) admin.site.register(Room)
但是,这种方式比较简单,如果想要进行更多的定制操作,需要利用ModelAdmin进行操作,如:
方式一: class UserAdmin(admin.ModelAdmin): list_display = ('user', 'pwd',) admin.site.register(models.UserInfo, UserAdmin) # 第一个参数可以是列表 方式二: @admin.register(models.UserInfo) # 第一个参数可以是列表 class UserAdmin(admin.ModelAdmin): list_display = ('user', 'pwd',)
ModelAdmin中提供了大量的可定制功能,如
1. list_display,列表时,定制显示的列。
# 模板 @admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): list_display = ('user', 'pwd', 'xxxxx') def xxxxx(self, obj): return "xxxxx"
在MRBS系统上定制admin示例:
class BookConfig(admin.ModelAdmin): list_display = ["user", "room", "date"] # 不能放多对多字段 admin.site.register(Book, BookConfig) # 定制类继承了ModelAdmin, 但优先显示BookConfig类的,找不到再找父类的
显示效果:
2. list_display_links,列表时,定制列可以点击跳转。
class BookConfig(admin.ModelAdmin): list_display = ["user", "room", "date"] # 不能放多对多字段 list_display_links = ["room", "date"] # 自由定制哪一列可以做跳转 admin.site.register(Book, BookConfig)
显示效果:
3. list_filter,列表时,定制右侧快速筛选。
class BookConfig(admin.ModelAdmin): list_display = ["user", "room", "date"] # 不能放多对多字段 list_display_links = ["room", "date"] # 自由定制哪一列可以做跳转 list_filter = ["user", "date"] # 定制右侧快速筛选 admin.site.register(Book, BookConfig)
显示效果:
4. list_select_related,列表时,连表查询是否自动select_related
5. list_editable,列表时,可以编辑的列
class BookConfig(admin.ModelAdmin): list_display = ["user", "room", "date"] # 不能放多对多字段 list_display_links = ["room", "date"] # 自由定制哪一列可以做跳转 list_filter = ["user", "date"] # 定制右侧快速筛选 list_editable = ["user"] admin.site.register(Book, BookConfig)
需要注意的是设置为list_editable就不能设置为list_display_links。
显示效果
6. search_fields,列表时,模糊搜索的功能
@admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): search_fields = ('user', 'pwd')
显示效果:
7. date_hierarchy,列表时,对Date和DateTime类型进行搜索
class BookConfig(admin.ModelAdmin): list_display = ["user", "room", "date"] # 不能放多对多字段 list_display_links = ["room", "date"] # 自由定制哪一列可以做跳转 list_filter = ["user", "date"] # 定制右侧快速筛选 list_editable = ["user"] search_fields = ['date'] date_hierarchy = 'date' admin.site.register(Book, BookConfig)
显示效果:
8. inlines,详细页面,如果有其他表和当前表做FK,那么详细页面可以进行动态增加和删除(不常用)
class UserInfoInline(admin.StackedInline): # TabularInline extra = 0 model = models.UserInfo class GroupAdminMode(admin.ModelAdmin): list_display = ('id', 'title',) inlines = [UserInfoInline, ]
9. action,列表时,定制action中的操作
自带的action操作是一个批量选中删除的操作:
点击go即完成删除操作。
自定制action的操作:
class BookConfig(admin.ModelAdmin): ... # 定制Action行为具体方法 def func(self, request, queryset): print(self, request, queryset) queryset.update(date="2012-12-12") func.short_description = "批量初始化操作" actions = [func, ] # Action选项都是在页面上方显示 actions_on_top = True # Action选项都是在页面下方显示 actions_on_bottom = False # 是否显示选择个数 actions_selection_counter = True admin.site.register(Book, BookConfig)
点选并选择批量初始化后,显示效果如下:
10. 定制HTML模板
add_form_template = None change_form_template = None change_list_template = None delete_confirmation_template = None delete_selected_confirmation_template = None object_history_template = None
11. raw_id_fields,详细页面,针对FK和M2M字段变成以Input框形式
@admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): raw_id_fields = ('FK字段', 'M2M字段',)
12. fields,详细页面时,显示字段的字段
添加页面原始显示:
修改了添加页面的显示字段:
class BookConfig(admin.ModelAdmin): ... fields = ['user', ]
修改后显示效果:
13. exclude,详细页面时,排除的字段
class BookConfig(admin.ModelAdmin): ... # fields = ['user', ] exclude = ['user', 'room']
与fields相反,排除哪些字段不显示,显示效果如下:
14. readonly_fields,详细页面时,只读字段
@admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): readonly_fields = ('user',)
15. fieldsets,详细页面时,使用fieldsets标签对数据进行分割显示
@admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): fieldsets = ( ('基本数据', { 'fields': ('user', 'pwd', 'ctime',) }), ('其他', { 'classes': ('collapse', 'wide', 'extrapretty'), # 'collapse','wide', 'extrapretty' 'fields': ('user', 'pwd'), }), )
16. 详细页面时,M2M显示时,数据移动选择(方向:上下和左右)
@admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): filter_vertical = ("m2m字段",) # 或filter_horizontal = ("m2m字段",)
17. ordering,列表时,数据排序规则
class BookConfig(admin.ModelAdmin): list_display = ["id", "user", "room", "date"] # 不能放多对多字段 ordering = ["id"]
添加“id”字段显示,并进行排序,显示如下:
在添加的字段前加“-”,即是反向排序:
class BookConfig(admin.ModelAdmin): ordering = ['-date'] # 反向排序
ordering = []中可以添加多个字段,但不是联合排序,而是在第一个字段排序相同的情况下,按第二个字段排序。
class BookConfig(admin.ModelAdmin): ordering = ['-date', "time_id"]
18. radio_fields,详细页面时,使用radio显示选项(FK默认使用select)
radio_fields = {"ug": admin.VERTICAL} # 或admin.HORIZONTAL
19. form = ModelForm,用于定制用户请求时候表单验证
from app01 import models from django.forms import ModelForm from django.forms import fields class MyForm(ModelForm): others = fields.CharField() class Meta: model = models = models.UserInfo fields = "__all__" @admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): form = MyForm
20. empty_value_display = "列数据为空时,显示默认值"
@admin.register(models.UserInfo) class UserAdmin(admin.ModelAdmin): empty_value_display = "列数据为空时,默认显示" list_display = ('user','pwd','up') def up(self,obj): return obj.user up.empty_value_display = "指定列数据为空时,默认显示"