This template is an ecommerce website intended for a multiple users to login, create a store and start selling products online in a similar way you would do with Shopify.
If you are interested in single store where you want to sell your own products online checkout this template instead.
This project came to mind as ecommerce is extremely popular nowadays becomes of various unfortunate circumstances.
While there are many many web applications out there to build an ecommerce plateform, it can come at a certain financial cost.
Additionally, you do not have complete control over your SEO or tools you wish to implement because of how much they would cost especially for startup projects.
Creating an ecommerce website from scratch can be a complete hassle. This is where it came about creating these free templates using various free open-source tools around the internet.
While Django is the best web framework ever and Python the greatest language to ever exist, it does not come with things typical for ecommerce websites.
So by creating these free to use templates, you can have your ecommerce plateform without the hassle of coding the majority of the thing and you will be ready to go very fast.
The template depends on the following librairies:
- Celery
- Celery Beat
- Social Django
- Psycopg2
- Stripe
- Django Extensions
- Django Rest Framework
- Boto 3
- Pandas + Numpy
- Flower
- Django Storages
- Python Memcache
And for production:
- Gunicorn
- Redis
Additional librairies include:
- Zappa
This template uses MD Bootrap's Ecommerce template and Dashboard it's main design interface. If you want to implement new items from these original templates, feel free to visit the former links.
By extension, the design CSS framework used for this website is Bootstrap.
Finally, this was created with the lastest version of Django (3.0.x) and Python (3.8.x) and has never been tested with previous versions. There is therefore no guaranty that you application will work as intended if you decide to use versions prior to these ones.
The whole website's frontend is based around using Vue JS. Vue is by the definition the best thing to have ever happened to frontend web development because it simplifies to no extent the implementation of reactivity on you modern web pages.
Vue JS works very very well with Django's templates in the sense that they [the Django template syntax and Vue Js' template syntax] can be binded with one another without any problem.
Vue JS is very easy to pick up and if you wish improve the scripts on the various pages, have no experience with Vue, please visit the link above.
The template uses three main applications: shop
, accounts
and dashboard
.
Each template folder is organized in this specific manner:
- Pages - They represent the main HTML page for the customer
- Components - Represent sub-elements from the main page for reusability (e.g. header, tables...)
- Vue - These are specific Vue JS scripts/components for reactivity
- Scripts - Very specific scripts binded with the Django template (e.g. Stripe payment, Quill...)
NOTE: Under components there are folders named after the page to which they apply. Global components are stored under some sort of global folder.
There are 11 models in the main Shop application as described below.
Before lauching your template live or locally, you might want to find all mywebsite
or contact.mywebsite@gmail.com
instances and change them to the name of your brand.
You can actually keep the name of the project as mywebsite
since it does not have any effects for the customer or overall coding experience.
You will have to take some extra care for files present in SEO folders since they also have mywebsite
instances in them that you will not want to put in production.
Finally, the settings.py
file will require that you have certain specific pieces of information such as AWS or Stripe API Keys. If you do not have does for now, set STRIPE_ENABLED
to false which will disable the script in the template and automatically put the payment system in debug mode.
The template uses static files locally by enabling AWS S3 static location only in production (i.e. when DEBUG is set to false).
Before running this application with Django, you might need to install one or many of these librairies and/or make sure that you have these setup correctly.
If you do not have PostGres, download at PostGreSQL then create a database called template_ecommerce
with a user and password of princess_ecommerce
.
Fork the project and run pipenv install
. Activate the virtual environment with pipenv shell
, run python manage.py makemigrations
[make sure the database exits if you are using PostGres] and then python manage.py migrate
.
Voilà! You are ready to go 🔝
This was built primarily for using Docker in a production environment. However, in case you would want to go serverless, Zappa is included for that purpose. Read more here if you are interested by that setup.
You can setup your server to use docker quickly by using the custom script. Once that's done run docker-compose build
or docker-compose build <service name>
if you want to start each service individually.
If you want to run this website under HTTPS for free, the docker-compose file comes with a Certbot container.
Certbot automatically enable HTTPS on your website.
The container is a standalone one which only purpose is to generate or renew Let's Encrypt certificates necessary for HTTPS secure connections.
To generate certificates, do docker-compose run certbot
and follow the steps.
It uses DNS-01 challenge. In other words, you will need to copy the generated keys (typically .acme-challenge), login to your preferred provider and paste these keys as TXT in the DNS settings of your domain name.
Once you've generated the certificates, they will automatically be picked up by NGINX with the help of volumes.
NOTE: To be able to use Stripe in production, you'll need these certificates or you will not be able to ask for payments online.
If you wish to read more on this go to DNS-01 challenge on Let's encrypt website.
There are many great applications out there for doing this, however, I integrated a very basic Yaml settings file for Circle CI if you wish to implement that in your work flow.
Caching is done with Python Memcached. You can decide to use another caching system if you want to by visiting this page: Django cache framework.
By default, mostly items on the collection's pages are cached for optimization and so as data in the dashboard.
I will be updating and pushing new features on the different templates on a regular basis. Do not hesitate to watch and star ❤️
If you are interested in me participating in some other projects for you relate to the current work that I have done I am currently available for remote and on-site consulting for small, large and enterprise teams. Please contact me at pendenquejohn@gmail.com with your needs and let's work together!