Skip to main content

Django admin theme based adminlte & bootstrap

Project description

Django jazzmin (Jazzy Admin)

Drop-in theme for django admin, that utilises AdminLTE & Bootstrap to make yo’ admin looky jazzy

This was initially a Fork of https://github.com/wuyue92tree/django-adminlte-ui that I refactored so much I thought it deserved its own package, big thanks to @wuyue92tree for all of his initial hard work, I am still patching into that project were possible, but this project is taking a slightly different direction.

Installation

pip install django-jazzmin

Setup & configuration

# settings.py

INSTALLED_APPS = [
    # Place before admin
    'jazzmin',
    'django.contrib.admin',
    [...]
]


JAZZMIN_SETTINGS = {
    # Choose from black, black-light, blue, blue-light, green, green-light, purple, purple-light,
    # red, red-light, yellow, yellow-light
    'skin': 'blue',

    # title of the window
    'site_title': 'Django Admin',

    # Title on the login screen
    'site_header': 'Django',

    # square logo to use for your site, must be present in static files, used for favicon and brand on top left
    'site_logo': 'admin/dist/img/default-log.svg',

    # Welcome text on the login screen
    'welcome_sign': 'Welcome',

    # Copyright on the footer
    'copyright': 'Acme Ltd',

    # Wether to aut expand the menu
    'navigation_expanded': True,

    # The model admin to search from the search bar, search bar omitted if excluded
    'search_model': 'profiles.Profile',

    # Field name on user model that contains avatar image
    'user_avatar': 'avatar',

    # Hide these apps when generating menu
    'hide_apps': ['auth'],

    # Hide these models when generating menu
    'hide_models': ['auth.user'],

    # List of apps to base menu ordering off of
    'order_with_respect_to': ['first_app', 'second_app'],

    # Custom links to append to app groups, keyed on app name
    'custom_links': {
        'first_app': [
            {'name': 'Custom link', 'url': '/', 'icon': 'fa-user', 'permissions': []}
        ]
    },

    'icons': {
        'auth': 'fa-people',
        'auth.user': 'fa-user',
    }
}

Screenshots

See https://github.com/farridav/django-jazzmin

Thanks

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-jazzmin-1.0.1.tar.gz (1.2 MB view hashes)

Uploaded Source

Built Distribution

django_jazzmin-1.0.1-py2.py3-none-any.whl (1.4 MB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page