Installation

Using pip

1. Install the last available version:

   pip install django-baton
   

2. Add baton and baton.autodiscover to your INSTALLED_APPS:

   INSTALLED_APPS = (
       # ...
       'baton',
       'django.contrib.admin',
       # ... (place baton.autodiscover at the very end)
       'baton.autodiscover',
   )
   

Important

baton must be placed before django.contrib.admin and baton.autodiscover as the last app.

3. Run migrations:

   $ python manage.py migrate
   

4. Replace django.contrib.admin in your project urls, and add baton urls:

   from baton.autodiscover import admin
   from django.urls import path, include
   
   urlpatterns = [
       path('admin/', admin.site.urls),
       path('baton/', include('baton.urls')),
   
   ]
   

Why two installed apps?

The first baton has to be placed before the django.contrib.admin app, because it overrides 3 templates and resets all css. The baton.autodiscover entry is needed as the last installed app in order to register all applications for the admin. I decided to create a custom AdminSite class, in order to allow the customization of some variables the django way (site_header, index_title, …). I think this is a good approach, better than customizing this vars overwriting the orignal templates. The problem is that when creating a custom AdminSite, you should register manually all the apps. I didn’t like this, so I wrote this autodiscover module, which automatically registers all the apps already registered with the django default AdminSite. In order to do this, all the apps must be already registered, so it comes as the last installed app.