DjangoAdmin插件详解与应用

一、Django Admin 概述

Django Admin 是 Django 框架提供的一款强大的后台管理系统，主要用于简化数据库管理任务。它允许开发者通过简单的配置，即可实现对数据库表的增删改查操作，极大提升了开发效率。

1. Admin 的核心功能

Django Admin 的设计初衷是为了让开发者能够更加便捷地进行后台数据管理。通过在项目中定义模型（models），并将其注册到 Admin 后，即可在后台界面中直接操作这些模型对应的数据库表。

2. 使用环境

(1) 首先，确保项目中的 models.py 文件中定义了相应的模型类：

from django.db import models
class UserInfo(models.Model):
    name = models.CharField(max_length=32)
    email = models.EmailField(max_length=32)

class GroupInfo(models.Model):
    groupname = models.CharField(max_length=32)
    nickname = models.CharField(max_length=32)

(2) 在项目的 admin.py 文件中注册需要操作的模型类：

from django.contrib import admin
from . import models

admin.site.register(models.UserInfo)
admin.site.register(models.GroupInfo)

3. 自动注册路由

完成上述步骤后，Django 会自动为每个注册的模型类生成一系列的 URL 路由，例如：

/admin/app01/userinfo/  # 查看表数据
/admin/app01/userinfo/add/  # 增加表数据
/admin/app01/userinfo/2/change/  # 修改表数据，其中 2 是主键 ID
/admin/app01/userinfo/2/delete/  # 删除表数据

4. 进入 Admin 后台配置页面

登录 Admin 后台后，可以看到已注册的模型类的数据展示页面。默认情况下，每条记录显示为 'ModelName object'，这是因为 Django 默认获取的是整条记录的对象。可以通过定义模型类中的 __str__ 方法来改变这一显示方式：

class UserInfo(models.Model):
    name = models.CharField(max_length=32)
    email = models.EmailField(max_length=32)

    def __str__(self):
        return self.name

二、自定义 Admin 方法

1. 注册模型类

(1) 直接注册：

from django.contrib import admin
from . import models

class CustomAdmin(admin.ModelAdmin):
    list_display = ['name', 'email']

admin.site.register(models.UserInfo, CustomAdmin)

(2) 使用装饰器注册：

from django.contrib import admin
from . import models

@admin.register(models.UserInfo)
class CustomAdmin(admin.ModelAdmin):
    list_display = ['name', 'email']

2. 自定义 Admin 功能

(1) list_display：自定义列表显示的字段，支持通过定义方法动态生成内容。

(2) list_display_links：设置列表中可点击链接的字段，点击后跳转到详情页面。

(3) list_filter：右侧快速筛选功能，支持多字段组合筛选。

(4) list_select_related：优化查询性能，减少数据库查询次数。

(5) 分页设置：控制每页显示的记录数量及是否显示全部记录的选项。

(6) list_editable：使某些字段在列表视图中可直接编辑。

(7) search_fields：设置可搜索的字段，支持模糊搜索。

(8) date_hierarchy：按日期层次结构进行筛选。

(9) preserve_filters：保持搜索条件，即使在进行删除或修改操作后也能保留原有的搜索状态。

(10) save_as：控制保存新记录时的行为，如是否重定向到新增记录页面。

(11) inlines：在详细页面中嵌套其他模型的编辑功能，适用于多对一或多对多关系的管理。

(12) action：定义批量操作，如批量删除、批量修改等。

(13) 自定义 HTML 模板：允许开发者自定义 Admin 页面的布局和样式。

(14) raw_id_fields：将 ForeignKey 和 ManyToManyField 字段转换为输入框，适用于关联数据量较大的情况。

(15) fields 和 exclude：分别用于指定显示和排除的字段。

(16) readonly_fields：设置只读字段，防止误修改。

(17) fieldsets：对详细页面的字段进行分组显示，提高界面的组织性和可读性。

(18) filter_vertical 和 filter_horizontal：控制 ManyToManyField 字段的选择方式，支持上下和左右移动数据。

(19) ordering：设置数据的排序规则。

(20) view_on_site：控制是否显示“查看网站”链接。

(21) radio_fields：将 ForeignKey 字段的显示方式从下拉菜单改为单选按钮。

(22) show_full_result_count：控制搜索结果总数的显示格式。

(23) formfield_overrides：自定义字段的显示样式，如使用自定义的文本区域组件。

(24) prepopulated_fields：根据其他字段的值自动填充指定字段。

(25) form：使用自定义的 ModelForm 进行表单验证。

(26) empty_value_display：设置字段为空时的默认显示值。

总结：通过上述配置，开发者可以充分利用 Django Admin 的强大功能，高效地管理和维护数据库中的数据。每个配置项都需创建一个继承自 admin.ModelAdmin 的类，并在类中定义相应的属性或方法，以实现特定的功能需求。