Django Admin Black

Modern template for Django admin interface coded on top of Black Dashboard (free version) from Creative-Tim

Originally coded by Iman Karimi, actively versioned and supported by AppSeed via Github (issues tracker) and Discord - 24/7 LIVE Service.

Links & Resources

• Django Black Dashboard - Open-source starter that uses the same UI Kit
• Django Black Dashboard - DEMO - LIVE Deployment

Why Django Admin Black?

• UI Kit: Black Dashboard (Free version) provided by Creative-Tim
• New fresh look
• Responsive mobile interface
• Useful admin home page
• Minimal template overriding
• Support RTL and LTR template
• Easy integration

Installation

$ pip install git+https://github.com/app-generator/django-admin-black.git
$ # or
$ easy_install git+https://github.com/app-generator/django-admin-black.git

• Add 'admin_black' application to the INSTALLED_APPS setting of your Django project settings.py file (note it should be before 'django.contrib.admin'):

    INSTALLED_APPS = (
        ...
        'admin_black.apps.AdminBlackConfig',
        'django.contrib.admin',
    )

• All programs you add in INSTALLED_APPS should look like this: APP_NAME.apps.APP_NAMEConfig.

In this feature, we considered that each App can have its own icon, so we ask users to use this feature according to the method. Also in apps.py of each program according to the example add the icon field in the corresponding class. You can go here to use more icons

    from django.apps import AppConfig

    class APP_NAMEConfig(AppConfig):
        name = 'APP_NAME'
        icon = 'ICON_CLASS'  # for example: icon = 'tim-icons icon-atom'

• Make sure django.template.context_processors.request context processor is enabled in settings.py (Django 1.8+ way):

    TEMPLATES = [
        {
            'BACKEND': 'django.template.backends.django.DjangoTemplates',
            'DIRS': [],
            'APP_DIRS': True,
            'OPTIONS': {
                'context_processors': [
                    ...
                    'django.template.context_processors.request',
                    ...
                ],
            },
        },
    ]

⚠️ Warning!!

• Before Django 1.8 you should specify context processors different way. Also use django.core.context_processors.request instead of django.template.context_processors.request.

    from django.conf import global_settings

    TEMPLATE_CONTEXT_PROCESSORS = global_settings.TEMPLATE_CONTEXT_PROCESSORS + (
        'django.core.context_processors.request',
    )

• Create database tables:

$ python manage.py migrate admin_black
$ # or
$ python manage.py syncdb

• Collect static if you are in production environment:

$ python manage.py collectstatic

• Clear your browser cache

Screenshots

---

Django Admin Black - Provided by AppSeed