Quick start guide¶
Before installing django-admin-tools, you’ll need to have a copy of Django already installed. For the 0.5 release, Django 1.3 or newer is required.
django-admin-tools requires Django version 1.3 or superior, optionally, if you want to display feed modules, you’ll also need the Universal Feed Parser module.
There are several ways to install django-admin-tools, this is explained in the installation section.
easy_install -Z django-admin-tools
Note that the
-Z flag is required, to tell
easy_install not to
create a zipped package; zipped packages prevent certain features of
Django from working properly.
pip install django-admin-tools
For a more detailed guide on how to configure django-admin-tools, please consult the configuration section.
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.
First make sure you have the
template context processor in your
Then, add admin_tools and its 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... )
it is very important that you put the admin_tools modules before
django.contrib.admin module, because django-admin-tools
overrides the default Django admin templates, and this will not work
Then, just add django-admin-tools to your urls.py file:
urlpatterns = patterns('', url(r'^admin_tools/', include('admin_tools.urls')), #...other url patterns... )
Finally simply run:
python manage.py syncdb
If you have South installed, make sure you run the following commands:
python manage.py migrate admin_tools.dashboard python manage.py migrate admin_tools.menu
Testing your new shiny admin interface¶
Congrats! At this point you should have a working installation of django-admin-tools. Now you can just login to your admin site and see what changed.
django-admin-tools is fully customizable, but this is out of the scope of this quickstart. To learn how to customize django-admin-tools modules please read the customization section.