Django é um framework para desenvolvimento rápido para web escrito em Python que utiliza o padrão MTV (Model, Template e View). Criado originalmente para gerenciar um site jornalístico, tornou-se um projeto de código aberto e foi publicado sob a licença BSD em 2005. Seu nome é inspirado no músico de jazz Django Reinhart.

Como o django é escrito em Python, que está sobre a licença Python Software Foundation License, que é similar a GPL, com exceção de que se podem distribuir os binários da linguagem sem necessitar anexar os fontes.

Quem trabalha com a dupla python e django sabe os incríveis recursos do framework. Os que mais se destacam são:

  • Mapeador objeto relacional;
  • URL’s elegantes;
  • Sistema de templates;
  • Interface de administração automática (django-admin)

Este artigo apresentará alguns recursos básicos para quem estão começando a usar o django-admin ou que está começando com o framework.

1. Alterar ordenação da listagem no admin

Quando uma aplicação é registrada no djando-admin a listagem dos dados é feita pelo ID do registro e frequentemente acontece que essa não é ordenação que interessa para quem está usando o sistema. Então em casos como esses existem duas opções para mudar a maneira com que essa ordenação é feita:

Opção 01

No arquivo models.py da sua app é possível definir uma ordenação padrão, conforme a Listagem 1.

Listagem 1. Ordenação no model

  class MyModel(models.Model):
     nome = models.CharField(max_length=75)
     class Meta:
         ordering = [‘nome’]
  

Dessa maneira, todas as listagens feitas nesse objeto, sem definir uma ordenação, serão ordenadas pelo campo nome. Geralmente definir uma ordenação padrão para tudo não é a melhor coisa a ser feita.

Opção 02

Existe também a opção de definirmos uma ordenação a ser usada apenas pelo django-admin no arquivo admin.py da sua app. Essa opção não é de uso geral e vai funcionar apenas dentro do django-admin.

Dentro do arquivo admin.py da sua app digite o código da Listagem 2.

Listagem 2. Ordenação exclusiva para o admin

  class MyModelAdmin(admin.ModelAdmin):
     def queryset(self, request):
         qs = super(MyModelAdmin, self).queryset(request)
         return qs.order_by(''nome'')
  

2. Alterando as colunas mostradas na listagem

No django-admin é possível personalizar as colunas que aparecem nas listagens que ele monta para o seu model. Confira um exemplo na Figura 1.

Figura 1. Listagem padrão do django admin

Vejam que apenas o campo nome aparece na tabela e as vezes, por exemplo, o e-mail poderia ser um dado interessante, como visto na Figura 2.

Figura 2. Listagem com o campo email adicionado

Então a maneira correta de personalizar as colunas que aparecem no seu painel aparece na Listagem 3. Digite o código dentro do arquivo admin.py da sua aplicação.

Listagem 3. Personalizando as colunas que aparecem na listagem do django-admin

  class MyModelAdmin(admin.ModelAdmin):
     list_display = (‘nome’'', ''email'')
  

Onde nome e email são campos que você deseja ver na listagem e estão no seu model.

3. Definindo um formulário alternativo para ser exibido

Digamos que você deseja validar um campo do tipo telefone no formato brasileiro utilizando o django-localflavor. Nesse caso, segundo a documentação do django-localflavor é necessário substituir o widget padrão desse campo. Para fazer isso basta definir um form a ser usado no django-admin.

No arquivo forms.py da sua aplicação digite o código do formulário, conforme a Listagem 4.

Listagem 4. Definindo um formulário para ser usado no django-admin

  from localflavor.br.forms import BRPhoneNumberField
  class MyModelFormAdmin(forms.ModelForm):
     fone = BRPhoneNumberField(required=False, label=''Telefone'')
     celular = BRPhoneNumberField(required=False, label=''Celular'')
     class Meta:
         model = MyModel
  

Agora no seu admin.py basta apenas substituir o form padrão, conforme a Listagem 5.

Listagem 5. Sobre-escrevendo o formulário usado por padrão

  class ModelAdmin(admin.ModelAdmin):
     form = MyModelFormAdmin
  

Feito isso, o django-localflavor agora passa a validar esses dois campos no formato XX-XXXX-XXXX.

NOTA: Lembre-se que para esse exemplo funcionar é preciso estar com o django-localflavor instalado e declarado no settings.py como uma INSTALLED_APPS.

O guia de instalação detalhado encontra-se na documentação oficial da app.

4. Definindo campos de apenas leitura

Nos casos onde o usuário não pode alterar um campo no admin do django é possível definir esse campo como apenas leitura, não permitindo ao usuário alterar o valor do mesmo.

No arquivo admin.py da sua app insira o código conforme a Listagem 6.

Listagem 6. Definindo um campo como apenas leitura

  class MyModelAdmin(admin.ModelAdmin):
     readonly_fields = (''field’,)
  

5. Alterando o widget padrão para as relações ManyToManyField

O django admin, por padrão, monta a estrutura da Figura 3 para as relações ManyToManyField.

Figura 3. Campo padrão para relacionamentos ManyToManyField

Quando existem muitas opções a serem escolhidas, o melhor seria ter um campo de busca no widget. Sendo assim, o melhor é ajustar o comportamento mostrado na figura acima para o que está presente na Figura 4.

Figura 4. Alterado o widget padrão para campos ManyToManyField

Para fazer essa alteração, basta adicionar no seu admin.py o código da Listagem 6.

Listagem 6. Alterando o padrão de campos ManyToMany no admin do django.

  class EmployeeAdmin(admin.ModelAdmin):
     filter_horizontal = (''field'',)
  

Onde field é o nome que recebe a relação.

6. Definindo filtros nas listagem do django-admin

Nas listagens que o django-admin cria, ainda é possível definir um, ou vários filtros a serem usados na listagem. Esse recurso permite a visualização apenas do que interessa na listagem ou um subconjunto de dados mais relevante. Veja o exemplo da Listagem 7.

Listagem 7. Visualizando dados interessantes

  class MyModelAdmin(admin.ModelAdmin):
     list_filter = [‘field_01’, ‘field_02’]
  

O interessante aqui é que basta apenas isso para o django montar o filtro em cima do campo definido. Ele pega o tipo de dado definido no model e automaticamente ajusta o tipo de filtro a ser usado. Um exemplo pode ser visto na Figura 5.

Figura 5. Exemplo de filtro retirado da documentação oficial do django

7. Utilize o django-grappelli

Essa funcionalidade externa não pertence exatamente ao django-admin, mas se você quiser deixar o seu sistema com uma interface um pouco mais bonita é interessante instalar no seu projeto o django-grappelli. Ele vai ficar da mesma forma apresentada na Figura 6.

Figura 6. Exemplo rodando o django-grappelli como interface para o admin no django

As instruções para instalação encontram-se na sua página oficial.

E se gostar do projeto e quiser contribuir, você encontra no repositório do github o projeto.

Existem diversos recursos que não foram citados nesse artigo e para maiores informações é recomendo a documentação do django que possui todos os recursos bem explicados. Outro lugar interessante para encontrar informações é o tutorial oficial do django que está presente no site oficial.

Links:

Site oficial Python Brasil: www.python.org.br/wiki

Site oficial do Django: www.djangoproject.com

Documentação Oficial django: docs.djangoproject.com/en/1.6

Documentação do Django-localflavor: http://django-localflavor.readthedocs.org/en/latest/#installation

Site oficial do grappelli: http://grappelliproject.com/

Documentação oficial do grappelli: http://django-grappelli.readthedocs.org/en/latest/

Projeto grappelli: https://github.com/sehmaschine/django-grappelli