{"title":"How to override templates","version":"5.0","locale":"pt-br","docname":"howto/overriding-templates","url":"/pt-br/5.0/howto/overriding-templates/","canonical":"https://djangodocs.dev/pt-br/5.0/howto/overriding-templates/","summary":"No seu projeto, você pode querer sobrescrever um template em outra aplicação Django, seja ela uma aplicação de terceiros ou uma aplicação contrib, como…","html":"

How to override templatesLink para este cabeçalho#

\n

No seu projeto, você pode querer sobrescrever um template em outra aplicação Django, seja ela uma aplicação de terceiros ou uma aplicação contrib, como django.contrib.admin Você pode colocar os templates sobrescritos no seu diretório de templates ou em um diretório de templates de aplicação.

\n

Se você tem diretórios de templates de projeto e aplicação em que ambos contenham sobrescritas, o carregador de templates padrão do Django tentará carregar o template a partir do diretório de nível de projeto primeiro. Em outras palavras, :settings:`DIRS <TEMPLATES-DIRS>` é procurado antes de :settings:`APP_DIRS <TEMPLATES-APP_DIRS>`.

\n\n
\n

Sobrescrevendo do diretório de templates do projeto.Link para este cabeçalho#

\n

Primeiro, iremos explorar a sobrescrita de templates criando templates de substituição no seu diretório de templates do projeto.

\n

Vamos dizer que você esteja tentado sobrescrever os templates de uma aplicação de terceiros chamada blog, que provê os templates blog/post.html e blog/list.html. As configurações relevantes do seu projeto irão parecer com:

\n
Code
from pathlib import Path\n\nBASE_DIR = Path(__file__).resolve().parent.parent\n\nINSTALLED_APPS = [\n    ...,\n    "blog",\n    ...,\n]\n\nTEMPLATES = [\n    {\n        "BACKEND": "django.template.backends.django.DjangoTemplates",\n        "DIRS": [BASE_DIR / "templates"],\n        "APP_DIRS": True,\n        # ...\n    },\n]\n
\n

A configuração TEMPLATES e BASE_DIR irá existir se você tiver criado o seu projeto usando o template padrão de projeto. A configuração que precisa ser modificada é DIRS.

\n

Essas configurações assumem que você tenha um diretório templates na raiz do seu projeto. Para sobrescrever os templates para a aplicação blog, crie um diretório no diretório templates, e adicione os arquivos de template nessa pasta recém criada.

\n
None
templates/\n    blog/\n        list.html\n        post.html\n
\n

O carregador de template primeiro procura por templates no diretório DIRS. Quando as views na aplicação blog pedirem pelos templates blog/post.html```e ``blog/list.html, o carregador irá retornar os arquivos que você acabou de criar.

\n
\n
\n

Sobrescrevendo de um diretório de template de aplicação.Link para este cabeçalho#

\n

Já que você está sobrescrevendo templates localizados fora de uma de suas aplicações do projeto, é mais comum usar o primeiro método e adicionar templates que sobrescrevem na pasta de templates do projeto. Se você preferir, entretanto, é possível colocar as sobrescritas em um diretório de templates da aplicação.

\n

Primeiro, tenha certeza que as suas configurações de template estão verificando dentro dos diretórios de aplicação:

\n
Code
TEMPLATES = [\n    {\n        # ...\n        "APP_DIRS": True,\n        # ...\n    },\n]\n
\n

Se você quer colocar as sobrescritas de templates em uma aplicação chamada myapp e os templates a serem sobrescritos são chamados blog/list.html e blog/post.html, então sua estrutura de diretório será parecida com isso:

\n
None
myapp/\n    templates/\n        blog/\n            list.html\n            post.html\n
\n

Com a configuração APP_DIRS definida como True, o carregador de templates irá procurar no diretório de templates de aplicação e encontrar os templates.

\n
\n
\n

Extending an overridden templateLink para este cabeçalho#

\n

With your template loaders configured, you can extend a template using the\n{% extends %} template tag whilst at the same time overriding\nit. This can allow you to make small customizations without needing to\nreimplement the entire template.

\n

For example, you can use this technique to add a custom logo to the\nadmin/base_site.html template:

\n
\n
templates/admin/base_site.html
\n
Django template
 {% extends "admin/base_site.html" %}\n\n {% block branding %}\n     <img src="link/to/logo.png" alt="logo">\n     {{ block.super }}\n {% endblock %}\n
\n
\n

Key points to note:

\n\n

This technique works because the template loader does not consider the already\nloaded override template (at templates/admin/base_site.html) when\nresolving the extends tag. Combined with block.super it is a powerful\ntechnique to make small customizations.

\n
","rootId":"how-to-override-templates","toc":[{"title":"Sobrescrevendo do diretório de templates do projeto.","anchor":"overriding-from-the-project-s-templates-directory","children":[]},{"title":"Sobrescrevendo de um diretório de template de aplicação.","anchor":"overriding-from-an-app-s-template-directory","children":[]},{"title":"Extending an overridden template","anchor":"extending-an-overridden-template","children":[]}],"breadcrumbs":[{"docname":"howto/index","title":"Guias de “como fazer”","url":"/pt-br/5.0/howto/"}],"prev":{"docname":"howto/outputting-pdf","title":"How to create PDF files","url":"/pt-br/5.0/howto/outputting-pdf/"},"next":{"docname":"howto/static-files/index","title":"How to manage static files (e.g. images, JavaScript, CSS)","url":"/pt-br/5.0/howto/static-files/"},"formats":{"html":"/pt-br/5.0/howto/overriding-templates/","markdown":"/pt-br/5.0/howto/overriding-templates.md","json":"/pt-br/5.0/howto/overriding-templates.json"},"source":"https://github.com/django/django/blob/stable/5.0.x/docs/howto/overriding-templates.txt","official":"https://docs.djangoproject.com/pt-br/5.0/howto/overriding-templates/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}