[python] 기본 Django 관리 템플릿을 재정의하고 확장하는 방법은 무엇입니까?

기본 관리 템플릿을 재정의 / 확장하는 데 필요한 모든 정보 가 포함 된 공식 Django 문서에서 단일 답변이나 섹션을 찾을 수 없었기 때문에이 답변을 완전한 가이드로 작성하고 있습니다. 미래의 다른 사람들을 위해.

표준 Django 프로젝트 구조 가정 :

mysite-container/         # project container directory
    manage.py
    mysite/               # project package
        __init__.py
        admin.py
        apps.py
        settings.py
        urls.py
        wsgi.py
    app1/
    app2/
    ...
    static/
    templates/

수행해야 할 작업은 다음과 같습니다.

1. 에서 mysite/admin.py의 하위 클래스를 만듭니다 AdminSite.

   from django.contrib.admin import AdminSite
   
   
   class CustomAdminSite(AdminSite):
       # set values for `site_header`, `site_title`, `index_title` etc.
       site_header = 'Custom Admin Site'
       ...
   
       # extend / override admin views, such as `index()`
       def index(self, request, extra_context=None):
           extra_context = extra_context or {}
   
           # do whatever you want to do and save the values in `extra_context`
           extra_context['world'] = 'Earth'
   
           return super(CustomAdminSite, self).index(request, extra_context)
   
   
   custom_admin_site = CustomAdminSite()

   확실히 가져올 확인 custom_admin_site에서 admin.py앱에 (원하실 경우) 사용자 정의 관리자 사이트에 표시 할에 모델을 등록합니다.

2. 에서 mysite/apps.py의 하위 클래스를 AdminConfig만들고 이전 단계에서로 설정 default_site합니다 admin.CustomAdminSite.

   from django.contrib.admin.apps import AdminConfig
   
   
   class CustomAdminConfig(AdminConfig):
       default_site = 'admin.CustomAdminSite'

3. 에서 mysite/settings.py대체 django.admin.site에 INSTALLED_APPS로 apps.CustomAdminConfig(이전 단계에서 사용자 지정 관리 응용 프로그램 설정).

4. 에서 mysite/urls.py, 교체 admin.site.urls에 대한 관리자의 URL에서custom_admin_site.urls

   from .admin import custom_admin_site
   
   
   urlpatterns = [
       ...
       path('admin/', custom_admin_site.urls),
       # for Django 1.x versions: url(r'^admin/', include(custom_admin_site.urls)),
       ...
   ]

5. docs에templates 지정된 기본 Django 관리 템플릿 디렉터리 구조를 유지하면서 디렉터리 에서 수정할 템플릿을 만듭니다 . 예를 들어를 수정 하는 경우 파일을 만듭니다 .admin/index.htmltemplates/admin/index.html

   기존의 모든 템플릿은이 방법으로 수정할 수 있으며 이름과 구조는 Django의 소스 코드 에서 찾을 수 있습니다 .

6. 이제 템플릿을 처음부터 작성하여 재정의하거나 확장 한 다음 특정 블록을 재정의 / 확장 할 수 있습니다.

   예를 들어 모든 것을있는 그대로 유지하고 싶지만 content블록 (인덱스 페이지에 등록한 앱과 해당 모델이 나열 됨) 을 재정의 하려면 다음을 추가하십시오 templates/admin/index.html.

   {% extends 'admin/index.html' %}
   
   {% block content %}
     <h1>
       Hello, {{ world }}!
     </h1>
   {% endblock %}

   블록의 원본 내용을 유지하려면 {{ block.super }}원본 내용을 표시 할 위치에 추가하십시오 .

   {% extends 'admin/index.html' %}
   
   {% block content %}
     <h1>
       Hello, {{ world }}!
     </h1>
     {{ block.super }}
   {% endblock %}

   extrastyle및 extrahead블록 을 수정하여 사용자 스타일과 스크립트를 추가 할 수도 있습니다 .

---