Once installed, you can add django-admin-tools to any Django-based project you’re developing.
django-admin-tools is composed of several modules:
In order to use django-admin-tools you obviously need to have configured your django admin site, if you didn’t, please refer to the relevant django documentation.
Required settings¶First make sure you have the django.core.context_processors.request
template context processor in your TEMPLATE_CONTEXT_PROCESSORS
or TEMPLATES
settings variable
Then add the admin_tools.template_loaders.Loader
template loader to your TEMPLATE_LOADERS
or TEMPLATES
settings variable.
Note
Starting from django 1.8, TEMPLATE_CONTEXT_PROCESSORS
and TEMPLATE_LOADERS
are deprecated, they are replaced by the TEMPLATES
variable, please refer to the relevant django documentation.
Note
Windows users: due to filename restrictions on windows platforms, you have to put the admin_tools.template_loaders.Loader
at the very begining of the list in your TEMPLATES
or TEMPLATE_LOADERS
settings variable.
Then, add the django-admin-tools modules to the INSTALLED_APPS
like this:
INSTALLED_APPS = ( 'admin_tools', 'admin_tools.theming', 'admin_tools.menu', 'admin_tools.dashboard', 'django.contrib.auth', 'django.contrib.sites', 'django.contrib.admin' # ...other installed applications... )
Note
it is very important that you put the admin_tools modules before the django.contrib.admin module
, because django-admin-tools overrides the default django admin templates, and this will not work otherwise.
django-admin-tools is modular, so if you want to disable a particular module, just remove or comment it in your INSTALLED_APPS
. For example, if you just want to use the dashboard:
INSTALLED_APPS = ( 'admin_tools', 'admin_tools.dashboard', 'django.contrib.auth', 'django.contrib.sites', 'django.contrib.admin' # ...other installed applications... )Setting up the database¶
To set up the tables that django-admin-tools uses you’ll need to type:
Adding django-admin-tools to your urls.py file¶You’ll need to add django-admin-tools to your urls.py file:
urlpatterns = patterns('', url(r'^admin_tools/', include('admin_tools.urls')), #...other url patterns... )Collecting the Static Files¶
To collect static files run:
python manage.py collectstatic
Important
it is very important that django.contrib.staticfiles.finders.AppDirectoriesFinder'' be there in your ``STATICFILES_FINDERS
.
ADMIN_TOOLS_MENU
ADMIN_TOOLS_INDEX_DASHBOARD
ADMIN_TOOLS_APP_INDEX_DASHBOARD
ADMIN_TOOLS_THEMING_CSS
The path to your theming css stylesheet, relative to your STATIC_URL, for example:
ADMIN_TOOLS_THEMING_CSS = 'css/theming.css'
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4