django-admin-508

django-admin-508 is a modern responsive django admin interface.


Keywords
django, admin, interface, responsive, flat, theme, custom, ui
License
MIT
Install
pip install django-admin-508==0.2.2

Documentation

django-admin-508

django-admin-508 is a responsive interface that aims to be accessible to the 508 Standard.

Features

Installation

  • Run pip install django-admin-508
  • Add admin_interface, flat_responsive, flat and colorfield to settings.INSTALLED_APPS before django.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.0
X_FRAME_OPTIONS = 'SAMEORIGIN'
SILENCED_SYSTEM_CHECKS = ['security.W019']
  • Run python manage.py migrate
  • Restart your application server

Upgrade

  • Run pip install django-admin-508 --upgrade
  • Restart your application server

Publishing Updates

https://packaging.python.org/tutorials/packaging-projects/ https://realpython.com/installable-django-app/

python3 -m pip install --upgrade build
python3 -m build


python3 -m pip install --upgrade twine
python3 -m twine upload --repository testpypi dist/*
python3 -m venv env
source env/bin/activate
pip install -r requirements.txt
python makemigrations.py

In da508

  • clear the dist dir
  • increment version
  • build
  • twine upload

In TDRS

  • backend: dc up
  • docker compose run web python -m pipenv install django-admin-508==0.0.8

local development

  • create empty django project
  • create venv
  • build package in another directory
  • pip install -e /path/to/508
  • migrate

License

Released under MIT License.

See also

This project started out as a fork of the excellent Django Admin Interface.