Django: redefiniendo Y ampliando una plantilla de aplicación

Question

Si desea anular una plantilla que viene con una aplicación en django (en app/templates/app /), cree una plantilla del mismo nombre en otro directorio, que el cargador de plantillas verifica antes de la plantilla de la plantilla dir. Si solo desea sobrescribir ciertos bloques de la plantilla, también debe copiar toda la plantilla y cambiar el anuncio de ese bloque, que en realidad no es muy SECO.

¿Alguien sabe una manera de anular la plantilla orginial, mientras que al mismo tiempo la extiende, por lo que solo tiene que anular el bloque específico que desea cambiar? (Lo está haciendo esto sin cambiar el nombre de la plantilla, ya que en algunos casos puede que tenga que cambiar la vista para que funcione con otra plantilla)

EDIT: Como Adam Taylor señaló en los comentarios de Django 1.9 on este es posible sin ningún hackeo.

Answer 1

Creo que la respuesta de this related question es pertinente; actualmente, la mejor solución parece ser utilizar un cargador de plantillas personalizado desde el django-apptemplates package on PyPI, por lo que puede usar pip para instalarlo (por ejemplo, pip install django-apptemplates).

El cargador de plantillas le permite extender una plantilla en una aplicación específica; por ejemplo, para extender la página de índice de la inteface de administración, deberá añadir

'apptemplates.Loader', 

a su lista de TEMPLATE_LOADERSsettings.py, y utilizar

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

en sus plantillas.

Answer 2

[Actualización]

He leído mal la pregunta, mi respuesta original se aplica sólo a la aplicación de administración, que tiene un mecanismo de extensión del molde incorporado. Para otra aplicación que carece de dicho mecanismo, simplemente me gustaría mover las plantillas originales en lugar de jugar con cargadoras de plantillas personalizadas, como aconseja la respuesta elegida. Si le preocupa el bifurcación, también puede implementar un mecanismo de extensión y contribuir al proyecto original si cree que vale la pena.

---

[respuesta original]

Directamente de la multa manual: Debido al diseño modular de las plantillas de administración, por lo general es necesario ni aconsejable sustituir una plantilla entera. Casi siempre es mejor anular solo la sección de la plantilla que debe cambiar.

Para continuar con el ejemplo anterior, queremos agregar un nuevo enlace al lado de la herramienta Historial para el modelo de página. Después de mirar change_form.html, determinamos que solo tenemos que anular el bloque de herramientas de objeto. Por lo tanto aquí está nuestro nuevo change_form.html:

{% extends "admin/change_form.html" %} 
{% load i18n %} 
{% block object-tools %} 
{% if change %}{% if not is_popup %} 
    <ul class="object-tools"> 
    <li><a href="history/" class="historylink">{% trans "History" %}</a></li> 
    <li><a href="mylink/" class="historylink">My Link</a></li> 
    {% if has_absolute_url %} 
     <li><a href="../../../r/{{ content_type_id }}/{{ object_id }}/" class="viewsitelink"> 
      {% trans "View on site" %}</a> 
     </li> 
    {% endif%} 
    </ul> 
{% endif %}{% endif %} 
{% endblock %} 

Y eso es todo! Si colocamos este archivo en el directorio templates/admin/my_app, nuestro enlace aparecerá en el formulario de cambios de cada modelo.

Answer 3

En la wiki de Django, Simon Willison presenta a trick para lograr el efecto de "plantilla autoextendida". Sin embargo, no es directamente aplicable si está usando el cargador de plantillas app_directories.

Hacer un enlace simbólico de directorios de plantillas de aplicaciones dentro de un nuevo directorio podría ser un truco.

Answer 4

Una forma sencilla de hacerlo es la siguiente:

Digamos que desea ampliar y anular django/contrib/admin/templates/admin/change_form.html.

Primero, copie el change_form.html original en el directorio de plantillas de su aplicación y renómbrelo como algo como myapp/templates/admin/original_change_form.html. (También podría hacer esto como un enlace simbólico).

En segundo lugar, cree su propio change_form.html en myapp/templates/admin. En la parte superior, coloque lo siguiente:

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

¡Simple!

Answer 5

Como una actualización ya que esta parece ser una pregunta popular. He usado el overextends app sin ningún problema. Proporciona una nueva palabra clave sobreextensiones que permite extender plantillas con el mismo nombre.

Y es fácil de instalar con pip:

pip install -U django-overextends 

Answer 6

Django 1.9 y posteriores tiene this feature:

Django cargadores de plantillas pueden ahora ampliar las plantillas de forma recursiva.

lo que puede tener un archivo de app1 con contenidos como esto:

app1/templates/example/foobar.html:

<p>I'm from app1</p> 
{% block main %}{% endblock %} 

y se puede extender con un archivo de app2 (notar que el nombre de la plantilla example/foobar.html es lo mismo):

app2/templates/example/foobar.html:

{% extends "example/foobar.html" %} 
{% block main %} 
    <p>I'm from app2</p> 
{% endblock %} 

El resultado final debe ser:

<p>I'm from app1</p> 
<p>I'm from app2</p>