Django Admin

Criando uma aplicação administrativa com Django Admin

O Django possui um recurso incrível e extremamente rápido para a criação de painéis administrativos. Sendo assim, neste artigo, veremos como criá-los e configurá-los.

Clonando a aplicação

Como exemplo, iremos utilizar a aplicação feita no curso “Django – Fundamentos” aqui da TreinaWeb.

Para realizar o clone do projeto, vamos até o CMD (se você usa o Windows) ou Terminal (caso você use o macOS ou Linux) e utilizamos o seguinte comando:

git clone https://github.com/treinaweb/treinaweb-django-fundamentos.git

Feito isso, o projeto será baixado em seu computador e você terá todo o seu código-fonte.

Configurando aplicação

Após baixar o repositório do GitHub e abrir a aplicação no PyCharm, precisamos criar sua virtualenv. Para isso, vamos até File > Settings (se você usa o Windows ou Linux) ou PyCharm > Preferences (se você usa o macOS).

Ao abrir a janela de configurações, vamos até a aba “Project Interpreter” e selecionamos a opção de criar uma nova virtualenv para o projeto:

Feito isso, uma nova janela será aberta e podemos selecionar a opção “New environment” e clicar em “OK”.

Após isso, uma nova virtualenv será criada dentro da pasta do projeto que clonamos do GitHub:

Precisamos agora, instalar o Django e o mysqlclient (pacotes que serão necesários para a aplicação).

Clicamos no botão “+” no canto inferior esquerdo da janela, para que uma nova janela seja aberta.

É lá que buscamos os pacotes que queremos baixar e instalar na virtualenv:

Depois de instalar os dois pacotes acima, a aba “Project Interpreter” terá o seguinte resultado:

Com isso, estamos prontos para ativar o módulo administrativo do Django. =)

Ativando o Django Admin

Para ativar o Django Admin em uma aplicação é bem simples.

A única coisa que precisamos fazer é ir até o arquivo admin.pyda aplicação e determinar quais models queremos que o Django gerencie. Como nosso projeto possui apenas o model Cliente, vamos ativá-lo.

Sendo assim, no arquivo admin.pyda nossa aplicação clientes, inserimos o seguinte bloco de código:

from django.contrib import admin
from .models import *

# Register your models here.

admin.site.register(Cliente)

Isso fará com que o módulo administrativo do Django gerencie o model Cliente e, assim, permitir que façamos qualquer alteração na tabela clientes.

Criando super-usuário

Após ativar o Django Admin, precisamos criar um usuário que possua permissão para acessá-lo. Para isso, vamos até o terminal do PyCharm e digitamos o seguinte comando:

python manage.py createsuperuser

Você deverá informar o nome de usuário, email e senha do usuário que estamos criando.

Feito isso, o super-usuário será criado com sucesso.

Testando a aplicação

Agora que estamos com tudo configurado, podemos executar o servidor de desenvolvimento do Django e verificar se tudo está funcionando normalmente. Utilizaremos o seguinte comando:

python manage.py runserver

Sendo assim, o servidor será executado e poderemos acessar a aplicação através do seguinte link: 127.0.0.1:8000/admin. Ao acessar a rota, seremos redirecionados para a tela de login do Django Admin. É lá que digitamos o nome de usuário e senha criados anteriormente:

Feito isso, ao clicar em “Acessar”, estaremos logados no Django Admin =)

Agora podemos gerenciar toda a parte de autenticação e autorização da aplicação, além do model Cliente que configuramos anteriormente.

Vale lembrar que o Django Admin nos permite fazer todas as operações de CRUD (Criar, Exibir, Atualizar e Remover) na nossa tabela de clientes:

Conclusão

Com isso, vimos o quão rápido e fácil é o processo de criação de aplicações administrativas com Django. Isso nos facilita muito quando precisamos de uma aplicação para gerenciar os dados de um banco de dados.

JUNTE-SE A MAIS DE 150.000 PROGRAMADORES