= Admin Básico =

Para exibir uma classe de modelo no Admin (aplicação de administração do site),
você deve seguir os seguintes passos:

1. Supondo que sua aplicação se chama "minha_app" que contenha as classes
"Produto" e "Categoria", edite o arquivo "settings.py" de seu projeto e
acrescente as seguintes linhas à setting INSTALLED_APPS:

{{{
'django.contrib.admin',
'django.contrib.admindocs',
}}}

2. Agora edite o arquivo "urls.py" e remova os comentários (#) das seguintes
linhas:

{{{
from django.contrib import admin
admin.autodiscover()
}}}

isso irá fazer com que o Django procure por arquivos "admin.py" em todas as
aplicações de seu projeto automaticamente.

Remova os comentários também destas linhas:

{{{
(r'^admin/doc/', include('django.contrib.admindocs.urls')),
(r'^admin/(.*)', admin.site.root),
}}}

isso fará com que seu projeto tenha URLs para o sistema de documentação do
admin e do próprio admin, respectivamente.

3. Agora crie um arquivo "admin.py" na pasta de sua aplicação e importe o
módulo do Admin da seguinte maneira:

{{{
from django.contrib import admin
}}}

4. Importe em seguida a(s) classe(s) desejada(s) para acrescentar ao admin, como abaixo:

{{{
from models import Produto, Categoria
}}}

5. Por fim, é preciso registrar a classe de modelo no site do Admin:

{{{
admin.site.register(Produto)
admin.site.register(Categoria)
}}}

6. Pronto! Agora rode o "manage.py runserver" e carregue o seu projeto nas URLs
"/admin/doc/ e "/admin/" para notar que haverá uma seção com o nome de sua
aplicação contendo ali links para administração das classes registradas.

7. Para modificar as colunas exibidas para a classe "Produto", vamos
supor que essa classe possui os campos "descricao", "referencia" e "categoria".
Portanto edite novamente o arquivo "admin.py" e adicione as seguintes linhas:

{{{
from django.contrib.admin.options import ModelAdmin

class AdminProduto(ModelAdmin):
    list_display = ('descricao', 'referencia', 'categoria')
}}}

e modifique a linha de registro da classe:

{{{
admin.site.register(Produto, AdminProduto)
}}}

8. Basta salvar e rodar o site para carregar a página de listagem de produtos
para verificar que agora as colunas informadas no código serão exibidas na
ordem especificada.

----
Tire outras dúvidas em nosso [wiki:CookBookPortugues CookBook em Português]