How to Extend and Override Django Admin Templates Without Replacing Them?

Extending and Overriding Django Admin Templates with Overriding Template Loader

The challenge of extending and overriding Django admin templates without replacing them has been a common concern among developers. Despite previous discussions on this topic, the issue remains prevalent for projects using the app_directories template loader.

One workaround involves duplicating admin templates and extending from the copies, but this adds complexity and maintenance overhead. To simplify this process, a custom template loader has been developed that enables developers to extend any template within a specific app.

Implementing the Overriding Template Loader

To extend an admin template, for instance, admin/index.html, developers can create their own template with the same name in their app's templates directory, and include the following line at the start of the template:

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

Within this extended template, developers can define blocks to override specific portions of the base template. For example, to add extra links to the sidebar, they can create the following block:

{% block sidebar %}
    {{block.super}}
    <div>
        <h1>Extra links</h1>
        <a href="/admin/extra/">My extra link</a>
    </div>
{% endblock %}

Addressing the Issue in Django

As of the latest and previous LTS versions of Django (3.2, 2.2, 1.11), the overriding and extension of admin templates using the app_directories template loader remains a documented issue. However, there is no indication of whether this will be addressed in future versions of Django.

The above is the detailed content of How to Extend and Override Django Admin Templates Without Replacing Them?. For more information, please follow other related articles on the PHP Chinese website!