Django is a high-level web framework that lets developers easily build web applications quickly. It is free and open source, and is widely used by developers all around the world. Django focuses on the reusability and pluggability of components, encouraging developers to write clean and reusable code.<\/p>\n
In this tutorial, we will guide you through building a web application using Django, step-by-step. We will first help you get started by setting up the development environment and then walk you through the process of creating a simple web app.<\/p>\n
Before we start building our web app, we need to set up our development environment. To get started, follow these steps:<\/p>\n
Django is a Python framework. So, the first step is to install Python. You can download the latest version of Python from the official website: https:\/\/www.python.org\/downloads\/<\/p>\n
Once you have installed Python, you can install Django using pip, the Python package manager. Open your terminal (command prompt or PowerShell for Windows) and run the following command:<\/p>\n
pip install Django\n<\/code><\/pre>\nThis will install the latest version of Django on your system.<\/p>\n
3. Create a new Django project<\/h3>\n
Now that we have installed Django, let’s create a new Django project. Open your terminal and run the following command:<\/p>\n
django-admin startproject myproject\n<\/code><\/pre>\nReplace myproject<\/code> with the name of your project. This will create a new Django project in a directory with the same name.<\/p>\n4. Run the development server<\/h3>\n
Let’s start the development server and see if everything is working correctly. Navigate to the project directory and run the following command:<\/p>\n
python manage.py runserver\n<\/code><\/pre>\nThis will start the development server on port 8000 by default. You should see a message in your terminal that says “Starting development server at http:\/\/127.0.0.1:8000\/”. Open your web browser and go to http:\/\/127.0.0.1:8000\/. You should see a “Welcome to Django” page.<\/p>\n
Congratulations! You have set up your development environment and created a new Django project.<\/p>\n
Creating a Simple Web App<\/h2>\n
Now that we have set up our development environment and created a new Django project let’s create a simple web app. Our web app will be a simple blog where users can create new posts, view posts, and leave comments.<\/p>\n
1. Create a new Django app<\/h3>\n
In Django, a project is divided into multiple apps. An app is a standalone module that does a specific job. We will create a new app for our blog. Navigate to the project directory and run the following command:<\/p>\n
python manage.py startapp blog\n<\/code><\/pre>\nThis will create a new Django app named blog<\/code>.<\/p>\n2. Configure the database<\/h3>\n
Django comes with support for various databases, including SQLite, MySQL, and PostgreSQL. In this tutorial, we will use SQLite. Open the settings.py<\/code> file in the project directory and find the DATABASES<\/code> setting. Replace it with the following:<\/p>\nDATABASES = {\n 'default': {\n 'ENGINE': 'django.db.backends.sqlite3',\n 'NAME': BASE_DIR \/ 'db.sqlite3',\n }\n}\n<\/code><\/pre>\nThis will configure Django to use SQLite as the default database.<\/p>\n
3. Create the blog models<\/h3>\n
In Django, models represent the data in our application. We will create models for blog posts and comments. Open the models.py<\/code> file in the blog<\/code> app directory and add the following code:<\/p>\nfrom django.db import models\nfrom django.contrib.auth.models import User\n\nclass Post(models.Model):\n title = models.CharField(max_length=200)\n author = models.ForeignKey(User, on_delete=models.CASCADE)\n body = models.TextField()\n\nclass Comment(models.Model):\n post = models.ForeignKey(Post, on_delete=models.CASCADE, related_name='comments')\n author = models.ForeignKey(User, on_delete=models.CASCADE)\n body = models.TextField()\n created_on = models.DateTimeField(auto_now_add=True)\n<\/code><\/pre>\nThis defines two models, Post<\/code> and Comment<\/code>. The Post<\/code> model contains a title, author, and body. The Comment<\/code> model contains a post, author, body, and created_on timestamp.<\/p>\n4. Create the blog views<\/h3>\n
In Django, views handle the HTTP requests and responses. We will create views to display the blog posts and comments, as well as a form to create new posts and comments. Open the views.py<\/code> file in the blog<\/code> app directory and add the following code:<\/p>\nfrom django.shortcuts import render, get_object_or_404\nfrom .models import Post, Comment\nfrom .forms import CommentForm\n\ndef post_list(request):\n posts = Post.objects.all()\n return render(request, 'blog\/post_list.html', {'posts': posts})\n\ndef post_detail(request, pk):\n post = get_object_or_404(Post, pk=pk)\n comments = post.comments.all()\n if request.method == 'POST':\n form = CommentForm(request.POST)\n if form.is_valid():\n comment = form.save(commit=False)\n comment.post = post\n comment.author = request.user\n comment.save()\n else:\n form = CommentForm()\n return render(request, 'blog\/post_detail.html', {'post': post, 'comments': comments, 'form': form})\n\ndef post_new(request):\n if request.method == \"POST\":\n form = PostForm(request.POST)\n if form.is_valid():\n post = form.save(commit=False)\n post.author = request.user\n post.save()\n return redirect('post_detail', pk=post.pk)\n else:\n form = PostForm()\n return render(request, 'blog\/post_edit.html', {'form': form})\n<\/code><\/pre>\nThis defines three views, post_list<\/code>, post_detail<\/code>, and post_new<\/code>. post_list<\/code> displays a list of all posts, post_detail<\/code> displays a single post and associated comments, and post_new<\/code> displays a form to create a new post.<\/p>\n5. Create the blog forms<\/h3>\n
In Django, forms handle user input. We will create a form to allow users to create new comments. Open the forms.py<\/code> file in the blog<\/code> app directory and add the following code:<\/p>\nfrom django import forms\nfrom .models import Comment\n\nclass CommentForm(forms.ModelForm):\n\n class Meta:\n model = Comment\n fields = ('body',)\n<\/code><\/pre>\nThis defines a form for creating a new comment. The form contains a single field for the body of the comment.<\/p>\n
6. Create the blog templates<\/h3>\n
In Django, templates handle the display of data in HTML. We will create templates to display the blog posts and comments, as well as forms to create new posts and comments. First, create a new directory named templates<\/code> in the blog<\/code> app directory. Then, create the following HTML files:<\/p>\nbase.html<\/code>:<\/p>\n{% load static %}\n<!DOCTYPE html>\n<html>\n<head>\n <title>{% block title %}{% endblock %}<\/title>\n <link rel=\"stylesheet\" href=\"{% static 'css\/style.css' %}\">\n<\/head>\n<body>\n\n<div class=\"header\">\n <h1><a href=\"{% url 'post_list' %}\">My Blog<\/a><\/h1>\n<\/div>\n\n<div class=\"content\">\n {% block content %}{% endblock %}\n<\/div>\n\n<div class=\"footer\">\n \u00a9 My Blog 2021\n<\/div>\n\n<\/body>\n<\/html>\n<\/code><\/pre>\npost_list.html<\/code>:<\/p>\n{% extends 'blog\/base.html' %}\n\n{% block content %}\n\n{% for post in posts %}\n <div class=\"post\">\n <h2><a href=\"{% url 'post_detail' pk=post.pk %}\">{{ post.title }}<\/a><\/h2>\n <p class=\"meta\">Posted by {{ post.author }} on {{ post.published_date }}<\/p>\n <p>{{ post.body }}<\/p>\n <\/div>\n{% endfor %}\n\n{% endblock %}\n<\/code><\/pre>\npost_detail.html<\/code>:<\/p>\n{% extends 'blog\/base.html' %}\n\n{% block content %}\n\n<div class=\"post\">\n <h2>{{ post.title }}<\/h2>\n <p class=\"meta\">Posted by {{ post.author }} on {{ post.published_date }}<\/p>\n <p>{{ post.body }}<\/p>\n<\/div>\n\n{% for comment in comments %}\n <div class=\"comment\">\n <p class=\"meta\">Posted by {{ comment.author }} on {{ comment.created_on }}<\/p>\n <p>{{ comment.body }}<\/p>\n <\/div>\n{% empty %}\n <p>No comments yet.<\/p>\n{% endfor %}\n\n<h3>Leave a comment<\/h3>\n\n<form method=\"post\">\n {% csrf_token %}\n {{ form.as_p }}\n <button type=\"submit\">Submit<\/button>\n<\/form>\n\n{% endblock %}\n<\/code><\/pre>\npost_edit.html<\/code>:<\/p>\n{% extends 'blog\/base.html' %}\n\n{% block content %}\n\n<h1>New Post<\/h1>\n\n<form method=\"post\">\n {% csrf_token %}\n {{ form.as_p }}\n <button type=\"submit\">Save<\/button>\n<\/form>\n\n{% endblock %}\n<\/code><\/pre>\n7. Create the blog URLs<\/h3>\n
In Django, URLs map the HTTP requests to the appropriate views. We will create URL patterns for our blog views. Open the urls.py<\/code> file in the blog<\/code> app directory and add the following code:<\/p>\nfrom django.urls import path\nfrom . import views\n\nurlpatterns = [\n path('', views.post_list, name='post_list'),\n path('post\/<int_pk>\/', views.post_detail, name='post_detail'),\n path('post\/new\/', views.post_new, name='post_new'),\n]\n<\/code><\/pre>\nThis defines three URL patterns, one for each view.<\/p>\n
8. Include the blog URLs in the project URLs<\/h3>\n
Now that we have created the URLs for our blog app, we need to include them in the project URLs. Open the urls.py<\/code> file in the project directory and add the following code:<\/p>\nfrom django.contrib import admin\nfrom django.urls import include, path\n\nurlpatterns = [\n path('admin\/', admin.site.urls),\n path('', include('blog.urls')),\n]\n<\/code><\/pre>\nThis includes the URLs for the blog<\/code> app under the root URL.<\/p>\n9. Migrate the database<\/h3>\n
Finally, we need to create the database tables. Run the following command in the terminal:<\/p>\n
python manage.py migrate\n<\/code><\/pre>\nThis will automatically create the necessary database tables for our app.<\/p>\n
10. Run the development server<\/h3>\n
Let’s start the development server and see our app in action. Navigate to the project directory and run the following command:<\/p>\n
python manage.py runserver\n<\/code><\/pre>\nOpen your web browser and go to http:\/\/127.0.0.1:8000\/. You should see a list of blog posts. Click on a post to view it in detail and leave a comment.<\/p>\n
Congratulations! You have created a simple web app using Django.<\/p>\n
Conclusion<\/h2>\n
In this tutorial, we have shown you how to build a simple web app using Django. We covered the basics of Django including models, views, templates, URLs, and more. With this knowledge, you can now go on to build more complex web apps using Django. Happy coding!<\/p>\n","protected":false},"excerpt":{"rendered":"