Cachina’s Programming Blog


Explorando o Admin do Django – Parte I

Posted in Sem-categoria por Mayron Cachina em abril 11, 2008
Tags: , , ,

Esse tutorial vai sair na próxima PZPZine😀
Estou adiantando para vocês…

O Admin é um plugin do Django onde você pode administrar o seu sistema por inteiro, ela é muito interessante para ser usada, principalmente por que já gerar CRUDs customizáveis, que esse tutorial vai abordar o básico.
Uma nota muito importante está em desenvolvimento uma nova classe Admin o NewForms Admin[1] que se propõe a deixá-lo mais customizável, pois o Admin atual você não pode mexer muito nele(adicionar links e etc), na página do amigo Marinho[2] existe um tutorial de instalação bem explicado…

1 – Começando

Devemos criar primeiramente um novo projeto:

django-admin.py startproject Exemplo

Será criado a seguinte estrutura de arquivos:

  • __Init__.py – Arquivo de configuração onde o python reconhece como pacote esta pasta.

  • menage.py – Script para tarefas administrativas do seu projeto.

  • settings.py – Configuração do projeto

  • urls.py – Configuração de url do projeto.

2 – Configuração do Projeto

Dentro do arquivo settings.py está presente algumas configurações sobre a aplicação e de extrema importância, certifique-se de ter configurado modificando para a seguinte forma:

DATABASE_ENGINE = 'mysql'

DATABASE_NAME = 'django'

DATABASE_USER = 'root'

DATABASE_PASSWORD = ''

DATABASE_HOST = 'localhost'

DATABASE_PORT = ''

....

LANGUAGE_CODE = 'pt_br'

....

INSTALLED_APPS = (

'django.contrib.auth',

'django.contrib.contenttypes',

'django.contrib.sessions',

'django.contrib.sites',

'django.contrib.admin',

'exemplo.funcionario'

)

Obs: Você pode usar outros bancos de dados como o postgres ou sqlite.

Obs2: Esse artigo não tem como finalidade explicar a configuração do settings.py, para mais informações consulte a documentação[3].

3 – Criando novo Aplicativo

python manager.py startapp funcionario

Será criada a seguinte estrutura:

  • __init__.py Arquivo que indica ao Python que esse diretório vai ser considerado um pacote.

  • models.py Arquivo onde você define seus modelos.

  • views.py Arquivo onde você define as views do seu projeto.

4- Criando o modelo de do nosso banco de dados

Essa modelagem é a que vamos seguir para criar o modelo.

Esse é um simples exemplo onde um funcionário fará parte de um grupo, uma modelagem simples.

Agora iremos editar o arquivo models.py:

class Grupo(models.Model):
descricao = models.CharField(max_length=80)
salario   = models.DecimalField(max_digits=5, decimal_places=2)

class Admin:
pass

def __unicode__(self):
return self.nome

class Funcionario(models.Model):
nome = models.CharField(max_length=80)
grupo  = models.ForeignKey(Grupo)
telefone   = models.CharField(max_length=9)

class Admin:
pass

def __unicode__(self):
return self.nome

Obs: É
recomendado está usando a versão 0.97 (saiba mais como
instalar aqui[5]), caso deseje utilizar a versão 0.96 adapte o
código de acordo com a documentação[4]. NÃO ESQUECER A IDENTAÇÃO!!! CÓDIGO COMPLETO AQUI: http://mayroncachina.googlepages.com/djangoi

5 – Sincronizando base de dados

Antes de tudo você
deve criar a sua base de dados, como informado no arquivo
settings.py, no nosso caso foi usando o mysql:

mysql -uroot

mysql> create
database django;

mysql>exit

Agora vamos criar as
tabelas com o comando:

python manager.py syncdb

será criada as
tabelas e será pedido um usuário ADMINISTRADOR, para
seu acesso ao admin.

You just installed
Django’s auth system, which means you don’t have any

superusers defined.

Would you like to
create one now? (yes/no): yes

Username (Leave
blank to use ‘mayron’): admin

E-mail address:
mayroncachina@gmail.com

Password:

Password (again):

6 – Configurado a URL para acesso

Para testar precisamos
alterar mais um arquivo, o urls.py e alterar a linha:

# (r’^admin/’,
include(‘django.contrib.admin.urls’)),

para

(r’^admin/’,
include(‘django.contrib.admin.urls’)),

7 – Startando o Servidor

Agora podemos rodar o
servidor para ver o funcionando:

python manage.py runserver

agora acesse do seu navegador:

http://localhost:8000/admin/

vai aparecer a tela de login:

Ao realizar o login você terá uma interface para administração de seus Grupos e Funcionários.

Utilize o usuário e senha criados na hora da sincronização do banco.

No próximo tutorial vamos aprender a customizar o Admin e algumas outras explicações sobre a classe Model.

8 – Referências:

[1] http://code.djangoproject.com/wiki/NewformsAdminBranch

[2] http://marinho.webdoisonline.com/blog/p/143/

[3] http://www.djangoproject.com/documentation/settings/
[4] http://www.djangoproject.com/documentation/0.96/model-api/
[5] http://www.djangoproject.com/documentation/install/#installing-the-development-version

2 Respostas to 'Explorando o Admin do Django – Parte I'

Subscribe to comments with RSS ou TrackBack to 'Explorando o Admin do Django – Parte I'.

  1. Leandro said,

    Muiiito Bom.
    Excelente Mayron.
    Parabéns pelo artigo.


  2. Excelente artigo, Mayron!

    E parabéns por estar envolvido com a pzpzine, projeto super bacana.

    Só uma dicazinha… põe os links no texto mesmo, quando postar aqui no blog. Fica mais prático que ficar vendo os [n] e as referências.

    Vlw!

    E continue contribuindo com o comunidade django!


Deixe uma resposta

Preencha os seus dados abaixo ou clique em um ícone para log in:

Logotipo do WordPress.com

Você está comentando utilizando sua conta WordPress.com. Sair / Alterar )

Imagem do Twitter

Você está comentando utilizando sua conta Twitter. Sair / Alterar )

Foto do Facebook

Você está comentando utilizando sua conta Facebook. Sair / Alterar )

Foto do Google+

Você está comentando utilizando sua conta Google+. Sair / Alterar )

Conectando a %s


%d blogueiros gostam disto: