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.

Deixe seu comentário

Graduanda em Sistemas de Informação pelo Instituto Federal da Bahia.

JUNTE-SE A MAIS DE 150.000 PROGRAMADORES