码迷，mamicode.com
首页 > 其他好文 > 详细

Django框架 之 admin管理工具（组件使用）

时间：2018-08-31 21:20:49      阅读：185      评论：0      收藏：0      [点我收藏+]

标签：lsp   筛选   选择   开发   pad   cat   sage   temp   pac   

浏览目录

  • 激活管理工具

  • 使用管理工具

  • 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管理工具（组件使用）

标签：lsp   筛选   选择   开发   pad   cat   sage   temp   pac   

原文地址：https://www.cnblogs.com/hanbowen/p/9567461.html

踩
(0)
赞
(0)
   
举报
评论 一句话评论（0）
登录后才能评论！
分享档案
更多>
2021年07月29日 (22)
2021年07月28日 (40)
2021年07月27日 (32)
2021年07月26日 (79)
2021年07月23日 (29)
2021年07月22日 (30)
2021年07月21日 (42)
2021年07月20日 (16)
2021年07月19日 (90)
2021年07月16日 (35)
周排行
mamicode.com排行更多图片
更多
友情链接
兰亭集智   国之画   百度统计   站长统计   阿里云   chrome插件   新版天听网
关于我们 - 联系我们 - 留言反馈
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码！