Changes between Initial Version and Version 1 of AdminBasico

Timestamp:

Sep 22, 2008, 11:16:46 AM (17 years ago)

Author:

Marinho Brandão

Comment:

--

AdminBasico

@@ +1 @@
+= 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 a seguinte linha à setting INSTALLED_APPS::
+
+    'django.contrib.admin',
+
+2. 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.
+
+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 ser reconhecida no admin,
+como abaixo::
+
+    from models import Produto, Categoria
+
+5. Por fim, é preciso registrar a classe de modelo ao 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. 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)
+
+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