Django之admin后台管理

admin后台管理

Django框架提供了一个自动化后台管理功能，对网站数据的后台维护，仅仅需要进行非常简单的配置和编写极少的代码即可实现。

配置

settings.py中：


INSTALLED_APPS = [
    'django.contrib.admin',
]

如果需要实现后台管理的中文显示，则修改以下配置：


LANGUAGE_CODE = 'zh-Hans'
USE_I18N = True

URL路由

urls.py中：


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

创建管理员账户

创建管理员账户之前，确保项目的数据库已经正确连接，并且已经将admin应用的模型进行了迁移
另外，如果settings中配置了 AUTH_PASSWORD_VALIDATORS，那么会对用户名和密码进行对应的检测，譬如：不能太简单，不能是纯数字等

项目根目录下 cmd 命令窗口运行以下命令：


python manage.py createsuperuser

输入用户名并按回车：


Username: admin

提示电子邮件地址：


Email address: admin@163.com

最后一步是输入密码，将被要求输入两次密码，第二次作为第一次确认：


Password: **********

Password (again): *********

Superuser created successfully.

基本模型管理

1、建立模型

在model.py中：


class Student(models.Model):

    name = models.CharField(max_length=20)
    age = models.IntegerField()

2、添加模型管理

在admin.py中：


from django.contrib import admin

from .models import Student

#注册
admin.site.register(Student)

3、在浏览器中访问

访问path为 /admin，譬如：http://127.0.0.1:8000/admin

4、完善显示


class Student(models.Model):
	
    # 增加 verbose_name
    name = models.CharField(max_length=20, verbose_name='姓名')
    
    # 增加 help_text
    age = models.IntegerField(help_text='大于18', verbose_name='年龄')

    # 增加 Meta 类
    class Meta:
	    # verbose_name_plural ： 复数形式
        verbose_name_plural = verbose_name = '学生'

    # 模型类的 字符串化
    def __str__(self):
        return f'{self.name}({self.pk})'

在子应用下的 apps.py中：


class TestAppConfig(AppConfig):

    verbose_name = '子应用名'

5、特殊下拉属性管理


class Student(models.Model):
	
    SEX_CHOICES = ((1,'男')), (2, '女')
    
    # 增加 verbose_name
    name = models.CharField(max_length=20, verbose_name='姓名')
    
    # 增加 help_text
    age = models.IntegerField(help_text='大于18', verbose_name='年龄')
	
    # 修改已有模型，增加新字段的话，都需要设置默认值或者设置 null=True
    sex = models.IntegerField(choices=SEX_CHOICES, default=1， verbose_name='性别')
    
    # 增加 Meta 类
    class Meta:
	    # verbose_name_plural ： 复数形式
        verbose_name_plural = verbose_name = '学生'

    # 模型类的 字符串化
    def __str__(self):
        return f'{self.name}({self.pk})'

关系模型管理

1、建立模型


# 一对一
class 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.name

    class 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.name

    class Meta:

        verbose_name_plural = verbose_name = '服务员'


# 多对多
class SchoolClass(models.Model):
    name = models.CharField(max_length=20, verbose_name='班级名')

    class Meta:

        verbose_name_plural = verbose_name = '班级'

    def __str__(self):
        return self.name

class 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

2、添加模型管理


admin.site.register(Place)
admin.site.register(Restaurant)
admin.site.register(Waiter)
admin.site.register(Teacher)
admin.site.register(SchoolClass)

自定义模型管理类

之前使用的 admin.site.register(Student) 是用的 Django 默认的管理类，也可以自定义：


class StudentAdmin(admin.ModelAdmin):
    pass

admin.site.register(Student, StudentAdmin)

自定义管理类的属性：


class StudentAdmin(admin.ModelAdmin):
	
    # 显示的属性列表， 值是 属性名
    list_display = ['name', 'age']
    
    # 排序的 属性 列表 ， 默认是升序，如果需要降序：['-age']
    ordering = ['age']

admin.site.register(Student, StudentAdmin)

使用装饰器注册：


@admin.register(Student)
class StudentAdmin(admin.ModelAdmin):
	
    list_display = ['name', 'age']
    ordering = ['age']

自定义模型管理类的属性：


@admin.register(Student)
class StudentAdmin(admin.ModelAdmin):
    
    # 属性为空时，在网页上显示的内容，默认是： -
    empty_value_display = '自定义内容'
    
    # 管理的字段， 和 exclude冲突
    fields = ('name',)
    
    # 不管理的字段，和 fields冲突
    exclude = ('age',)

多对多关系，默认是 select多选框，一般使用 filter_horizontal 或者 filter_vertical


@admin.register(Teacher)
class TeacherAdmin(admin.ModelAdmin):

    ordering = ('name', )
	
	# 水平模式
    filter_horizontal = ('school_class', )

增加额外批量操作

在admin.py中：

动作函数是单独的模块函数：


# 定义动作函数
def age_add_one(modeladmin, request, queryset):
    queryset.update(age=F('age')+1)

# 给动作函数添加描述
age_add_one.short_description = "年龄增加一岁"

class StudentAdmin(admin.ModelAdmin):
    # 在当前自定义管理类中，添加新的动作：age_add_one
    actions = [age_add_one]

admin.site.register(Student, StudentAdmin)

动作函数写在自定义管理类中作为一个方法：


class StudentAdmin(admin.ModelAdmin):
    # 这里必须是函数名的字符串
    actions = ['age_add_one']
	
    # 类方法也同样是3个参数！
    def age_add_one(modeladmin, request, queryset):
        queryset.update(age=F('age') + 1)

    age_add_one.short_description = "年龄增加一岁"

admin.site.register(Student, StudentAdmin)

覆盖admin默认模板

如果要在admin管理页面中，增加自己的功能，那么需要覆盖admin的默认模板，通过以下步骤实现：

1、admin允许覆盖的页面

app_index.html
change_form.html
change_list.html
delete_confirmation.html
object_history.html
popup_response.html

2、admin管理模板目录

django库下的 contrib/admin/templates/admin 目录，可以查看django自带的所有模板

3、自定义模板

需要修改admin的哪个内置模板，则继承哪个模板，并且在其基础上进行修改，我们以app_index.html为例：
原始模板是：


{% extends "admin/index.html" %}
{% load i18n %}

{% block bodyclass %}{{ block.super }} app-{{ app_label }}{% endblock %}

{% if not is_popup %}
{% block breadcrumbs %}
<div class="breadcrumbs">
<a href="{% url 'admin:index' %}">{% trans 'Home' %}</a>
&rsaquo;
{% for app in app_list %}
{{ app.name }}
{% endfor %}
</div>
{% endblock %}
{% endif %}

{% block sidebar %}{% endblock %}

4、建立对应模板

在settings中配置的templates目录下，建立admin目录，并且在admin目录下，建立mysite目录（mysite是你的应用名，假设mysite是children）
不需要修改原始模板所有的block，只需要在要添加功能的地方，进行继承，并且修改就行了，如下：


{% extends "admin/app_index.html" %}

{% block sidebar %}
    <a href="{% url 'children:customize' %}">自定义功能页面</a>
{% endblock %}

5、修改 urls


path('customize/', views.customize, name='customize'),

6、修改 views


def customize(request):    
    """
        编写自己的自定义管理功能 
    """    
    return redirect('/admin/children/')

来源：CSDN

作者：Python'sGod

链接：https://blog.csdn.net/weixin_44733660/article/details/104169270

标签

django

后台管理

admin