DEV Community

Cover image for Django User Profile - Learn to code in Django

Posted on • Updated on • Originally published at

Django User Profile - Learn to code in Django

Hello Coders,

This article explains how to code a Django User Profile available for authenticated users outside of the admin module. The content might help beginners learn new things about Django and code a real project with commercial value.

For newcomers, Django is the most popular Python-based web framework initially released in 2003 and is currently a reference framework in web development.

The "batteries-included" concept and the built-in security patterns provided by experts make Django software used by tech giants like Disqus and Instagram.

Django User Profile - Open-source Django Sample provided by Themesberg and AppSeed

Django Short Intro

Django is an open-source framework that follows the MVT (Model View Template) architectural pattern. The framework emphasizes rapid development, code reusability on top of security best practices provided by experienced developers. A few reasons to use Django:

Complete, mature framework - The “Batteries included” philosophy provided by Django helps developers to implement faster common features like authentication, clean database access, REST services, and much more. Once the developers learn the framework, they can code with ease from simple, one-page sites to eCommerce platforms.

Secure - Versioned by experienced open-source enthusiasts, Django helps developers avoid many common security mistakes by providing modules and layers that have been engineered and tested to protect websites and projects deployed on the internet.

Versatile - Django can be used to code from simple sites to blog platforms, APIs, microservices, or heavy traffic eCommerce platforms. Many big companies like Instagram or Disqus choose Django as their core backend technology.

To read more about Django, feel free to access:

✅ Starter Codebase

The User Profile feature is provided on top of a simple open-source project enhanced with a few basic features like authentication, a nice design, and deployment scripts for Docker and Gunicorn/Nginx stack.

The modular structure uses “apps” to implement the project features:

  • Core application handles the configuration and serves the static assets
  • Authentication manage the login and register action to allow user onboarding
  • App is a simple module that serves the private pages to authenticated users
  • Customers is the new module that handles the profile editing feature

Django User Profile - Codebase structure and inner apps.

The bootstrap flow

  • Django bootstrapper uses core/ as the main configuration file
  • core/ loads the app magic from .env file
  • Redirect the guest users to Login page
  • Unlock the pages served by app module for authenticated users
  • Users can update their profile and change Name, Surname, Birthday, and Address.

✅ The Source Code

To implement this feature we should code a few simple things using the tools provided by Django core. The first thing is to add a new “application” to separate the new logic and preserve the modular design of the existing code. To generate the app skeleton we will invoke the startapp command:

$ python startapp customers
Enter fullscreen mode Exit fullscreen mode

Once the application is generated, the next step is to add a new table that saves the new fields: User, Birthday, Zip, City, Address, ZIP code

Here is the definition of the table - defined in customers/

class Profile(models.Model):

    # Managed fields
    user     = models.OneToOneField(User, related_name="profile", on_delete=models.CASCADE)
    avatar   = models.ImageField(upload_to="customers/profiles/avatars/", null=True, blank=True)
    birthday = models.DateField(null=True, blank=True)
    gender   = models.PositiveSmallIntegerField(choices=GENDER_CHOICES, null=True, blank=True)
    phone    = models.CharField(max_length=32, null=True, blank=True)
    address  = models.CharField(max_length=255, null=True, blank=True)
    number   = models.CharField(max_length=32, null=True, blank=True)
    city     = models.CharField(max_length=50, null=True, blank=True)
    zip      = models.CharField(max_length=30, null=True, blank=True)
Enter fullscreen mode Exit fullscreen mode

To effectively use the table we need to execute a new migration and apply the generated SQL to the database. The associated form will collect the information and submit the information provided by the user using a POST request.

$ # Generate SQL for the new table
$ python makemigrations
$ # Apply changes on database
$ python migrate
Enter fullscreen mode Exit fullscreen mode

The relevant files that provide this flow can be found below:

  • The Profile model defined in customers/
  • The Profile form defined in customers/
  • The Profile view template defined in customers/

The View (aka the controller) handles differently the request based on their type: GET requests will pull the information from the database and populate the form. If the type of the request is POST the information provided by the user is validated and saved in the database for later use.

The curious minds can compile and play with the code by following the build instructions provided in the README file, saved along with the source code on the Github public repository.

Thanks for reading! For more resources, feel free to access:

Top comments (6)

uithemes profile image

Quite useful. Thank you!

sm0ke profile image


crearesite profile image

Can I use the code in my projects?

sm0ke profile image

Yes, the code is released under the MIT License.

zolidev_5 profile image
Zoli Szőgyényi

Awesome resource. Kudos!

sm0ke profile image