Django框架提供了一个自动化后台管理功能,对网站数据的后台维护,仅仅需要进行非常简单的配置和编写极少的代码即可实现。
首先创建一个Django项目admin_study,然后创建连接数据库,在数据库中创建好表数据库后,进行数据库的预备迁移和迁移。具体操作流程可以查看上一篇文章
如何进行项目搭建以及连接数据库
settings.py中:
INSTALLED_APPS = ['django.contrib.admin',
]
如果需要实现后台管理的中文显示,则修改以下配置:
LANGUAGE_CODE = 'zh-Hans'
USE_I18N = True
urls.py中:
urlpatterns = [path('admin/', admin.site.urls),
]
创建管理员账户之前,确保项目的数据库已经正确连接,并且已经将admin应用的模型进行了迁移
另外,如果settings中配置了 AUTH_PASSWORD_VALIDATORS,那么会对用户名和密码进行对应的检测,譬如:不能太简单,不能是纯数字等


进入后台管理

创建子应用
python manage.py startapp student_app
在子应用models中建立模型
from django.db import modelsclass Student(models.Model):sname = models.CharField(max_length=30)sage = models.IntegerField()# 返回数据,用于显示def __str__(self) -> str:return f'{self.sname, self.sage}'
配置子应用
INSTALLED_APPS = ['student_app',
]
数据库迁移
python manage.py makemigrationspython manage.py migrate
注册模型(否则后台无法访问)在admin.py中
from django.contrib import admin# Register your models here.
from .models import Student
admin.site.register(Student)
再次启动服务

创建子应用
python manage.py startapp student_app2
配置参考方法4.1
在app中修改应用名称
from django.apps import AppConfig
class StudentApp2Config(AppConfig):default_auto_field = 'django.db.models.BigAutoField'name = 'student_app2'verbose_name = '学生子应用' # 修改应用名称
创建模型
from django.db import models
# Create your models here.
class Student(models.Model):sname = models.CharField(max_length=30, verbose_name='姓名')sage = models.IntegerField(verbose_name='年龄')class Meta:# verbose_name_plural: 复数形式# verbose_name 显示描述信息verbose_name_plural = verbose_name = '学生'def __str__(self) -> str:return f'{self.sname}, {self.sage}'

创建子应用,配置方法参考4.1
模型创建
from django.db import models# Create your models here.
class Student(models.Model):SEX_CHOICES=((1,'男'),(2,'女')) # 定义元组作为下拉框sname = models.CharField(max_length=20, verbose_name='姓名')sage = models.IntegerField(help_text='大于18', verbose_name='年龄')sex = models.IntegerField(choices=SEX_CHOICES, default=1, verbose_name='性别')# 增加 Meta类class Meta:verbose_name_plural = verbose_name = "学生"# 模型类的字符串化def __str__(self) -> str:return f'{self.sname}({self.pk})'

创建子应用——one_more_app
创建一对一和一对多模型
from django.db import modelsclass Place(models.Model):name = models.CharField(max_length=50, verbose_name='地名')address = models.CharField(max_length=80, verbose_name='门牌')def __str__(self):return f'{self.name}-{self.address}'class Meta:verbose_name_plural = verbose_name = '地址'class Restaurant(models.Model):place = models.OneToOneField(Place,on_delete=models.CASCADE,primary_key=True,verbose_name='地址')name = models.CharField(max_length=50, verbose_name='名字')# BooleanField 在数据库使用 tinyint 类型serves_hot_dogs = models.BooleanField(default=False, verbose_name='经营热狗')serves_pizza = models.BooleanField(default=False, verbose_name='经营披萨')def __str__(self):return self.nameclass Meta:verbose_name_plural = verbose_name = '餐馆'class Waiter(models.Model):restaurant = models.ForeignKey(Restaurant, on_delete=models.CASCADE, verbose_name='餐馆')name = models.CharField(max_length=50, verbose_name='姓名')def __str__(self):return self.nameclass Meta:verbose_name_plural = verbose_name = '服务员'
在一对一模型中,添加完主表,关联表就采用下拉框的形式输入

采用布尔值,采用单选框的形式

后台管理多对多模型
from django.db import modelsclass SchoolClass(models.Model):name = models.CharField(max_length=20, verbose_name='班级名')class Meta:verbose_name_plural = verbose_name = '班级'def __str__(self):return self.nameclass Teacher(models.Model):name = models.CharField(max_length=10, verbose_name='姓名')school_class = models.ManyToManyField(SchoolClass, verbose_name='班级')class Meta:verbose_name_plural = verbose_name = '老师'def __str__(self):return self.name


之前使用的 admin.site.register(Student) 是用的 Django 默认的管理类,也可以自定义:
模型
from django.db import models# Create your models here.
class Person(models.Model):pname = models.CharField(max_length=30, verbose_name='姓名')age = models.IntegerField(help_text='大于18', verbose_name='年龄')def __str__(self) -> str:return f'{self.pname}---{self.age}'class Meta:verbose_name_plural = verbose_name = '用户'
后台管理admin.py
from django.contrib import admin# Register your models here.
from .models import Person
# 默认方式管理
# admin.site.register(Person)# 自定义方式管理方法1:
# 定义管理的方法类
# class PersonAdmin(admin.ModelAdmin):
# list_display = ['pname', 'age'] # 展示时的数据列表
# ordering = ['-age'] # 排序方式
# # 给对应的模型类注册对应的方法
# admin.site.register(Person, PersonAdmin)# 自定义方式管理方法2:
# 使用装饰器管理
@admin.register(Person)
class PersonAdmin(admin.ModelAdmin):list_display = ['pname', 'age'] # 展示时的数据列表ordering = ['-age'] # 排序方式
定义是否需要管理与是否必须填写字段
@admin.register(Person)
class PersonAdmin(admin.ModelAdmin):list_display = ['pname', 'age'] # 展示时的数据列表ordering = ['-age'] # 排序方式# 定义需要管理的字段,需要在admin中添加# fields = ('pname',)# 定义不需要管理的字段,不需要在admin中添加# exclude = ('age',)class Person(models.Model):pname = models.CharField(max_length=30, verbose_name='姓名', null=True, blank=True)
优化多对多模型中的查询框

from django.contrib import admin# Register your models here.
from .models import *
admin.site.register(SchoolClass)
# admin.site.register(Teacher)@admin.register(Teacher)
class TeacherAdmin(admin.ModelAdmin):ordering = ('name',)filter_horizontal=('school_class', )# 修改普通选择框

方法1:函数方式添加
# 自定义批量处理函数
from django.db.models import F
def age_add_one(modeladmin,request,queryset):queryset.update(age=F('age')+1)
# 给自定义的方法添加表述信息(用于显示)
age_add_one.short_description = '批量给用户添加一岁'# 自定义方式管理方法2:
# 使用装饰器管理
@admin.register(Person)
class PersonAdmin(admin.ModelAdmin):list_display = ['pname', 'age'] # 展示时的数据列表ordering = ['-age'] # 排序方式actions = [age_add_one]
方法2:定义到类中的方法
# 自定义方式管理方法2:
# 使用装饰器管理
@admin.register(Person)
class PersonAdmin(admin.ModelAdmin):list_display = ['pname', 'age'] # 展示时的数据列表ordering = ['-age'] # 排序方式from django.db.models import Fdef age_add_one(modeladmin,request,queryset):queryset.update(age=F('age')+1)# 给自定义的方法添加表述信息(用于显示)age_add_one.short_description = '批量给用户添加一岁'actions = [age_add_one]
如果我们要在admin管理页面中,增加自己的功能,那么我们需要覆盖admin的默认模板,通过以下步骤实现:
django库下的 contrib/admin/templates/admin 目录,可以查看django自带的所有模板
需要修改admin的哪个内置模板,则继承哪个模板,并且在其基础上进行修改,我们以app_index.html为例:
原始模板是:
{% extends "admin/index.html" %}
{% load i18n %}{% block bodyclass %}{{ block.super }} app-{{ app_label }}{% endblock %}{% if not is_popup %}
{% block breadcrumbs %}
{% trans 'Home' %}
›
{% for app in app_list %}
{{ app.name }}
{% endfor %}
{% endblock %}
{% endif %}{% block sidebar %}{% endblock %}
在settings中配置的templates目录下,建立admin目录,并且在admin目录下,建立mysite目录(mysite是你的应用名,假设mysite是children,那么目录结构如下图)

{%extends "admin/app_index.html" %}
{% block sidebar %}
覆盖admin的app_index.html页面
{% endblock %}