Installation

This package can be installed using pip:

pip install django-fluent-dashboard

This should automatically install django-admin-tools as well.

Django configuration

To enable the dashboard in Django, both the fluent_dashboard and the admin_tools modules have to be added to settings.py:

INSTALLED_APPS += (
    'fluent_dashboard',

    'admin_tools',
    'admin_tools.theming',
    'admin_tools.menu',
    'admin_tools.dashboard',
    'django.contrib.admin',
)

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': (),
        'OPTIONS': {
            'loaders': (
                ...
                'admin_tools.template_loaders.Loader',  # Add this line!
            ),
        }
    }
]

Note

The admin_tools.theming and admin_tools.menu applications are optional.

Next, the django-admin-tools can be configured to use the fluent_dashboard instead, by using:

ADMIN_TOOLS_INDEX_DASHBOARD = 'fluent_dashboard.dashboard.FluentIndexDashboard'
ADMIN_TOOLS_APP_INDEX_DASHBOARD = 'fluent_dashboard.dashboard.FluentAppIndexDashboard'
ADMIN_TOOLS_MENU = 'fluent_dashboard.menu.FluentMenu'

That’s all! The Django admin dashboard should open now with the dashboard, configured with sane defaults.

Next:

  • The application groups and icons can be customized with additional configuration.
  • The Memcache and Varnish statistics can also be displayed by configuring some optional dependencies.