Django 3：如何向管理后台base.html传递模型上下文

Hey，针对你在Django 3里想要给自定义的admin base.html传递模型上下文数据的需求，我整理了几个经过实践验证的可行方案，你可以根据自己的场景选择：

方案1：自定义AdminSite（全局生效，推荐） #

这是Django官方推荐的扩展admin全局行为的方式，通过重写each_context方法，可以把数据注入到所有admin页面的上下文里，包括你自定义的base.html。

步骤如下：

1. 在你的admin.py里创建自定义的AdminSite类：

from django.contrib.admin import AdminSite
from .models import YourTargetModel

class CustomAdminSite(AdminSite):
    def each_context(self, request):
        # 先获取默认的上下文数据
        context = super().each_context(request)
        # 在这里添加你的模型数据，比如获取最新的3条记录
        context['latest_model_entries'] = YourTargetModel.objects.order_by('-created_at')[:3]
        # 还可以添加其他自定义数据
        context['site_custom_title'] = "我的自定义后台"
        return context

# 实例化自定义的admin站点
custom_admin_site = CustomAdminSite(name='custom_admin')

2. 把你的模型注册到这个自定义站点（替换原来的admin.site.register）：

# 替换原来的 admin.site.register(YourTargetModel)
custom_admin_site.register(YourTargetModel)
# 如果有其他模型，也需要注册到这里
custom_admin_site.register(AnotherModel)

3. 在urls.py里替换默认的admin路由：

from django.urls import path
from .admin import custom_admin_site

urlpatterns = [
    # 替换原来的 path('admin/', admin.site.urls)
    path('admin/', custom_admin_site.urls),
    # 其他路由...
]

这样一来，所有admin页面的base.html都能直接使用{{ latest_model_entries }}这类变量了。

方案2：自定义上下文处理器（灵活控制范围） #

如果你不想修改AdminSite的结构，可以用Django的上下文处理器来给admin页面注入数据，还能灵活控制只在admin路径下传递数据。

步骤如下：

1. 在你的app目录下创建context_processors.py文件：

from .models import YourTargetModel

def admin_custom_context(request):
    # 只在admin页面传递数据，避免影响前端模板
    if request.path.startswith('/admin/'):
        return {
            'popular_items': YourTargetModel.objects.filter(is_popular=True),
            'admin_notice': "今日数据更新完成"
        }
    # 非admin页面返回空字典，不添加额外上下文
    return {}

2. 在settings.py的TEMPLATES配置里添加这个处理器：

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                # 保留默认的处理器
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
                # 添加你的自定义上下文处理器
                'your_app_name.context_processors.admin_custom_context',
            ],
        },
    },
]

之后，所有admin页面的base.html就能访问{{ popular_items }}这些变量了。

方案3：重写特定ModelAdmin的视图（局部生效） #

如果你只需要给某个特定模型的admin页面传递数据（比如只在某个模型的列表页显示自定义数据），可以重写对应ModelAdmin的视图方法。

比如，给YourTargetModel的列表页添加上下文：

from django.contrib import admin
from .models import YourTargetModel

class YourModelAdmin(admin.ModelAdmin):
    def change_list_view(self, request, extra_context=None):
        # 初始化extra_context，避免None报错
        extra_context = extra_context or {}
        # 添加自定义数据到上下文
        extra_context['stats_data'] = YourTargetModel.objects.aggregate(total_count=models.Count('id'))
        # 调用父类方法，传递修改后的extra_context
        return super().change_list_view(request, extra_context=extra_context)

# 注册模型时使用自定义的ModelAdmin
admin.site.register(YourTargetModel, YourModelAdmin)

这种方式下，只有该模型的列表页能拿到{{ stats_data }}，其他admin页面不会受到影响。

一些注意事项 #

• 数据库查询要优化：如果上下文里的查询数据量较大，记得用select_related或prefetch_related减少数据库请求，避免拖慢admin页面加载速度。
• 权限控制：如果数据需要根据当前登录用户的权限过滤，记得在查询时加入request.user相关的条件，比如YourTargetModel.objects.filter(created_by=request.user)。

内容的提问来源于stack exchange，提问作者Make Up