A Bootstrap template for Django Admin
Project description
Django Stisla is a Bootstrap 4 based admin template for Django admin interface developed using the stisla free bootstrap admin template.
Installation
Install the package from PyPi:
pip install django-stisla
Quick start
Add “django_stisla.apps.admin” and “widget_tweaks” with “django.contrib.admin” & “django.contrib.auth” to your INSTALLED_APPS setting like this:
INSTALLED_APPS = [ ... 'django_stisla', 'django.contrib.admin', 'django.contrib.auth', ... 'widget_tweaks' ]
Make sure django.template.context_processors.request is enabled in project settings.py:
TEMPLATES = [ { 'BACKEND': 'django.template.backends.django.DjangoTemplates', 'DIRS': [], 'APP_DIRS': True, 'OPTIONS': { 'context_processors': [ ... 'django.template.context_processors.request', ... ], }, }, ]
Include the admin URLconf in your project urls.py like this:
... from django_stisla import admin ... urlpatterns = [ ... path('admin/', admin.site.urls), ... ]
You can set following theme configurations in URLconf:
... admin.site.site_header = "Django administration" admin.site.site_title = "Django site admin" admin.site.index_title = "Site administration" admin.site.site_short_title = "DJ" ...
Start the development server and visit http://127.0.0.1:8000/admin/ to see your newly installed Django Stisla for admin.
Admin Model Registration
To register your models in Django admin, please import “from django_stisla.admin” in your applications admin.py and register your models as follows:
... from django_stisla.admin import site ... ... site.register(Image) site.register(Author) site.register(Topic) ...
Theme Customizations
To set logo/title in admin login page, please create templates/admin/login.html file in your application and use the following code:
{% extends "admin/login.html" %} {% block login-brand %} <div class="login-brand"> <h1>Django Administration</h1> </div> {% endblock %}
To add extra CSS to dashboard theme, create static/admin/assets/css/extra.css file in your app. For example you can customize Font-awesome icons in the sidebar menu as follows based on your loaded apps in django:
/* Custom font awesome icon for django auth app */ .fa-auth:before { content: "\f023"; } /* Custom font awesome icon for an app name cms */ .fa-cms:before { content: "\f0ad"; } /* Custom font awesome icon for an app name order */ .fa-order:before { content: "\f07b"; }
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.