Registry / web-framework / django-admin-interface

django-admin-interface

library0.32.0pypypiunverified

django-admin-interface is a Python package that provides a modern, responsive, and highly customizable administration interface for Django projects. It enhances the default Django admin with features like theme management, popup windows replaced by modals, sticky changelist actions, and improved styling. The current version is 0.32.0, and it maintains an active release cadence with regular updates for new Django and Python versions.

web-framework database

pip install django-admin-interface

github ↗package ↗docs ↗

INSTALL

IMPORT

SIG · DJANGO-ADMIN-INTER

django-admin-interface

web-frameworkpythonv0.32.0

Install

2.3s avg

Import

—

Disk

38MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.32.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.920 runs

installs and imports cleanly · install 0.0s · import 0.000s · 39.5MB

glibc

py 3.10–3.920 runs

installs and imports cleanly · install 2.3s · import 0.000s · 40MB

38MB installed

● package 38MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

admin_interface

✓ INSTALLED_APPS = [ 'admin_interface', 'colorfield', 'django.contrib.admin', # ... other apps ]

✗ INSTALLED_APPS = [ 'django.contrib.admin', 'admin_interface', 'colorfield', # ... other apps ]

Both 'admin_interface' and 'colorfield' must be placed BEFORE 'django.contrib.admin' in INSTALLED_APPS for themes and styling to apply correctly.

X_FRAME_OPTIONS

✓ X_FRAME_OPTIONS = 'SAMEORIGIN'

Required in settings.py for modals to function instead of traditional popups.

Install the package, add `admin_interface` and `colorfield` to your `INSTALLED_APPS` (crucially, before `django.contrib.admin`), configure `X_FRAME_OPTIONS`, and run migrations and collectstatic to apply the changes.

import os # Assuming you have a basic Django project setup # settings.py # Add to INSTALLED_APPS, ensuring order is correct: INSTALLED_APPS = [ 'admin_interface', 'colorfield', 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.messages', 'django.contrib.staticfiles', # Your other apps ] # Add X_FRAME_OPTIONS for modal functionality X_FRAME_OPTIONS = 'SAMEORIGIN' # Terminal commands (execute in your project's root directory): # pip install django-admin-interface # python manage.py migrate # python manage.py collectstatic --clear --noinput # python manage.py createsuperuser # if you don't have an admin user # python manage.py runserver # Then navigate to http://127.0.0.1:8000/admin/

Debug

Known issues

breakingVersion 0.29.0 dropped support for Python 3.8, Python 3.9, and Django 3.x. Projects on these older versions must upgrade their Python/Django environment or use an older version of django-admin-interface.

fix

Upgrade your Python environment to 3.10+ and Django to 4.x+ (Django 6.0 and Python 3.14 are supported in 0.32.0), or pin `django-admin-interface<0.29.0`.

affects: >=0.29.0

gotchaFor themes and styling to apply correctly, 'admin_interface' and 'colorfield' MUST be listed before 'django.contrib.admin' in your `settings.INSTALLED_APPS`. Incorrect order will result in default Django admin styling.

fix

Reorder `INSTALLED_APPS` in your `settings.py`:
INSTALLED_APPS = [
    'admin_interface',
    'colorfield',
    'django.contrib.admin',
    # ... rest of your apps
]

affects: All

gotchaIf admin modals (e.g., for related objects) are not working and old popup windows are still appearing, you likely need to set `X_FRAME_OPTIONS` to 'SAMEORIGIN' in your `settings.py`.

fix

Add `X_FRAME_OPTIONS = 'SAMEORIGIN'` to your `settings.py` file.

affects: All

gotchaIn production environments, the Django admin interface may appear unstyled (missing CSS) if static files are not collected and served correctly.

fix

Ensure you run `python manage.py collectstatic --clear --noinput` during deployment and configure your web server (e.g., Nginx, Apache) to serve the static files from `STATIC_ROOT`.

affects: All

Upgrade

Version history

0.32.0latest on PyPI · released Dec 19, 2025

Audit

Dependencies

DjangorequiredCore framework dependency, it's an admin interface for Django.

django-colorfieldrequiredRequired for theme customization features.

Agent activity

5 hits · last 30 days

node

Resources

githubhttps://github.com/fabiocaccamo/django-admin-interface#readme ↗

packagehttps://pypi.org/project/django-admin-interface/ ↗

docshttps://github.com/fabiocaccamo/django-admin-interface#readme ↗