13.django-admin组件

阅读原文时间：2023年07月09日阅读：1

Django内置了一个强大的组件叫Admin，提供给网站管理员快速开发运营后台的管理站点,下面通过案例进行操作

1.创建模型类

模型类如下：

from django.db import models

Create your models here.

class Classes(models.Model):
""" 班级表 """
title = models.CharField(max_length=32, verbose_name='班级名称')

def \_\_str\_\_(self):  
    return self.title

class Students(models.Model):
""" 学生表 """
username = models.CharField(max_length=128, default=None, null=True, verbose_name='学生姓名')
mobile = models.CharField(max_length=32, null=True, unique=True, verbose_name='手机号', help_text='手机号')
wxchat = models.CharField(max_length=100, null=True, unique=True, verbose_name='微信', help_text='微信')
qq_number = models.CharField(max_length=16, null=True, unique=True, verbose_name='QQ', help_text='QQ')
nickname = models.CharField(max_length=128, default=None, null=True, verbose_name='昵称')
age = models.SmallIntegerField(verbose_name='年龄')
email = models.CharField(max_length=128, default=None, null=True, verbose_name='邮箱')
en_date = models.DateField(verbose_name='入学日期')
addr = models.CharField(max_length=32, default=None, null=True, verbose_name='地址')
to_classes = models.ForeignKey('Classes', default=1, verbose_name='所属班级', on_delete=models.CASCADE)

def \_\_str\_\_(self):  
    return self.username

生成数据库表

python manage.py makemigrations
python manage.py migrate

2. 使用脚本生成测试数据

在项目根目录下创建test.py脚本如下：

import os
import django
import random
import faker # pip install faker

os.environ.setdefault("DJANGO_SETTINGS_MODULE", "adminStudy.settings") # MB：项目名称
django.setup()

from student import models

fk = faker.Faker(locale='zh_CN')

def create():
models.Classes.objects.bulk_create((models.Classes(i, random.randrange(100, 500)) for i in range(10)))
gen = (
models.Students(
i,
fk.name(),
fk.phone_number(),
fk.phone_number(),
fk.phone_number(),
fk.user_name(),
random.randrange(15, 20),
fk.email(),
fk.date(),
fk.city_name(),
random.randrange(0, 9)
) for i in range(1, 1001)
)
models.Students.objects.bulk_create(gen)

if __name__ == '__main__':
create()

3. 创建超级管理员

命令

python manage.py createsuperuser # 创建管理员命令

4. 使用管理员登录

django项目默认帮助我们生成管理员登录路由了

urlpatterns = [
path('admin/', admin.site.urls),
]

我们在浏览器中输入地址

http://127.0.0.1:8080/admin/login/

登录页面如下

使用用户名和密码登录，页面如下

5.将我们的模型类纳入admin管理

在子项目的admin中写入如下代码

from django.contrib import admin
from student import models

class StudentModelAdmin(admin.ModelAdmin): # 必须继承 admin.ModelAdmin
pass

@admin.register(models.Classes) # 或者使用装饰器进行注册
class ClassesModelAdmin(admin.ModelAdmin):
pass

再次访问页面如下

6.中文显示

我们希望将系统语言，项目名称和表名称都换成指定中文

系统语言，设置settings.py

# LANGUAGE_CODE = 'en-us'
LANGUAGE_CODE = 'zh-hans'
项目名称，设置子项目的apps.py文件

from django.apps import AppConfig

class StudentConfig(AppConfig):
default_auto_field = 'django.db.models.BigAutoField'
name = 'student'
verbose_name = "学生信息管理"
表名称，设置模型类如下

from django.db import models

Create your models here.

class Classes(models.Model):
""" 班级表 """
title = models.CharField(max_length=32, verbose_name='班级名称')
```
def \_\_str\_\_(self):  
    return self.title

class Meta:  
    verbose\_name = '班级'  
    verbose\_name\_plural = '班级'
```
class Students(models.Model):
""" 学生表 """
username = models.CharField(max_length=128, default=None, null=True, verbose_name='学生姓名')
mobile = models.CharField(max_length=32, null=True, unique=True, verbose_name='手机号', help_text='手机号')
wxchat = models.CharField(max_length=100, null=True, unique=True, verbose_name='微信', help_text='微信')
qq_number = models.CharField(max_length=16, null=True, unique=True, verbose_name='QQ', help_text='QQ')
nickname = models.CharField(max_length=128, default=None, null=True, verbose_name='昵称')
age = models.SmallIntegerField(verbose_name='年龄')
email = models.CharField(max_length=128, default=None, null=True, verbose_name='邮箱')
en_date = models.DateField(verbose_name='入学日期')
addr = models.CharField(max_length=32, default=None, null=True, verbose_name='地址')
to_classes = models.ForeignKey('Classes', default=1, verbose_name='所属班级', on_delete=models.CASCADE)
```
def \_\_str\_\_(self):  
    return self.username

class Meta:  
    verbose\_name = '学生'  
    verbose\_name\_plural = '学生'
```

此时页面如下

7.表显设置

我们可以很大程度上自定义设置页面显示内容,官网：https://docs.djangoproject.com/en/2.1/ref/contrib/admin/

一开始，学生表的显示如下，非常单调且不友好

完善如下：

添加班级时，可以通过设置inlines字段同时为该班级添加一些学生，因为学生表ForeignKey的班级表。

actions即在列表页，可操作的一些功能，它默认实现了一个删除操作：

1 from django.contrib import admin
2 from student import models
3
4
5 class StudentModelAdmin(admin.ModelAdmin): # 必须继承 admin.ModelAdmin
6 """ 用户模型管理类，用于在admin后台对Students模型类进行扩展 """
7 list_per_page = 20 # 列表页每页展示数据的条数控制
8 # 在列表页展示哪些字段
9 list_display = ['id', 'username', 'age', 'email', 'mobile', 'nickname', 'to_classes']
10 # 设置点击指定字段跳转到编辑页面
11 list_display_links = ['id', 'username', 'age']
12 # 默认是以id进行排序，你也可以通过ordering，设置指定字段排序
13 # ordering = ['-age'] # ['age']: 升序； ['-age']: 降序
14 ordering = ['-age', 'id'] # 年龄相同的，就按照id升序排序
15 actions_on_top = True # 上方操作栏是否显示，False表示隐藏
16 # actions_on_bottom = True # 下方操作栏是否显示，False表示隐藏
17 list_filter = ['to_classes', 'age', 'en_date'] # 过滤器，按指定字段进行筛选过滤, 可以写多个过滤器，在右侧展示
18 search_fields = ['username', 'nickname'] # 指定字段搜索
19 # 注意，要编辑的字段必须在list_display中，但是也必须不在list_display_links中
20 # list_editable = ['email', 'mobile']
21 # date_hierarchy = "en_date" # 按照入学时间不同，可以进行过滤，在上方展示，这个筛选必须是日期时间相关的字段
22
23 def my_edit(self, request, queryset):
24 """ 将选中的记录，年龄设置为10 """
25 print(request.POST.getlist("_selected_action")) # ['5', '12']
26 pk_list = request.POST.getlist("_selected_action")
27 models.Students.objects.filter(pk__in=pk_list).update(age=10)
28
29 my_edit.short_description = "自定义编辑功能"
30
31 def my_edit2(self, request, queryset):
32 """ 将选中的记录，年龄设置为10 """
33 print(request.POST.getlist("_selected_action")) # ['5', '12']
34 pk_list = request.POST.getlist("_selected_action")
35 models.Students.objects.filter(pk__in=pk_list).update(age=10)
36
37 my_edit.short_description = "自定义编辑功能2"
38 actions = [my_edit,my_edit2]
39 admin.site.register(models.Students, StudentModelAdmin) # 必须进行注册
40
41
42 @admin.register(models.Classes) # 或者使用装饰器进行注册
43 class ClassesModelAdmin(admin.ModelAdmin):
44 class StudentInline(admin.StackedInline): # 必须这么继承，当然这个类也可以写在ClassesModelAdmin外面
45 """
46 这两个就样式不同而已
47 admin.StackedInline: 竖着
48 admin.TabularInline: 横着
49 """
50 extra = 1 # 默认一次性添加几条记录
51 model = models.Students
52
53 inlines = [StudentInline]

显示效果

8.simple-ui:美化页面

详细请见：https://simpleui.72wo.com/docs/simpleui/

安装：

pip install django-simpleui

配置

INSTALLED_APPS = [
'simpleui',
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
…
]

页面如下