【0基础秒入门】Django教程：深入定制Admin后台管理系统

前言

在Django开发中，Admin后台管理系统是一个极其强大的内置功能，它能够自动生成数据模型的增删改查界面。本教程将带你深入了解如何定制Django Admin后台，使其更加符合项目需求。

Admin表单定制

字段顺序调整

默认情况下，Django会根据模型定义顺序显示字段。但我们可以通过创建ModelAdmin子类来改变这一行为：

from django.contrib import admin
from .models import Question

class QuestionAdmin(admin.ModelAdmin):
    fields = ['pub_date', 'question_text']

admin.site.register(Question, QuestionAdmin)

这种定制方式特别适用于表单字段较多时，合理的字段顺序能显著提升用户体验。

字段分组

当模型字段较多时，使用fieldsets将它们分组显示会更加清晰：

class QuestionAdmin(admin.ModelAdmin):
    fieldsets = [
        (None, {'fields': ['question_text']}),
        ('日期信息', {'fields': ['pub_date'], 'classes': ['collapse']}),
    ]

这里我们：

1. 将问题文本作为主要字段单独显示
2. 将发布日期字段分组显示，并添加可折叠功能

关联对象管理

内联编辑

对于一对多关系的模型（如Question和Choice），我们可以使用内联编辑功能：

class ChoiceInline(admin.StackedInline):
    model = Choice
    extra = 3

class QuestionAdmin(admin.ModelAdmin):
    inlines = [ChoiceInline]

这种方式的优势在于：

• 可以直接在Question编辑页面管理关联的Choice
• 通过extra参数设置默认显示的Choice数量
• 支持动态添加/删除Choice

表格形式内联

StackedInline会占用较多垂直空间，我们可以改用TabularInline：

class ChoiceInline(admin.TabularInline):
    model = Choice
    extra = 3

表格形式更加紧凑，特别适合字段较少但数量较多的关联对象。

列表页定制

显示字段定制

默认情况下，列表页只显示对象的字符串表示。我们可以自定义显示的字段：

class QuestionAdmin(admin.ModelAdmin):
    list_display = ['question_text', 'pub_date', 'was_published_recently']

方法字段优化

对于自定义方法字段，我们可以使用@admin.display装饰器增强其表现：

@admin.display(
    boolean=True,
    ordering='pub_date',
    description='最近发布?',
)
def was_published_recently(self):
    now = timezone.now()
    return now - datetime.timedelta(days=1) <= self.pub_date <= now

筛选与搜索

添加筛选和搜索功能可以极大提升管理效率：

class QuestionAdmin(admin.ModelAdmin):
    list_filter = ['pub_date']  # 添加日期筛选
    search_fields = ['question_text']  # 添加搜索框

界面视觉定制

项目模板定制

1. 在项目根目录创建templates/admin目录
2. 复制Django默认的admin/base_site.html到该目录
3. 修改branding块内容：

{% block branding %}
<div id="site-name"><a href="{% url 'admin:index' %}">投票系统管理后台</a></div>
{% if user.is_anonymous %}
  {% include "admin/color_theme_toggle.html" %}
{% endif %}
{% endblock %}

应用模板定制

对于应用特定的模板，建议放在应用内部的templates目录中，这样便于应用复用：

polls/
    templates/
        admin/
            app_index.html

高级技巧

列表页分页

默认每页显示100条记录，可以通过list_per_page调整：

class QuestionAdmin(admin.ModelAdmin):
    list_per_page = 20

日期层级导航

对于日期字段，可以添加date_hierarchy实现层级导航：

class QuestionAdmin(admin.ModelAdmin):
    date_hierarchy = 'pub_date'

总结

通过本教程，我们学习了如何全方位定制Django Admin后台，包括：

• 表单字段的排序和分组
• 关联对象的内联管理
• 列表页的显示、筛选和搜索功能
• 界面视觉的个性化定制

这些定制技巧能够让你的Admin后台更加符合项目需求，提升管理效率。记住，良好的后台设计不仅能提高开发效率，也能改善内容管理人员的体验。