Last Updated : 23 Jul, 2025
We will create a simple Django-based newsletter app that allows users to subscribe and unsubscribe using a single form with multiple submit buttons. By leveraging Django's form handling and CSRF protection, we will capture email inputs and store or remove them from the database based on user interaction.
To create the simple newsletter Django app, follow the below steps:
1. Create a new Django projectPrerequisites:
Run the following command to create a new Django project:
django-admin startproject newsletter
Navigate to the project directory:
2. Create a New App for the Newslettercd newsletter
Next, create a new Django app inside your project. The app will handle the logic and templates for the newsletter functionality.
Run the following command to create the app:
django-admin startapp appnewslatter
Create a new urls.py file inside the "appnewslatter" folder. Now, your project directory should look like the below image.
Project DirectoryAfter creating the app, you need to add it to the INSTALLED_APPS list in your settings.py file, which can be found in newsletter/settings.py. Open the settings.py file and add 'appnewsletter' to INSTALLED_APPS:
3. Configure the URLs for the AppINSTALLED_APPS = [
# Other apps
'appnewsletter',
]
Now, set up the URLs for the app by editing the urls.py files.
Edit the urls.py in the Project DirectoryIn newsletter/urls.py, include the URLs of the appnewsletter app:
Python
from django.contrib import admin
from django.urls import path, include
urlpatterns = [
path('admin/', admin.site.urls),
#including URLS of appnewslatter app
path("", include('appnewslatter.urls')),
]
Create urls.py Inside the appnewsletter Folder
Next, create a urls.py file inside the appnewsletter directory and add the URL for the homepage.
Python
from django.urls import path
from . import views
urlpatterns = [
# URL to open home page
path("", views.home, name='home'),
]
4. Create the Template for the Form
Inside the appnewsletter app, create a templates folder to store your HTML files. Inside the templates folder, create a news.html file.
Path: appnewsletter/templates/news.html
Add the following code to create a form with two submit buttons, one for subscribing and one for unsubscribing. Both buttons will perform different actions based on the button clicked.
HTML
<!DOCTYPE html>
<html>
<head>
<title>NewsLatter</title>
</head>
<body>
<!--showing success message-->
{% if messages %}
<ul class="messages">
{% for message in messages %}
<li{% if message.tags %} class="{{ message.tags }}"{% endif %}>
{{ message }}</li>
{% endfor %}
</ul>
{% endif %}
<!--Form with multiple submit buttons-->
<form action="" method="POST">
{% csrf_token %}
<label for="email">Enter your email:</label>
<input type="email" id="email" name="email" />
<br> <br>
<button type="submit" name="subscribe">Subscribe</button>
<button type="submit" name="unsubscribe">Unsubscribe</button>
</form>
</body>
</html>
Here:
In the models.py file, define a model to store the email addresses of the subscribers.
PythonPath: appnewsletter/models.py
from django.db import models
# creating database model to store email
class newslatteremail(models.Model):
userEmail = models.EmailField(max_length=254)
def __str__(self):
return self.userEmail
This model has a single field userEmail that stores the email addresses of the users who subscribe to the newsletter.
6. Register the Model in Django AdminTo manage the subscriber emails from the Django admin interface, you need to register the model.
PythonPath: appnewsletter/admin.py
from django.contrib import admin
from .models import newslatteremail
# registering the model
admin.site.register(newslatteremail)
6. Create the View to Handle the Form Submission
In the views.py file, define the logic to handle form submissions. The home view will check which submit button was clicked using the request.POST dictionary.
PythonPath: appnewsletter/views.py
from django.shortcuts import render
from django.contrib import messages
from .models import newslatteremail
def home(request):
# if post request comes from the subscribe button
# then saving user email in our database
if 'subscribe' in request.POST:
email = newslatteremail()
email.userEmail = request.POST.get("email")
email.save()
messages.info(
request, 'You have successfully subscribed to our newslatter.')
# if post request comes from the unsubscribe button
# then deleting the user email from our database
if 'unsubscribe' in request.POST:
newslatteremail.objects.get(
userEmail=request.POST.get("email")).delete()
messages.info(request, 'sorry to see you!!!')
return render(request, 'news.html')
7. Apply Database Migrations
Now that the model is defined, you need to apply the database migrations to create the table in the database.
Run the following commands:
8. Run the Django Development Serverpython manage.py makemigrations
python manage.py migrate
Once you've implemented all the steps, it's time to run the project. Run the Django development server using the following command:
Python manage.py runserver
Output
HomeWhen we enter email and lick on Subscribe button:
Successfully subscribedWhen we again enter the same email and click on Unsubscribe button:
After UnsubscribingRetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4