Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Django admin toolbox - bunch of improvements for default django admin

Project description

This package provides bunch of useful tools for default django admin site, such as:

All configuration is held in ADMIN_TOOLBOX dict that should be placed in your settings.py file.

Warning

This package is still in development and all API is considered unstable. This means that anything may change without notice and without backwards compatibility!

Installation

  1. Install admin toolbox (if not installed already)
  2. add admin_toolbox at the top of your INSTALLED_APPS (at least above django.contrib.admin)

Configuration

All configuration of this application is held in one dictionary in django settings, named ADMIN_TOOLBOX. Below you can see default configuration:

ADMIN_TOOLBOX = {
    'sidebar': {
        'default': ('admin_toolbox.builders.AppsListBuilder', {}),
    },
    'breadcrumbs': 'auto',
}

If you want to customize any setting, you don’t have to copy whole defaults. Anything that is not set, will be filled in with default values.

Below you can find description of how to configure each module.

Smart Breadcrumbs

This module gives you ability to rewrite default admin breadcrumbs to match structure defined with admin menu. Generation of smart breadcrumbs requires beautifulsoup4 library, which you can install by installing django-admin-toolbox[smart-breadcrumbs].

You can enable or disable this feature, by using 'breadcrumbs' in settings dict. Allowed values are:

  • None - Disables breadcrumbs alltogether. This option will hide default breadcrumbs generated by Django.
  • 'auto' - Breadcrumbs will be automatically enabled if beautifulsoup4 is available. Otherwise, default django admin breadcrumbs will be used.
  • 'auto-smart' - Breadcrumbs will be automatically enabled if beautifulsoup4 is available. Otherwise, no breadcrumbs will be used.
  • 'smart' - Breadcrumbs will be explicitly enabled. This option will trigger exception if beautifulsoup4 is not installed
  • 'force-smart' - Similar to 'smart', but breadcrumbs will be also visible on pages, where they don’t exist in default django admin.

Project details


Download files

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

Files for django-admin-toolbox, version 1.0.0.dev26
Filename, size File type Python version Upload date Hashes
Filename, size django_admin_toolbox-1.0.0.dev26-py2.py3-none-any.whl (1.8 MB) File type Wheel Python version py2.py3 Upload date Hashes View hashes
Filename, size django-admin-toolbox-1.0.0.dev26.tar.gz (1.8 MB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page