| Version 2 (modified by , 16 years ago) ( diff ) |
|---|
Admin Básico
Para exibir uma classe de modelo no Admin (aplicação de administração do site), você deve seguir os seguintes passos:
- 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 a seguinte linha à setting INSTALLED_APPS::
'django.contrib.admin',
- Edite agora 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.
- 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
- Importe em seguida a(s) classe(s) desejada(s) para ser reconhecida no admin,
como abaixo::
from models import Produto, Categoria
- Por fim, é preciso registrar a classe de modelo ao site do Admin::
admin.site.register(Produto) admin.site.register(Categoria)
- 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.
- Agora, 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)
- 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