django-admin-interface
django-admin-interface is a modern responsive flat admin interface customizable by the admin itself .
Features
- Beautiful default django-theme
- Themes management and customization (you can customize admin title, logo and colors )
- Responsive
- List filter dropdown (optional)
-
NEW
Related modal (instead of the old popup window, optional) -
NEW
Environment name/marker -
NEW
Language chooser -
Compatibility / Style optimizations for:
-
django-ckeditor
-
django-dynamic-raw-id
-
django-modeltranslation
-
django-tabbed-admin
-
sorl-thumbnail
-
Requirements
- Python 2.7, 3.4, 3.5, 3.6, 3.7, 3.8
- Django 1.7, 1.8, 1.9, 1.10, 1.11, 2.0, 2.1, 2.2, 3.0
Installation
-
Run
pip install django-admin-interface
-
Add
admin_interface
,flat_responsive
,flat
andcolorfield
tosettings.INSTALLED_APPS
beforedjango.contrib.admin
INSTALLED_APPS = (
#...
'admin_interface',
'flat_responsive', # only if django version < 2.0
'flat', # only if django version < 1.9
'colorfield',
#...
'django.contrib.admin',
#...
)
-
Run
python manage.py migrate
-
Run
python manage.py collectstatic
- Restart your application server
Upgrade
-
Run
pip install django-admin-interface --upgrade
-
Run
python manage.py migrate
(add--fake-initial
if you are upgrading from 0.1.0 version) -
Run
python manage.py collectstatic --clear
- Restart your application server
Optional themes
This package ships with optional themes as fixtures, they can be installed using the loaddata admin command . Optional themes are activated on installation.
Django theme (default):
Run
python manage.py loaddata admin_interface_theme_django.json
Bootstrap theme:
Run
python manage.py loaddata admin_interface_theme_bootstrap.json
Foundation theme:
Run
python manage.py loaddata admin_interface_theme_foundation.json
U.S. Web Design Standards theme:
Run
python manage.py loaddata admin_interface_theme_uswds.json
Add more themes
You can add a theme you've created through the admin to this repository by sending us a PR . Here are the steps to follow to add :
-
Export your exact theme as fixture using the
dumpdata
admin command:python manage.py dumpdata admin_interface.Theme --indent 4 -o admin_interface_theme_{{name}}.json --pks=N
-
Copy the generated json file into the fixtures folder (making sure its name starts with
admin_interface_theme_
to avoid clashes with fixtures that might be provided by other third party apps) . -
Remove the
"pk"
from the fixture and make sure theactive
field is set totrue
(in this way a theme is automatically activated when installed) . -
Edit the section above to document your theme.
Screenshots
Admin login
Admin dashboard
Admin themes management
Admin theme customization
FAQ
-
base_site.html
, how can I make it work?
You can use
django-apptemplates
, then add
{% extends "admin_interface:admin/base_site.html" %}
to your
base_site.html
License
Released under MIT License .