- Developed on online bookstore application using Django and HTML/CSS/JavaScript, featuring secure user authentication, account activation, profile editing, and password management with automated email notifications to enhance user experience and security.
- Implemented advanced search functionality, allowing users to filter books by category, author/publisher, ratings, and price, alongside a seamless ordering process, including promotion code integration, order summary, and reordering options.
- Enabled admin capabilities to add and manage promotions, with automatic email notifications to opted-in users, while incorporating inventory checks for reordering and ensuring promotion validity, resulting in a comprehensive and user-friendly e-commerce platform.
- Website working
- Database creation
- Requirements
- Running the website
- Email account to send emails
- Admin account
- Reset website
- License
A logged off user can search for books and look for the details of the interested books. When the user tries to make a purchase, the user is redirected to the sign-in page.
logged_off_user.mp4
To sign up, the user has to provide personal information and optionally, provide address and payment information. After a user has provided the required information, an email is sent to the user with a link to activate the account. Clicking the link activate's the account and redirect's the user to the homepage.
If the user has not activated the account, then the user would be treated as a logged-off user and when the user tries to sign-in, an error message, "Please activate your account" would be shown.
sign-up-process.mp4
You can do the following
- Edit personal information
- Edit address information
- Add/Remove payment cards. A maximum of three cards can be stored in the system. All the card information is stored encrypted
When you click "save changes" the information is updated in the database and an email is sent to the user. The information sent includes
- Address has been deleted
- Any changes made to personal information
- Any changes made to address information
- If a new payment card has been added to your account
- If a previous payment card has been removed from your account
editing_profile.mp4
A user can change the password of their account, if they are already logged in. To do this the user must provide the old password and then enter the new password. Checks are implemented to ensure the new password is strong, including things like
- New password cannot to similar to personal information
- New password cannot be similar to old password
- Checks about minimum length / special characters / numbers
An email is also sent to the user about the change the change of password.
change_password.mp4
If a user cannot remember their password, then the user can click the Forgot password link on sign-in page, to reset their password.
Upon clicking the link, the user is asked to enter their email address. Then an email is sent to the user with a link that will take the user to the reset password page. Checks are implemented to ensure the new password is strong, including things like
- New password cannot to similar to personal information
- New password cannot be similar to old password
- Checks about minimum length / special characters / numbers
forgot_password.mp4
There are two types of search provided: basic search and advanced search.
In basic search, the user is required to type the name of a book in the search bar and if the name matches with a book in the database then the book is shown otherwise an error message that no book exists in the database is shown. For this project, we need to enter the exact name of the book (case insensitive).
In advanced search, we can filter the books using the following information
- Category
- Author / Publisher
- Top rated / Newest / Oldest / Price: Low to High / Price: High to Low
Using the above three filters, the user can search for the information they are interested in.
searching_for_books.mp4
Steps to place an order are as follows
- Add the respective books to the shopping cart.
- After all the books have been added, go to your cart and then continue to checkout.
- In the first step of checkout, you are required to enter your personal and address information. By default, these are fetched from your profile. Optionally, you can enter a valid promotion code to reduce the price of your order.
- In the second step of checkout, you are required to enter the payment information. Here you are provided with a list of all the cards saved in your profile or you can enter a new payment card. Optionally, you can enter a valid promotion code to reduce the price of your order.
- In the next step, a summary of your order is shown. And here you can also modify the information provided in step 3 and step 4 before finalizing the order.
- Finally, you can place the order.
placing_an_order.mp4
An admin can add new promotions to be used by the users. When an admin adds a new promotion, an email is sent to all the users, who have opted in to receive promotions.
Now the users can use this promotion when they place their next order. All the required checks have implemented, including
- User can use the same promotion only once
- Promotion should have started before use
- Promotion should not have expired on use
adding_promotions_to_website.mp4
- You can reorder books from your previous orders. In case some books from your previous order are out of stock, then an error message is shown that some books could not be added to your cart as they are out of stock and the remaining books are added to the cart.
- View order history.
Database creation was a problem, as most of the websites don't allow you to scrape their websites. As a workaround I found the following website that had all the information about the books I was interested in.
So to scrape the website, manually copy the HTML code of the category of the book you are interested in and then run the code provided at this link.
Instructions regarding the code
- Name the HTML file as
temp.htmland place it in the same directory as the jupyter notebook - All the images would be saved in
path = "cover_images" - The name of the images is a counter, starting from 100,
counter = 100(e.g. 100.jpg, 101.jpg)
A backup of the database I used is also provided at extra/database.zip.
The website was built using the following versions of the libraries
- python = 3.9.7
- Django = 3.2.7
- django-cryptography = 1.0
Download python using Miniconda and then install Django using the following command
python3 -m pip install Django==3.2.7 django-cryptography==1.0
First clone the repository
git clone https://github.com/KushajveerSingh/genlib.git
cd genlib
Now you can run the website from the genlib folder
cd genlib
python manage.py runserver
The server will start at localhost:8000.
For this project, I created a dummy gmail account. The credentials for this account are already setup in the genlib/genlib/settings.py as following
EMAIL_HOST_USER = 'kushaj123456@gmail.com'
EMAIL_HOST_PASSWORD = 'kushaj12345678'
Change the above settings with your own email and password, and do not push these credentials to github. If you decide to use my email, then it might not work as I think Google automatically turns off access to insecure apps (yes Django is insecure according to Gmail).
The default admin account has the following credentials
Email = kushaj@gmail.com
Password = 12345678
You can sign-in using the above credentials and you would automatically be taken to the admin portal, or you can navigate to localhost:8000/admin and then enter the above credentials to enter admin portal.
If you want to use this website, then you might want to remove all the previous stuff. Or if you run into some weird issue then you can also these instructions to reset everything.
-
Delete
genlib/db.sqlite3 -
Delete
genlib/bookstore/migrationsfolder -
Migrate
cd genlib python manage.py makemigrations bookstore python mange.py migrate -
Create new admin account. Run the below code and then enter the credentials of the admin in the prompts.
cd genlib python manage.py createsuperuser