Django框架 之 admin管理工具(组件使用)
Posted hanbowen
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Django框架 之 admin管理工具(组件使用)相关的知识,希望对你有一定的参考价值。
浏览目录
-
激活管理工具
-
使用管理工具
-
admin的定制
admin组件使用
Django 提供了基于 web 的管理工具。
Django 自动管理工具是 django.contrib 的一部分。你可以在项目的 settings.py 中的 INSTALLED_APPS 看到它:
1
2
3
4
5
6
7
8
9
10
11
|
# 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基本代码的组成部分。
激活管理工具
通常我们在生成项目时会在 urls.py 中自动设置好,
1
2
3
4
5
6
7
|
from django.conf.urls import url from django.contrib import admin urlpatterns = [ url(r ‘^admin/‘ , admin.site.urls), ] |
当这一切都配置好后,Django 管理工具就可以运行了。
使用管理工具
启动开发服务器,然后在浏览器中访问 http://127.0.0.1:8000/admin/,得到登陆界面,你可以通过命令 python manage.py createsuperuser 来创建超级用户。
为了让 admin 界面管理某个数据模型,我们需要先注册该数据模型到 admin.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
|
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 |
admin的定制
在admin.py中只需要讲Model中的某个类注册,即可在Admin中实现增删改查的功能,如:
1
|
admin.site.register(models.UserInfo) |
但是,这种方式比较简单,如果想要进行更多的定制操作,需要利用ModelAdmin进行操作,如:
1
2
3
4
5
6
7
8
9
10
11
|
方式一: 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中提供了大量的可定制功能,如下所示:
list_display
列表时,定制显示的列。
1
2
3
4
5
6
|
@admin .register(models.UserInfo) class UserAdmin(admin.ModelAdmin): list_display = ( ‘user‘ , ‘pwd‘ , ‘xxxxx‘ ) def xxxxx( self , obj): return "xxxxx" |
list_display_links
列表时,定制列可以点击跳转。
1
2
3
4
|
@admin .register(models.UserInfo) class UserAdmin(admin.ModelAdmin): list_display = ( ‘user‘ , ‘pwd‘ , ‘xxxxx‘ ) list_display_links = ( ‘pwd‘ ,) |
list_filter
列表时,定制右侧快速筛选。
list_select_related
列表时,连表查询是否自动select_related
list_editable
列表时,可以编辑的列
1
2
3
4
|
@admin .register(models.UserInfo) class UserAdmin(admin.ModelAdmin): list_display = ( ‘user‘ , ‘pwd‘ , ‘ug‘ ,) list_editable = ( ‘ug‘ ,) |
search_fields
列表时,模糊搜索的功能
1
2
3
4
|
@admin .register(models.UserInfo) class UserAdmin(admin.ModelAdmin): search_fields = ( ‘user‘ , ‘pwd‘ ) |
date_hierarchy
列表时,对Date和DateTime类型进行搜索
1
2
3
4
|
@admin .register(models.UserInfo) class UserAdmin(admin.ModelAdmin): date_hierarchy = ‘ctime‘ |
inlines
详细页面,如果有其他表和当前表做FK,那么详细页面可以进行动态增加和删除
1
2
3
4
5
6
7
8
|
class UserInfoInline(admin.StackedInline): # TabularInline extra = 0 model = models.UserInfo class GroupAdminMode(admin.ModelAdmin): list_display = ( ‘id‘ , ‘title‘ ,) inlines = [UserInfoInline, ] |
action
列表时,定制action中的操作
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
@admin .register(models.UserInfo) class UserAdmin(admin.ModelAdmin): # 定制Action行为具体方法 def func( self , request, queryset): print ( self , request, queryset) print (request.POST.getlist( ‘_selected_action‘ )) func.short_description = "中文显示自定义Actions" actions = [func, ] # Action选项都是在页面上方显示 actions_on_top = True # Action选项都是在页面下方显示 actions_on_bottom = False # 是否显示选择个数 actions_selection_counter = True |
定制html模板
1
2
3
4
5
6
|
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 |
raw_id_fields
详细页面,针对FK和M2M字段变成以Input框形式
1
2
3
4
|
@admin .register(models.UserInfo) class UserAdmin(admin.ModelAdmin): raw_id_fields = ( ‘FK字段‘ , ‘M2M字段‘ ,) |
fields
详细页面时,显示字段的字段
1
2
3
|
@admin .register(models.UserInfo) class UserAdmin(admin.ModelAdmin): fields = ( ‘user‘ ,) |
exclude
详细页面时,排除的字段
1
2
3
|
@admin .register(models.UserInfo) class UserAdmin(admin.ModelAdmin): exclude = ( ‘user‘ ,) |
readonly_fields
详细页面时,只读字段
1
2
3
|
@admin .register(models.UserInfo) class UserAdmin(admin.ModelAdmin): readonly_fields = ( ‘user‘ ,) |
fieldsets
详细页面时,使用fieldsets标签对数据进行分割显示
1
2
3
4
5
6
7
8
9
10
11
|
@admin .register(models.UserInfo) class UserAdmin(admin.ModelAdmin): fieldsets = ( ( ‘基本数据‘ , { ‘fields‘ : ( ‘user‘ , ‘pwd‘ , ‘ctime‘ ,) }), ( ‘其他‘ , { ‘classes‘ : ( ‘collapse‘ , ‘wide‘ , ‘extrapretty‘ ), # ‘collapse‘,‘wide‘, ‘extrapretty‘ ‘fields‘ : ( ‘user‘ , ‘pwd‘ ), }), ) |
详细页面
详细页面时,M2M显示时,数据移动选择(方向:上下和左右)
1
2
3
|
@admin .register(models.UserInfo) class UserAdmin(admin.ModelAdmin): filter_vertical = ( "m2m字段" ,) # 或filter_horizontal = ("m2m字段",) |
ordering
列表时,数据排序规则
1
2
3
4
5
6
|
@admin .register(models.UserInfo) class UserAdmin(admin.ModelAdmin): ordering = ( ‘-id‘ ,) 或 def get_ordering( self , request): return [ ‘-id‘ , ] |
radio_fields
详细页面时,使用radio显示选项(FK默认使用select)
1
|
radio_fields = { "ug" : admin.VERTICAL} # 或admin.HORIZONTAL |
form = ModelForm
用于定制用户请求时候表单验证
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
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 |
empty_value_display
empty_value_display = "列数据为空时,显示默认值"
1
2
3
4
5
6
7
8
9
|
@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 = "指定列数据为空时,默认显示" |
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
|
from django.contrib import admin # Register your models here. from .models import * class BookInline(admin.StackedInline): # TabularInline extra = 0 model = Book class BookAdmin(admin.ModelAdmin): list_display = ( "title" , ‘publishDate‘ , ‘price‘ , "foo" , "publisher" ) list_display_links = ( ‘publishDate‘ , "price" ) list_filter = ( ‘price‘ ,) list_editable = ( "title" , "publisher" ) search_fields = ( ‘title‘ ,) date_hierarchy = ‘publishDate‘ preserve_filters = False def foo( self ,obj): return obj.title + str (obj.price) # 定制Action行为具体方法 def func( self , request, queryset): print ( self , request, queryset) print (request.POST.getlist( ‘_selected_action‘ )) func.short_description = "中文显示自定义Actions" actions = [func, ] # Action选项都是在页面上方显示 actions_on_top = True # Action选项都是在页面下方显示 actions_on_bottom = False # 是否显示选择个数 actions_selection_counter = True change_list_template = "my_change_list_template.html" class PublishAdmin(admin.ModelAdmin): list_display = ( ‘name‘ , ‘email‘ ,) inlines = [BookInline, ] admin.site.register(Book, BookAdmin) # 第一个参数可以是列表 admin.site.register(Publish,PublishAdmin) admin.site.register(Author) |
以上是关于Django框架 之 admin管理工具(组件使用)的主要内容,如果未能解决你的问题,请参考以下文章