如何为Django Admin首页添加或重写自定义视图？已配置模板

先看了你贴的urls.py配置代码，自定义Admin首页的核心思路是对的，结合Django Admin自定义首页的高频问题，我给你梳理几个针对性的解决方案：

首先贴出你的核心配置方便参考：

from django.contrib import admin
from django.urls import path
from Administrator import views
admin.site.index_template = 'admin/dashboard.html'
admin.autodiscover()
urlpatterns = [
    path('admin/', admin.site.urls),
]

1. 自定义模板无法加载（提示TemplateDoesNotExist） #

• 确认模板路径正确性：dashboard.html必须放在项目或对应App的templates/admin/目录下，比如你的项目根目录/templates/admin/dashboard.html，或者Administrator/templates/admin/dashboard.html
• 检查settings.py的模板配置：确保TEMPLATES中APP_DIRS设为True，或者DIRS列表包含你的模板目录，示例配置：

  TEMPLATES = [
      {
          'BACKEND': 'django.template.backends.django.DjangoTemplates',
          'DIRS': [BASE_DIR / 'templates'],  # 若模板放在项目根目录的templates文件夹下
          'APP_DIRS': True,
          'OPTIONS': {
              'context_processors': [
                  'django.template.context_processors.debug',
                  'django.template.context_processors.request',
                  'django.contrib.auth.context_processors.auth',
                  'django.contrib.messages.context_processors.messages',
              ],
          },
      },
  ]
  

2. 自定义页面丢失Admin的样式与布局 #

你的自定义模板必须继承Django Admin的基础模板，否则会变成无样式的纯HTML页面。推荐两种继承方式：

• 继承admin/index.html：保留原Admin首页的结构，仅修改核心内容
• 继承admin/base_site.html：完全自定义页面布局

示例模板代码（继承admin/index.html）：

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

{% block content %}
<!-- 这里放置你的自定义内容 -->
<div class="module">
    <h2>我的自定义Admin首页</h2>
    <p>欢迎使用定制化后台管理系统</p>
</div>
<!-- 保留原有的App与模型列表 -->
{{ block.super }}
{% endblock %}

3. 需要为首页添加自定义业务逻辑 #

如果你的首页需要展示统计数据、自定义交互等，可将Admin首页路径指向自定义视图，同时继承Admin的上下文保持样式一致性：

from django.contrib.admin.views.decorators import staff_member_required
from django.shortcuts import render

@staff_member_required
def custom_admin_dashboard(request):
    # 这里添加你的自定义逻辑，比如获取业务统计数据
    context = {
        **admin.site.each_context(request),  # 继承Admin的上下文（用户信息、菜单等）
        'custom_stat': "今日订单量：120",
    }
    return render(request, 'admin/dashboard.html', context)

# 修改urlpatterns，将自定义视图放在admin.site.urls前
urlpatterns = [
    path('admin/', custom_admin_dashboard),
    path('admin/', admin.site.urls),  # 保留其他Admin默认路径
]

4. 权限访问问题 #

确保访问自定义Admin首页的用户拥有Staff status权限（在用户编辑页面勾选该选项），否则会被重定向至登录页或无法访问页面。

内容的提问来源于stack exchange，提问作者powerful thoughts