Repository files navigation

django-admin-interface is a modernresponsive flat admin interface customizable by the admin itself.

• Beautiful defaultdjango-theme
• Themes management and customization(you cancustomize admin title, logo and colors)
• Responsive
• Related modal(instead of the old popup window)
• Environment name/marker
• Language chooser
• List filter dropdown
• Foldable apps(accordions in the navigation bar)
• Collapsible fieldsetscan have their initial state expanded instead of collapsed
• List filter sticky
• Form controls sticky(pagination and save/delete buttons)
• Compatibility / style optimizations for:
  • django-ckeditor
  • django-dynamic-raw-id
  • django-json-widget
  • django-modeltranslation
  • django-rangefilter
  • django-streamfield
  • django-tabbed-admin
  • sorl-thumbnail

• Runpip install django-admin-interface
• Addadmin_interface,flat_responsive,flat andcolorfield tosettings.INSTALLED_APPSbeforedjango.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",#...)# only if django version >= 3.0X_FRAME_OPTIONS="SAMEORIGIN"SILENCED_SYSTEM_CHECKS= ["security.W019"]

• Runpython manage.py migrate
• Runpython manage.py collectstatic
• Restart your application server

To make a fieldset start expanded with aHide button to collapse:

fieldsets= [        ("Section title", {"classes": ("collapse","expanded"),"fields": (...),        }),    ]

• Runpip install django-admin-interface --upgrade
• Runpython manage.py migrate(add--fake-initialif you are upgrading from 0.1.0 version)
• Runpython manage.py collectstatic --clear
• Restart your application server

This package ships with optional themes as fixtures, they can be installed using theloaddata admin command. Optional themes are activated on installation.

Runpython manage.py loaddata admin_interface_theme_django.json

Runpython manage.py loaddata admin_interface_theme_bootstrap.json

Runpython manage.py loaddata admin_interface_theme_foundation.json

Runpython manage.py loaddata admin_interface_theme_uswds.json

You can add a theme you've created through the admin to this repository bysending us a PR. Here are the steps to follow to add:

1. Export your exact theme as fixture using thedumpdata admin command:python manage.py dumpdata admin_interface.Theme --indent 4 -o admin_interface_theme_{{name}}.json --pks=N

2. Copy the generated json file into the fixtures folder(making sure its name starts withadmin_interface_theme_to avoid clashes with fixtures that might be provided by other third party apps).

3. Remove thepk from the fixture and make sure theactive field is set totrue(in this way a theme is automatically activated when installed).

4. Edit the section above to document your theme.

You can addtheme support to existing third-party libraries using the followingCSS variables:

• --admin-interface-header-background-color
• --admin-interface-header-text-color
• --admin-interface-header-link-color
• --admin-interface-header-link_hover-color
• --admin-interface-title-color
• --admin-interface-env-color

• --admin-interface-logo-color
• --admin-interface-logo-default-background-image
• --admin-interface-logo-max-width
• --admin-interface-logo-max-height

• --admin-interface-module-background-color
• --admin-interface-module-background-selected-color
• --admin-interface-module-border-radius
• --admin-interface-module-text-color
• --admin-interface-module-link-color
• --admin-interface-module-link-selected-color
• --admin-interface-module-link-hover-color
• --admin-interface-generic-link-color
• --admin-interface-generic-link-hover-color

• --admin-interface-save-button-background-color
• --admin-interface-save-button-background-hover-color
• --admin-interface-save-button-text-color
• --admin-interface-delete-button-background-color
• --admin-interface-delete-button-background-hover-color
• --admin-interface-delete-button-text-color

• --admin-interface-related-modal-background-color
• --admin-interface-related-modal-background-opacity
• --admin-interface-related-modal-border-radius
• --admin-interface-related-modal-close-button-display

I already have a custombase_site.html, how can I make it work?

You can usedjango-apptemplates, then add{% extends "admin_interface:admin/base_site.html" %} to yourbase_site.html

I have enabled theLanguage Chooser, but it is not visible in the admin, what should I do?

You must configure multilanguagesettings andurls correctly:

LANGUAGES= (    ("en",_("English")),    ("it",_("Italiano")),    ("fr",_("Français")),# more than one language is expected here)LANGUAGE_CODE="en"USE_I18N=TrueMIDDLEWARE= [# ..."django.middleware.locale.LocaleMiddleware",# ...]

fromdjango.conf.urls.i18nimporti18n_patternsfromdjango.contribimportadminfromdjango.urlsimportinclude,path# ...urlpatterns= [path("i18n/",include("django.conf.urls.i18n")),]urlpatterns+=i18n_patterns(path("admin/",admin.site.urls))

# clone repositorygit clone https://github.com/fabiocaccamo/django-admin-interface.git&&cd django-admin-interface# create virtualenv and activate itpython -m venv venv&&. venv/bin/activate# upgrade pippython -m pip install --upgrade pip# install requirementspip install -r requirements.txt -r requirements-test.txt# run teststox# orpython setup.pytest# orpython -m djangotest --settings"tests.settings"

Released underMIT License.

• ⭐ Star this project onGitHub
• Follow me onGitHub
• 💙 Follow me onTwitter
• 💰 Sponsor me onGithub

• django-colorfield - simple color field for models with a nice color-picker in the admin. 🎨

• django-extra-settings - config and manage typed extra settings using just the django admin. ⚙️

• django-maintenance-mode - shows a 503 error page when maintenance-mode is on. 🚧 🛠️

• django-redirects - redirects with full control. ↪️

• django-treenode - probably the best abstract model / admin for your tree based stuff. 🌳

• python-benedict - dict subclass with keylist/keypath support, I/O shortcuts (base64, csv, json, pickle, plist, query-string, toml, xml, yaml) and many utilities. 📘

• python-codicefiscale - encode/decode Italian fiscal codes - codifica/decodifica del Codice Fiscale. 🇮🇹 💳

• python-fontbro - friendly font operations. 🧢

• python-fsutil - file-system utilities for lazy devs. 🧟‍♂️