Modern theme for Django admin interface.
Django Suit is alternative theme/skin/extension for Django administration interface.
You can get Django Suit by using pip or easy_install:
pip install django-suit
# or
easy_install django-suit
You will need to add the 'suit' application to the INSTALLED_APPS setting of your Django project settings.py file.:
INSTALLED_APPS = (
...
'suit',
'django.contrib.admin',
)
Warning
'suit' must be added before 'django.contrib.admin'
You also need to add 'django.core.context_processors.request' to TEMPLATE_CONTEXT_PROCESSORS setting in your Django project settings.py file.:
from django.conf.global_settings import TEMPLATE_CONTEXT_PROCESSORS as TCP
TEMPLATE_CONTEXT_PROCESSORS = TCP + (
'django.core.context_processors.request',
)
Note: This is required to handle left side menu. If by some reason you removed original Django Suit menu.html, you can skip this.
Deployment with Django Suit should not be different than any other Django application. If you have problems with deployment on production, read Django docs on wsgi first.
Note
If you deploy your project with Apache or Debug=False don’t forget to run ./manage.py collectstatic
You can customize Django Suit behaviour by adding SUIT_CONFIG configuration variable to your Django project settings.py file.
You must extend base_site.html template to customize footer links, copyright text or to add extra JS/CSS files. Example file is available on github.
Copy customized base_site.html template file to your project’s main application template/admin/ directory and un-comment and edit the blocks you would like to extend.
Alternatively you can copy base_site.html to any of template directories, which are defined in TEMPLATE_DIRS setting (if any). By default Django looks in every registered application templates/ dir.
In the same way you can override any of Django Suit admin templates. More about customizing project’s templates, you can read in Django Admin Tutorial
There are handy widgets included in Django Suit.
Sortables are handy admin tools for ordering different lists.
Besides documentation examples, Django Suit demo application source code is also available on separate github repository: django-suit-examples. If you see anything in demo application, you can always go to this repository and see implementation and code in one of models.py or admin.py files
There will be separate “django-suit-contrib” package available soon with full Django project setup and tests. However if you already are willing to fork, report a bug or suggest a feature, you can do it in our main github repository.