Skip to content

tasks_module1.md

Latest commit

 

History

History
67 lines (45 loc) · 3.79 KB

tasks_module1.md

File metadata and controls

67 lines (45 loc) · 3.79 KB

Create user app

We’re going to create a separate user app within our project. Run the following command to do that:
python manage.py startapp users

Include the new app into the project

Inside of settings.py, find the INSTALLED_APPS list and after 'mainapp', add 'users'.

Add login template

We went ahead and created a basic login template for you to copy. First, create a folder inside the users/ directory called templates. Then, from the support/ directory, move the login.html file into the users/templates/ directory.

Create custom user model

Now we want to create our User model in users/models.py. To create a User class that derives from AbstractUser do the following: Add the import -- from django.contrib.auth.models import AbstractUser Create the class User and derive from AbstractUser like so -- class User(AbstractUser): Leave the class definition empty with pass, the base class has all we need for now.

Add user model to the admin site.

In order to have access to this model in the admin, we need to register it in admin.py. Let’s do the following: from django.contrib.auth.admin import UserAdmin from .models import User Call admin.site.register() with User and UserAdmin as parameters.

Set user settings in the main project

We need to specify the login URLs and the User model to use for authentication in settings.py. At the bottom of settings.py in the blogproj/ directory, add three global variables. First add LOGIN_URL and set it to 'login'. Next, add LOGIN_REDIRECT_URL set to 'index'. Lastly, add AUTH_USER_MODEL with value of 'users.User'

Add routes to the user app

Next, we need to setup routes for the user project. Like in the main app, we’ll create a dedicated urls.py file inside of the users directory. We’re going to use auth_views.LoginView.as_view() and auth_views.LogoutView.as_view() to provide built-in login and logout functionality. Copy and paste the following URL patterns into your newly create urls.py file:

urlpatterns = [
    path('login/', auth_views.LoginView.as_view(template_name='login.html'), name='login'),
    path('logout/', auth_views.LogoutView.as_view(next_page='index' ), name='logout'),
]

And don’t forget the following imports: from django.contrib.auth import views as auth_views from django.urls import path from . import views

Redirect user related routes to the user project

In blogproj/urls.py, add path('accounts/', include('users.urls')), as the first entry in the urlpatterns array.

Add login/logout to site templates

In the templates/base.html template, uncomment the Login and Logout list items by removing the {% comment %} and {% uncomment %} tags inside the navbar-nav div.

Run initial migrations

Now that we’ve added our User model we need to run migrations. From the command line, inside the root of the project, run the following commands: python manage.py makemigrations python manage.my migrate Note: Make sure your venv is activated with source venv/bin/activate Note: If you made migrations before adding the user model, you’ll want to remove them because it will cause errors. You can do this by deleting all files in the mainapp/migrations folder, users/migrations folder, and the db.sqlite3 file.

Create an admin user

Create a superuser by running the following command from the command line: python manage.py createsuperuser.

At this point we can login and logout with our superuser. Let’s test this out by running python manage.py runserver, then visit localhost:8000. Click on the Login link, then login with your superuser credentials. You can also login to the admin at localhost:8000/admin. Congratulations! You successfully implemented a custom User model with authentication.