Tutorial: Configurando um ambiente virtual, instalando o Django, criando um aplicativo, configurando uma rota, instalando o CKEditor, criando um modelo e executando migrações no Django
Passo 1: Cria o ambiente virtual
Passo 2: Instalar o Django e outras dependências
Passo 3: Criar um projeto e um aplicativo
O nome do projeto será project
e o nome do aplicativo será website
:
Passo 4: Alterar as configurações do projeto no arquivo project/settings.py
- Abra o arquivo
project/settings.py
e altere o seguinte:
- No início do arquivo, logo após
from pathlib import Path
adicione o seguinte código:
O código acima irá importar os módulos os
, logandprint
e o método config
da biblioteca decouple
para carregar as variáveis de ambiente do arquivo .env
. Cada vez que você alterar o arquivo .env
será necessário reiniciar o servidor.
- DEBUG: Altere o valor de
DEBUG
paraconfig('DEBUG')
, isso irá pegar o valor da variável de ambienteDEBUG
que está no arquivo.env
:
- Crie um arquivo chamado
.env
na mesma pasta do arquivomanage.py
(raiz do projeto) com o seguinte conteúdo (nesse arquivo ficarã todas as variáveis que serão diferentes em cada ambiente, como por exemplo,SECRET_KEY
,DEBUG
,ALLOWED_HOSTS
, etc):
- ALLOWED_HOSTS: No arquivo
project/settings.py
altere a variávelALLOWED_HOSTS = []
para pegar o valor da variável de ambienteALLOWED_HOSTS
e transformar em uma lista de hosts válidos:
- INSTALLED_APPS: Adicione o aplicativo
ckeditor
,ckeditor_uploader
e o appwebsite
na listaINSTALLED_APPS
:
- TEMPLATES: Substitua
'DIRS': [],
pelo diretóriotemplates
:
- TIME_ZONE: Altere o fuso horário para America/Fortaleza
- LANGUAGE_CODE: Altere o idioma para pt-br
- USE_L10N: Adicione para
USE_L10N = True
para usar o idioma, formato de data e formato de número do Brasil:
- No final do arquivo, adicione as seguintes variáveis:
Você poderá usar o comando log.write
para escrever no console e no arquivo app.log
que será criado no diretório app
:
Passo 5: Crie um model para o aplicativo website
- Abra o arquivo
website/models.py
e cria uma classe que conterá a estrutura do modelo:
- Adicionando o aplicativo
website
no painel de administração do Django, abra o arquivowebsite/admin.py
e adicione o seguinte código:
Passo 5: Configurar as rotas
- Abra o arquivo
project/urls.py
e adicione o código abaixo, isso irá configurar o CKEditor e o acesso à pastamedia
, a linhare_path(r'^ckeditor/', include('ckeditor_uploader.urls')),
serve para adicionar as rota do CKEditor e o comando+ static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
no final da listaurlpatterns
serve para adicionar a rota da pastamedia
:
- Criar uma rota para o aplicativo
website
Abra/Crie o arquivo website/urls.py
e adicione o seguinte código:
Passo 6: Criar uma view
- Abra/crie o arquivo
website/views.py
e adicione o seguinte código:
- Crie um arquivo chamado
home.html
no diretóriotemplates
e adicione o seguinte código:
Passo 7: Execute as migrações, crie um superusuário e execute o servidor
Lembre-se sempre de executar os comandos abaixo dentro do ambiente virtual.
- Execute as migrações:
- Crie um superusuário:
- Execute o servidor:
Agora você já pode acessar o endereço http://127.0.0.1:8000/
para ver a página inicial do seu aplicativo e http://127.0.0.1:8000/admin/
para acessar o painel de administração.
Dica: Alterando um model
Após fazer alterações em um model, para que as alterações sejam aplicadas no banco de dados, é necessário executar o seguinte comando:
Super Dica: Automatizando o processo de migrações e execução do servidor
Crie um arqruivo chamado run.ps1
e adicione o seguinte código:
Agora você pode executar o comando .\run.ps1
para executar as migrações e o servidor.