{"title":"Escrevendo seu primeiro app Django, parte 7","version":"6.1","locale":"pt-br","docname":"intro/tutorial07","url":"/pt-br/6.1/intro/tutorial07/","canonical":"https://djangodocs.dev/pt-br/6.1/intro/tutorial07/","summary":"This tutorial begins where Tutorial 6 left off. We’re continuing the web-poll application and will focus on customizing Django’s automatically-generated…","html":"

Escrevendo seu primeiro app Django, parte 7Link para este cabeçalho#

\n

This tutorial begins where Tutorial 6 left off.\nWe’re continuing the web-poll application and will focus on customizing\nDjango’s automatically-generated admin site that we first explored in\nTutorial 2.

\n\n
\n

Personalize o formulário do site de administraçãoLink para este cabeçalho#

\n

Ao registrarmos o modelo de Question``através da linha ``admin.site.register(Question), o Django constrói um formulário padrão para representá-lo. Comumente, você desejará personalizar a apresentação e o funcionamento dos formulários do site de administração do Django. Para isto, você precisará informar ao Django as opções que você quer utilizar ao registrar o seu modelo.

\n

Vamos ver como isto funciona reordenando os campos no formulário de edição. Substitua a linha àdmin.site.register(Question)` por:

\n
polls/admin.py
\n
Python
from django.contrib import admin\n\nfrom .models import Question\n\n\nclass QuestionAdmin(admin.ModelAdmin):\n    fields = ["pub_date", "question_text"]\n\n\nadmin.site.register(Question, QuestionAdmin)\n
\n

Você seguirá este padrão – crie uma classe de “model admin”, em seguida, passe-a como o segundo argumento para o admin.site.register() – todas as vezes que precisar alterar as opções administrativas para um modelo.

\n

Essa mudança específica no código acima faz com que a “Publication date” apareça antes do campo “Question”:

\n\"Fields\n

Isso não é impressionante com apenas dois campos, mas para formulários com dúzias deles, escolher uma ordem intuitiva é um detalhe importante para a usabilidade.

\n

E por falar em dúzias de campos, você pode querer dividir o formulário em grupos:

\n
polls/admin.py
\n
Python
from django.contrib import admin\n\nfrom .models import Question\n\n\nclass QuestionAdmin(admin.ModelAdmin):\n    fieldsets = [\n        (None, {"fields": ["question_text"]}),\n        ("Date information", {"fields": ["pub_date"]}),\n    ]\n\n\nadmin.site.register(Question, QuestionAdmin)\n
\n

O primeiro elemento de cada tupla em fieldsets é o título do grupo. Aqui está como o nosso formulário se parece agora:

\n\"Form\n
\n\n
\n

Personalize a listagem da página de administraçãoLink para este cabeçalho#

\n

Agora que a página de administração de Pergunta está bonita, vamos fazer algumas melhorias à página “change list” – aquela que exibe todas as enquetes do sistema.

\n

Aqui é como ela está até agora:

\n\"Polls\n

By default, Django displays the str() of each object. But sometimes it’d be\nmore helpful if we could display individual fields. To do that, use the\nlist_display admin option, which is a\nlist of field names to display, as columns, on the change list page for the\nobject:

\n
polls/admin.py
\n
Python
class QuestionAdmin(admin.ModelAdmin):\n    # ...\n    list_display = ["question_text", "pub_date"]\n
\n

For good measure, let’s also include the was_published_recently() method\nfrom Tutorial 2:

\n
polls/admin.py
\n
Python
class QuestionAdmin(admin.ModelAdmin):\n    # ...\n    list_display = ["question_text", "pub_date", "was_published_recently"]\n
\n

Agora a página de edição de enquetes está assim:

\n\"Polls\n

Você pode clicar no cabeçalho da coluna para ordená-las por estes valores – exceto no caso do was_published_recently, porque a ordenação pelo resultado de um método arbitrário não é suportada. Também note que o cabeçalho da coluna\npara was_published_recently é, por padrão, o nome do método (com underscores substituídos por espaços), e que cada linha contem a representação da saída.

\n

You can improve that by using the display()\ndecorator on that method (extending the polls/models.py file that was\ncreated in Tutorial 2), as follows:

\n
polls/models.py
\n
Python
from django.contrib import admin\n\n\nclass Question(models.Model):\n    # ...\n    @admin.display(\n        boolean=True,\n        ordering="pub_date",\n        description="Published recently?",\n    )\n    def was_published_recently(self):\n        now = timezone.now()\n        return now - datetime.timedelta(days=1) <= self.pub_date <= now\n
\n

For more information on the properties configurable via the decorator, see\nlist_display.

\n

Edite o arquivo polls/admin.py de novo e adicione uma melhoria à página de lista de edição Question: Um filtro usando list_filter. Adicione a seguinte linha ao QuestionAdmin:

\n
Code
list_filter = ["pub_date"]\n
\n

Isso adiciona uma barra lateral “Filter” que permite às pessoas filtrarem a lista de edição pelo campo pub_date:

\n\"Polls\n

O tipo do filtro apresentado depende do tipo do campo pelo qual você está filtrando. Como pub_date é uma instância da classe DateTimeField, o Django consegue deduzir que os filtros apropriados são: “Qualquer data”, “Hoje”, “Últimos 7 dias”, “Esse mês”, “Esse ano”.

\n

Isso está ficando bom. Vamos adicionar capacidade de pesquisa:

\n
Code
search_fields = ["question_text"]\n
\n

Isso adiciona um campo de pesquisa ao topo da lista de edição. Quando alguém informa termos de pesquisa, o Django irá pesquisar o campo question_text. Você pode usar quantos campos quiser – entretanto, por ele usar uma consulta LIKE internamente, limitar o número de campos de pesquisa a um número razoável, será mais fácil para o seu banco de dados para fazer pesquisas.

\n

Now’s also a good time to note that change lists give you free pagination. The\ndefault is to display 100 items per page.

\n\n
\n
\n

Personalize a aparência do site de administraçãoLink para este cabeçalho#

\n

Obviamente, ter “Django administration” no topo de cada página de administração é ridículo. Isso é só um texto de exemplo.

\n

You can change it, though, using Django’s template system. The Django admin is\npowered by Django itself, and its interfaces use Django’s own template system.

\n
\n

Personalize os templates do seu projetoLink para este cabeçalho#

\n

Create a templates directory in your djangotutorial directory.\nTemplates can live anywhere on your filesystem that Django can access. (Django\nruns as whatever user your server runs.) However, keeping your templates within\nthe project is a good convention to follow.

\n

Abra seu arquivo de configurações (mysite/settings.py, lembre-se) e adicione uma opção DIRS. na configuração TEMPLATES setting:

\n
mysite/settings.py
\n
Python
TEMPLATES = [\n    {\n        "BACKEND": "django.template.backends.django.DjangoTemplates",\n        "DIRS": [BASE_DIR / "templates"],\n        "APP_DIRS": True,\n        "OPTIONS": {\n            "context_processors": [\n                "django.template.context_processors.request",\n                "django.contrib.auth.context_processors.auth",\n                "django.contrib.messages.context_processors.messages",\n            ],\n        },\n    },\n]\n
\n

DIRS é uma lista de diretórios de arquivos que serão checados quando o Django carregar seus templates, ou seja, caminhos de busca.

\n\n

Now create a directory called admin inside templates, and copy the\ntemplate admin/base_site.html from within the default Django admin\ntemplate directory in the source code of Django itself\n(django/contrib/admin/templates) into that directory.

\n\n

Então, edite o arquivo e substitua {{ site_header|default:_('Django administration') }} (incluindo as chaves) com nome do seu próprio site como desejar. Você deve acabar com uma secção de código como:

\n
Django template
{% block branding %}\n<div id="site-name"><a href="{% url 'admin:index' %}">Polls Administration</a></div>\n{% if user.is_anonymous %}\n  {% include "admin/color_theme_toggle.html" %}\n{% endif %}\n{% endblock %}\n
\n

Nós usamos esta abordagem para ensinar-lhe como substituir templates. Em um projeto real, você provavelmente usaria o atributo django.contrib.admin.AdminSite.site_header para fazer mais facilmente essa personalização em particular.

\n

Esse template contém uma série de textos como {% block branding %} e {{ tittle }}. As tags {% e {{ fazem pate da linguagem de templates do Django. Quando o Django renderiza o template “admin/base_site.html”, o seu conteúdo é processado por essa linguagem de templates para produzir a página HTML final, assim como vimos no Tutorial 3.

\n

Note que qualquer template padrão do site de administração pode ser sobrescrito. Para sobrescrever um template, apenas faça a mesma coisa que você fez com base_site.html – copie ele do diretório padrão para o seu próprio diretório, e faça as mudanças.

\n
\n
\n

Personalize os templates da sua aplicaçãoLink para este cabeçalho#

\n

Leitores astutos irão se perguntar: Mas se DIRS estava vazio por padrão, como o Django pôde encontrar o diretório padrão dos templates do site de administração? A resposta é, Desde que APP_DIRS seja True, o Django irá automaticamente procurar por um subdiretório templates/ dentro de cada pacote de aplicação, para usar como fallback(Não esqueça que django.contrib.admin é uma aplicação)

\n

Nossa aplicação de enquetes não é muito complexa e não precisa de templates personalizados para o site de administração. Mas se ele crescer e ficar mais sofisticado e necessária a modificação dos templates padrão de administração do Django para algumas de suas funcionalidades, seria mais sensato modificar os templates da aplicação, e não os do projeto. Dessa forma, você poderia incluir a aplicação de enquete em qualquer novo projeto e ter a certeza que iria encontrar os templates personalizados que você precisa.

\n

Veja a documentação de carga de template - para mais informação sobre como o Django acha seus templates.

\n
\n
\n
\n

Personalize a página inicial do site de administraçãoLink para este cabeçalho#

\n

De maneira similar, você pode querer personalizar a aparência da página inicial do site de administração do Django.

\n

Por padrão, ele exibe todas as aplicações em INSTALLED_APPS, que estão registrados na aplicação de administração, em ordem alfabética. E você pode querer fazer alterações significativas no layout. Além do que, a página inicial é provavelmente a página mais importante da página de administração, e deve ser fácil de usar.

\n

The template to customize is admin/index.html. (Do the same as with\nadmin/base_site.html in the previous section – copy it from the default\ndirectory to your custom template directory). Edit the file, and you’ll see it\nuses a template variable called app_list. That variable contains every\ninstalled Django app. Instead of using that, you can hardcode links to\nobject-specific admin pages in whatever way you think is best.

\n

When you’re comfortable with the admin, read part 8 of this\ntutorial to learn how to use third-party packages.

\n
","rootId":"writing-your-first-django-app-part-7","toc":[{"title":"Personalize o formulário do site de administração","anchor":"customize-the-admin-form","children":[]},{"title":"Adicionando objetos relacionados","anchor":"adding-related-objects","children":[]},{"title":"Personalize a listagem da página de administração","anchor":"customize-the-admin-change-list","children":[]},{"title":"Personalize a aparência do site de administração","anchor":"customize-the-admin-look-and-feel","children":[{"title":"Personalize os templates do seu projeto","anchor":"customizing-your-project-s-templates","children":[]},{"title":"Personalize os templates da sua aplicação","anchor":"customizing-your-application-s-templates","children":[]}]},{"title":"Personalize a página inicial do site de administração","anchor":"customize-the-admin-index-page","children":[]}],"breadcrumbs":[{"docname":"intro/index","title":"Introdução","url":"/pt-br/6.1/intro/"}],"prev":{"docname":"intro/tutorial06","title":"Escrevendo sua primeira aplicação Django, parte 6","url":"/pt-br/6.1/intro/tutorial06/"},"next":{"docname":"intro/tutorial08","title":"Escrevendo seu primeiro app Django, parte 8","url":"/pt-br/6.1/intro/tutorial08/"},"formats":{"html":"/pt-br/6.1/intro/tutorial07/","markdown":"/pt-br/6.1/intro/tutorial07.md","json":"/pt-br/6.1/intro/tutorial07.json"},"source":"https://github.com/django/django/blob/stable/6.1.x/docs/intro/tutorial07.txt","official":"https://docs.djangoproject.com/pt-br/6.1/intro/tutorial07/","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","1.10","1.9"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}