checkmark

Django

Introduction to Django

What is Django How Django Works Installation and setup Creating Your First Django Project File Structure in Django Project Manage.py file in Django

Configuration in Settings File

Database Configuration No SQL Database Configuration Template Configuration Static Folder Configuration Media Configuration Tailwind Configuration

Apps in Django

Introduction Creating an app Routing app with project Displaying Welcome Message Rendering Template

Manage.py Commands

Help Command RunServer Command Shell Command Flush Command Creating Custom Command

Registration and Authentication - Default User Model

Introduction and Project Setup for User Authentication Routing authentication app with project Creating home page Restricting access to web page Register User Logout User Login User Redirection to Login Page Handling Next in Login

Models in Django

Characteristics of Models Creating a Model Interactive Shell for Model Operations String Representation for Model Generating Dummy Data Retrieving Data From Models Filters in Model Exclude in Models Field Lookups Q expressions Retrieving Single Record Updating A Record Updating Multiple Records Overriding save() method Annotate in Models F expressions Order By in Models Retrieving specific columns Prefetch particular columns alone Custom Methods in Model Data Types in Models One-To-One Relationship One-To-Many Relationship Many-to-Many Relationship Meta Class in Models Unique Parameter Static Method in Models

A basic Notes App

Introduction and Setup Configuring Templates and Static Folder Creating an app Creating Model Adding sample notes Display Notes Adding Note through form Edit Notes Delete a Note Display Bug Update Admin Panel Register Note Model Customize Admin Page Editing Fields in List Downloading Notes as CSV file

Data Types in Models

Data Type Demo App creation Char Field Text Field Integer Field Float Field Decimal Field

College Event Registration Website

CampusConnect Introduction and Setup Configuring settings file for template, static and media files Setting up Tailwind Creating Custom User Model Creating Super User for CampusConnect Registering Custom User Model Search and Filter for User Model Serving Media Files During Development Categorizing Departments Linking Department with HOD Creating Abstract Model for Event Creating Model for Workshop Customizing Admin Page for Workshop Update in Model AbstractEvent Adding Instructor for Workshop Instructor Model Admin Page Adding Poster Field in Abstract Event Providing Access to HOD Access Update for HOD Restricting HOD Access to Particular Department AbstractEvent On Spot Registration Field Creating Workshop Object Creating and Linking Home Page Displaying Workshop on Home Page Styling Home Page Adding Workshop Detail Page Link Workshop Detail Page Workshop Detail Page Styling Workshop Instructor Details Workshop Detail Contact Contact Admin Page Many to Many Field for Contact Displaying Contact on Workshop Detail Page Adding Title for Workshop Detail Page Adding Gallery for Workshop Workshop Gallery Admin Page Displaying Gallery Images on Website Through Context Displaying Gallery Images on Website through template tags Authentication for users User Registration User Registration Submission Logout Functionality For User Login Functionality for User Model For Workshop Registration Workshop Registration Admin Page Register Workshop Function Register Button in Workshop Page Validations Before Workshop Registration Workshop Registration Closed Validaiton User Already Registered for Workshop Validation Workshop Registration Report From Admin Page Export using Library in Django Admin Extending Abstract Event for Hackathons
menu Back to Edkool

Creating Custom User Model

Django, provides us with a default user model. The default user model in django, contains username as the unique key which identifies each entry uniquely in the users table and is used for authentication purpose. But our CampusConnect aims to target college students to register for events and it won't be suitable to make them enter a username for registration purpose. In this kind of college event registration website, the user should be prompted with email for registration and authentication purpose. In order to acheive this, we can use the AbstractUser class and edit the fields we want.

Before doing this, we would need to create an app inside the project. Let's create an app named authentication.

python manage.py startapp authentication

alt text We would also need to add the app inside the INSTALLED_APPS in settings.py file.

'authentication',

After doing this, you can open your authentication/models.py and create a custom user model.

from django.db import models
from django.contrib.auth.hashers import make_password
from django.contrib.auth.models import AbstractUser


class User(AbstractUser):
    username = None
    email = models.EmailField('Email Address', unique=True)
    profile_photo = models.ImageField(upload_to='profile_photos/', null=True, blank=True,default='profile_photos/default_profile.png')
    mobile_number = models.CharField(max_length=10, null=True, blank=True)
    role = models.CharField(max_length=1, choices=[('a', 'Admin'), ('h', "HOD"), ('s', 'Student')])

    USERNAME_FIELD = 'email'
    REQUIRED_FIELDS = []

    def save(self, *args, **kwargs):
        if not self.password.startswith('pbkdf2_sha256$'):
            self.password = make_password(self.password)
        super().save(*args, **kwargs)

So here, we have set the username to None and added some extra fields along with to store the user information such as profile_photo, mobile_number and role. The ImageField upload path is profile_photos, so we need to create a folder named profile_photos inside the media folder and add a default_profile.png image there for the default value. The USERNAME_FIELD is set to email as that will be used for authentication purposes and also REQUIRED_FIELDS is set to null as the username is by default a required field in the Django model. Also the save() method is also overrided in order to hash the password if its not while saving the user object.

Along with this, in the settings.py file, you need to specify that this model will be used for authentication purpose. This can be done by adding the following line inside settings.py file.

AUTH_USER_MODEL = 'authentication.User'

Now you can go ahead and run the migrations to create the table in database.

python manage.py makemigrations

alt textWe received an error that ImageField is being used but Pillow library is not installed. Without the Pillow library, ImageField can't be used in Django. So let's install the Pillow library first.

pip install pillow

alt text After pillow has been installed, we can continue to run the migrations command to create the table in the database.

python manage.py makemigrations
python manage.py migrate

alt text Now, the custom user model has been created successfully.

Previous Setting up Tailwind
Next Creating Super User for CampusConnect