Django

Criando uma aplicação administrativa com Django Admin

Neste artigo veremos como criar uma aplicação administrativa com Django.

há 5 anos 2 semanas

Formação Full-stack: Desenvolvedor Django
Conheça a formação em detalhes

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.

Django - Fundamentos
Curso Django - Fundamentos
Conhecer o curso

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:

Tela de configurações do PyCharm

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:

Criando virtualenv

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:

Escolhendo pacotes para virtualenv

Selecionando pacote mysqlclient

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

Tela de resultado após instalação dos pacotes

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.

Django - Templates
Curso Django - Templates
Conhecer o curso

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:

Tela de login do django admin

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:

Tela adicionar cliente CRUD Django Admin

Tela selecionar cliente CRUD Django Admin

Tela modificar cliente CRUD Django Admin

Tela confirmação de remoção de cliente

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.

Autor(a) do artigo

Ana Paula de Andrade
Ana Paula de Andrade

Graduanda em Sistemas de Informação pelo Instituto Federal da Bahia. É responsável pelo atendimento ao cliente, gerenciamento de redes sociais e revisão de cursos, além da redação de artigos para o blog da TreinaWeb.

Todos os artigos

Artigos relacionados Ver todos