v2.0Bootstrap 5 responsive admin template
documented by Sean Ngu
Updated on: 10/December/2024
By: Sean Ngu
Thank you for purchasing my theme. If you have any questions that are beyond the scope of this help file, please feel free to send your question via ThemeForest. Thanks so much!
Follow the following step to install the django in your localhost
You may refer to their official documentation for how to setup the development environment.
Setup Guide
<!-- run the following command --> cd /your-path-url/template_django python manage.py runserver <!-- browse the url --> http://127.0.0.1:8000/
Make sure python >= 3.10 & node.js has been installed on your localhost / server
File structure overview for Django Version
quantum_django_v2.0/
├──template_django_startup/ // Version without demo pages
└──template_django/ // Version including all demo pages
├── db.sqlite3 // SQLite database file
├── manage.py // Django management script
├── Quantum/ // Django project directory
│ ├── asgi.py // ASGI configuration
│ ├── settings.py // Django settings
│ ├── urls.py // URL routing
│ ├── wsgi.py // WSGI configuration
│ ├── __init__.py // Package initialization
│ ├── __pycache__/ // Cached Python files
│ └── templates/ // HTML templates
└── QuantumApp/ // Django app directory
├── admin.py // Admin configuration
├── apps.py // App configuration
├── models.py // Database models
├── tests.py // Unit tests
├── urls.py // App-specific URL routing
├── views.py // View functions
├── __init__.py // Package initialization
├── __pycache__/ // Cached Python files
├── webpack/ // Webpack build system
│ ├── webpack.app.js // Webpack settings for the application
│ ├── webpack.config.js // Webpack configuration file
│ ├── webpack.vendor.js // Webpack settings for vendor libraries
│ ├── package.json // Node.js package file
│ └── src/ // Source files for Webpack
├── migrations/ // Database migration files
├── static/ // Static files (CSS, JS, images)
│ ├── css
│ ├── data
│ ├── img
│ ├── js
│ ├── plugins
│ └── webfonts
├── utils/ // Utility functions
│ ├── __pycache__/ // Cached Python files
│ └── context_processors.py // Context processors for sidebar array
└── templates/ // App-specific HTML templates
├── base.html // Base template
├── pages/ // Demo pages
└── partial/ // Reusable partial templates
├── footer.html
├── header.html
├── scroll-top-btn.html
├── sidebar.html
├── theme-panel.html
└── top-nav.html
We split the header, sidebar, footer and etc into few other part and include it in the base file. Base file has been located in /template_django/QuantumApp/templates/base.html.
<!DOCTYPE html>
<html lang="en" {% block htmlAttr %}{% endblock %}>
<head>
<meta charset="utf-8">
<title>Quantum | {% block title %}{% endblock %}</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="">
<meta name="author" content="">
<!-- ================== BEGIN core-css ================== -->
{% load static %}
<link href="{% static 'css/vendor.min.css' %}" rel="stylesheet">
<link href="{% static 'css/app.min.css' %}" rel="stylesheet">
<!-- ================== END core-css ================== -->
{% block css %}{% endblock %}
</head>
<body class="{{ bodyClass }}{% if appHeaderHide is not None %} pace-top {% endif %}" {{ bodyAttr }}>
{% include 'partial/loader.html' %}
<div id="app" class="app
{% if appSidebarHide is not None %}app-without-sidebar{% endif %}
{% if appSidebarCollapsed %}app-sidebar-collapsed{% endif %}
{% if appHeaderHide is not None %}app-without-header{% endif %}
{% if appTopNav %}app-with-top-nav{% endif %}
{% if appContentFullHeight is not None %}app-content-full-height{% endif %}
{% if appFooter %}app-footer-fixed{% endif %}
{% if appBoxedLayout %}app-boxed-layout{% endif %}
">
{% if appHeaderHide is None %}
{% include 'partial/header.html' %}
{% endif %}
{% if appSidebarHide is None %}
{% include 'partial/sidebar.html' %}
{% endif %}
{% if appTopNav %}
{% include 'partial/top-nav.html' %}
{% endif %}
<div class="app-content {{ appContentClass }}">
{% block content %}{% endblock %}
</div>
{% include 'partial/theme-panel.html' %}
{% if appFooter %}
{% include 'partial/footer.html' %}
{% endif %}
</div>
{% include 'partial/scroll-top-btn.html' %}
{% block outter_content %}{% endblock %}
<!-- ================== BEGIN core-js ================== -->
<script src="https://code.iconify.design/iconify-icon/2.1.0/iconify-icon.min.js"></script>
<script src="{% static 'js/vendor.min.js' %}"></script>
<script src="{% static 'js/app.min.js' %}"></script>
<!-- ================== END core-js ================== -->
{% block js %}{% endblock %}
</body>
</html>
Below is a list of supported settings that can be used as context variables in views.py.
| Variable | Usage |
|---|---|
"bodyClass": "bg-none" |
Set the css class for <body> tag |
"appSidebarHide": 1 |
Set to exclude the sidebar from the page |
"appSidebarCollapsed": 1 |
Set to collapse the sidebar when page load |
"appHeaderHide": 1 |
Set to exclude the header from the page |
"appTopNav": 1 |
Set to include the top-nav to the page |
"appFooter": 1 |
Set to include the fixed footer to the page |
"appBoxedLayout": 1 |
Set to make the page become boxed layout |
"appContentFullHeight": 1 |
Set to make the page content full height |
"appContentClass": "p-0" |
Set the css class for .app-content |
Using blocks to add title / css / js / outter content by page level.
// example for how to add page title
{% block title %}Dashboard{% endblock %}
// example for how to add page level css
{% block css %}
<link href="{% static 'plugins/photoswipe/dist/photoswipe.css' %}" rel="stylesheet">
...
{% endblock %}
// example for how to add page level js
{% block js %}
<script src="{% static 'plugins/photoswipe/dist/photoswipe-ui-default.min.js' %}"></script>
...
{% endblock %}
// example of how to add content to the outer app-content div
{% block outter_content %}
your content here
...
{% endblock %}
The sidebar menu is generated in /utils/context_processors.py and
rendered globally through /templates/partial/sidebar.html.
Below is an example of the sidebar menu array that can be defined in context_processors.py.
The sidebar menu will automatically be set to active based on the URL name specified in urls.py.
sidebar_menu = [{
'text': 'APP INTERFACE',
'is_header': 1
},{
'url': '/',
'icon': 'ph:rocket-duotone',
'text': 'DASHBOARD',
'name': 'index'
}, {
'icon': 'ph:envelope-duotone',
'text': 'EMAIL',
'children': [{
'url': '/email/inbox',
'action': 'Inbox',
'text': 'INBOX',
'name': 'emailInbox'
}, {
'url': '/email/compose',
'action': 'Compose',
'text': 'COMPOSE',
'name': 'emailCompose'
}, {
'url': '/email/detail',
'action': 'Detail',
'text': 'DETAIL',
'name': 'emailDetail'
}]
}]
All the css files used in Quantum has been compiled into two files app.min.css and vendor.min.css by gulp command. You may change the color scheme from /gulp/src/scss/_variables.scss.
vendor.min.cssapp.min.cssThis theme compiles 5 javascript library into two files app.min.js and vendor.min.js by gulp command.
vendor.min.jsapp.min.jsSidebar collapsed:
def index(request):
context = {
"appSidebarCollapsed": 1
}
return render(request, "pages/index.html", context)
Full height:
def index(request):
context = {
"appContentFullHeight": 1,
"appContentClass": "p-0"
}
return render(request, "pages/index.html", context)
Full width:
def index(request):
context = {
"appContentFullWidth": 1,
"appSidebarHide": 1
}
return render(request, "pages/index.html", context)
Fixed footer:
def index(request):
context = {
"appFooter": 1
}
return render(request, "pages/index.html", context)
Boxed Layout
def index(request):
context = {
"appBoxedLayout": 1,
"bodyClass": "pace-top"
}
return render(request, "pages/index.html", context)
Top Nav
def index(request):
context = {
"appTopNav": 1,
"appSidebarHide": 1
}
return render(request, "pages/index.html", context)
Without Sidebar
def index(request):
context = {
"appSidebarHide": 1
}
return render(request, "pages/index.html", context)
Without Header
def index(request):
context = {
"appHeaderHide": 1
}
return render(request, "pages/index.html", context)
Add the theme class to the <body> tag in order to change the theme color.
<body class="theme-red">...</body> <body class="theme-pink">...</body> <body class="theme-orange">...</body> <body class="theme-yellow">...</body> <body class="theme-lime">...</body> <body class="theme-green">...</body> <body class="theme-teal">...</body> <body class="theme-cyan">...</body> <body class="theme-blue">...</body> <body class="theme-purple">...</body> <body class="theme-indigo">...</body> <body class="theme-black">...</body> <body class="theme-gray-100">...</body> <body class="theme-gray-200">...</body> <body class="theme-gray-300">...</body> <body class="theme-gray-400">...</body> <body class="theme-gray-500">...</body> <body class="theme-gray-600">...</body> <body class="theme-gray-700">...</body> <body class="theme-gray-800">...</body> <body class="theme-gray-900">...</body>
To enable RTL mode, follow these steps:
/QuantumApp/gulp/src/scss/_variables.scss file in your code editor.$enable-rtl variable and change its value to true:
$enable-rtl: true;This will enable RTL mode for your application.
app.min.css file:
npm run buildThis will regenerate the app.min.css file with the changes you made to the
$enable-rtl variable.
Global Variables
The /QuantumApp/gulp/src/scss/_variables.scss file contains the variables that control the styles of your application.
To edit these variables, navigate to the /QuantumApp/gulp/src/scss/_variables.scss file in your code editor and modify the values of the variables to suit your needs.
<!-- global variable --> /QuantumApp/gulp/src/scss/_variables.scss
I've used the following images, icons or other files as listed.
Framework
jQuery Plugins
Photos