Installation

Install the package from PyPi:

pip install django-stisla

Quick start

1. 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'
   ]

2. 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',
                   ...
               ],
           },
       },
   ]

3. Include the admin URLconf in your project urls.py like this:

   ...
   from django_stisla import admin
   ...
   urlpatterns = [
       ...
       path('admin/', admin.site.urls),
       ...
   ]

4. 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"
   ...

5. 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";
}