Registro de usuários com Django 2

Neste artigo veremos como utilizar o sistema de registros built-in do Django para que usuários possam se cadastrar.

Posts anteriores e repositório:

Fala aí, tudo bem? este post faz parte de um projeto que estamos construindo sobre Django, o que você vai ler a seguir é é uma continuação de uma série de artigos  sobre esse assunto,  se você quiser ficar por dentro, o link abaixo é do primeiro post:

1. Instalando Django 2 e criando um projeto;

O código de todo o conteúdo está disponível aqui!

obs: esta á  parte 8, se quiser o código final utilize a pasta 8, caso queira acompanhar o tutorial inicie na pasta 7.

Criando um novo app para account

Para este recurso de registro vamos precisar de views e templates, então para não misturar com um app já existente que tem outro propósito vamos criar um novo.

Além disso, futuramente poderemos expandir este app para mais recursos relacionados a contas e usuários.

Para criar o novo app, eu escolhi o nome  account para ele mas sinta-se livre para usar um de sua escolha

Utilize o seguinte comando:

python manage.py startapp account

Com este comando os arquivos base para o novo app devem ter sido criados, confira a pasta.

Registro do app

Como acontece em todo app novo, devemos deixar o Django sabendo que temos um novo módulo.

Para isso abra o nosso famoso settings.py do projeto e deixe a constante INSTALLED_APPS assim:

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'blog',
    'account',
]

Agora já podemos utilizar o app, pois o Django tem conhecimento que ele existe.

Criar URL

Outro passo importante é criar a URL que retornará a view de registro.

Para isso vamos primeiramente registrar nossas urls desse app no arquivo urls.py do projeto.

Deixe o arquivo desta maneira:

from django.contrib import admin
from django.urls import path, include
urlpatterns = [
    path('', include('blog.urls')),
    path('admin/', admin.site.urls),
    path('account/', include('account.urls')),
    path('account/', include('django.contrib.auth.urls')),
]

Agora temos as URLs de account do Django e do nosso app account.

Isso poderia gerar um conflito, não é?

Porém há um detalhe que anteriormente eu não citei: as urls são lidas de cima para baixo, ou seja, se houver algum conflito de URLs as que tem o nome mais acima vão prevalecer.

Assim num caso hipotético uma URL do app core de account do Django seria sobrescrita pelas do nosso app account.

Se ainda ficou com dúvidas, veja mais sobre URLs neste post, escrevi somente sobre este assunto.

Criar a view

Agora devemos criar a view, que fará a parte de lógica do registro de usuários.

Abra o  arquivo views.py de account, e deixe-o da seguinte maneira:

from django.shortcuts import render
from django.contrib.auth.forms import UserCreationForm
from django.urls import reverse_lazy
from django.views import generic
class register(generic.CreateView):
    form_class = UserCreationForm
    success_url = reverse_lazy('login')
    template_name = 'account/register.html'

Várias novidades nessa view, vamos por partes:

• from django.contrib.auth.forms import UserCreationForm: Nesta linha estamos importando o form de registro padrão do Django para nos poupar tempo;
• from django.urls import reverse_lazy: o método reverse_lazy fará o redirecionamento do usuário após o registro, como você pode ver escolhemos que ele vá diretamente para o login, fazer sua autenticação;
• from django.views import generic: Com generic nós poderemos criar uma view a partir de uma classe, também chamada Class Based View do Django;

Conforme mencionei no último tópico, estamos criando uma Class Based View, que nos salva tempo também porém o fato dela ser genérica não nos permite tanta personalização.

Utilizamos este recurso quando queremos algo simples e que já está pronto, por isso utilizar ela num recurso que o Django nos oferece pronto para uso foi interessante.

Com poucas linhas temos um formulário de registro funcional.

E nesta view setamos alguns componentes como: formulário para o registro, url de redirecionamento e o caminho do template, que é o nosso próximo passo.

Alterando template de registro

Agora para verificar se tudo está funcionando corretamente, só precisamos do template para a view.

Então em account/templates/account/ crie o arquivo register.html, com o seguinte conteúdo:

{% extends 'blog/base.html' %}
{% block title %}Crie sua conta{% endblock %}
{% block content %}
    <div class="container">
        <h1>Crie sua conta</h1>
        <form action="." method="post">
            {% csrf_token %}
            {{ form.as_p }}
            <input class="btn btn-primary" type="submit" value="Registrar">
        </form>
    </div>
{% endblock %}

Nada de diferente aqui, estendemos o template base, mudamos os nossos blocos com o conteúdo de registro.

Caso queira entender o form.as_p ou o CSRF, veja este post, explico todos os detalhes destes dois carinhas. 

Testes

Agora apenas nos resta acessar a URL e testar a funcionalidade.

Inicie o servidor com:

python manage.py runserver

Acesse a URL:

http://127.0.0.1:8000/account/registrar/

A tela que você vai receber deve ficar parecida com esta:

Perceba que o front ficou meio feio, devemos utilizar um pouco de CSS e JS para dar um jeito nisso, porém como sai do escopo do tutorial vou deixar essa missão para você.

Uma dica: utilize o Bootstrap para o formulário, veja como aqui.

Para fim de conclusão do tutorial faça o registro de um novo usuário e por fim o login. 😀

Conclusão

Primeiramente foi necessário criar um novo app,  chamado account, para não misturarmos dois conceitos diferentes num já existente.

Configuramos o novo app tanto no settings como também na URL do projeto.

Partimos então para a criação da view e do template, para podermos finalizar o nosso objetivo.

Vimos o conceito de alguns termos como:

• reverse_lazy: redirecionamento de página;
• generic view: View genérica para resolver de forma mais fácil a view,  interessante utilizar num aplicativo built in;
• Class Based View: uma view baseada numa classe; 

E por fim testamos a funcionalidade de registro.

Pessoal, agradeço a todos por lerem até o fim, se possível compartilhem com os amigos interessados em Django e se inscrevam na nossa lista de e-mail para não perder as novidades.

Caso haja alguma dúvida ou crítica, comentem abaixo que responderei assim que possível, obrigado!