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.