{"id":7162,"library":"django-admin-interface","title":"Django Admin Interface","description":"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.","status":"active","version":"0.32.0","language":"en","source_language":"en","source_url":"https://github.com/fabiocaccamo/django-admin-interface","tags":["django","admin","interface","theme","ui","customization"],"install":[{"cmd":"pip install django-admin-interface","lang":"bash","label":"Install stable version"}],"dependencies":[{"reason":"Core framework dependency, it's an admin interface for Django.","package":"Django","optional":false},{"reason":"Required for theme customization features.","package":"django-colorfield","optional":false}],"imports":[{"note":"Both 'admin_interface' and 'colorfield' must be placed BEFORE 'django.contrib.admin' in INSTALLED_APPS for themes and styling to apply correctly.","wrong":"INSTALLED_APPS = [\n    'django.contrib.admin',\n    'admin_interface',\n    'colorfield',\n    # ... other apps\n]","symbol":"admin_interface","correct":"INSTALLED_APPS = [\n    'admin_interface',\n    'colorfield',\n    'django.contrib.admin',\n    # ... other apps\n]"},{"note":"Required in settings.py for modals to function instead of traditional popups.","symbol":"X_FRAME_OPTIONS","correct":"X_FRAME_OPTIONS = 'SAMEORIGIN'"}],"quickstart":{"code":"import os\n\n# Assuming you have a basic Django project setup\n# settings.py\n# Add to INSTALLED_APPS, ensuring order is correct:\nINSTALLED_APPS = [\n    'admin_interface',\n    'colorfield',\n    'django.contrib.admin',\n    'django.contrib.auth',\n    'django.contrib.contenttypes',\n    'django.contrib.sessions',\n    'django.contrib.messages',\n    'django.contrib.staticfiles',\n    # Your other apps\n]\n\n# Add X_FRAME_OPTIONS for modal functionality\nX_FRAME_OPTIONS = 'SAMEORIGIN'\n\n# Terminal commands (execute in your project's root directory):\n# pip install django-admin-interface\n# python manage.py migrate\n# python manage.py collectstatic --clear --noinput\n# python manage.py createsuperuser # if you don't have an admin user\n# python manage.py runserver\n\n# Then navigate to http://127.0.0.1:8000/admin/","lang":"python","description":"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."},"warnings":[{"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`.","message":"Version 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.","severity":"breaking","affected_versions":">=0.29.0"},{"fix":"Reorder `INSTALLED_APPS` in your `settings.py`:\nINSTALLED_APPS = [\n    'admin_interface',\n    'colorfield',\n    'django.contrib.admin',\n    # ... rest of your apps\n]","message":"For 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.","severity":"gotcha","affected_versions":"All"},{"fix":"Add `X_FRAME_OPTIONS = 'SAMEORIGIN'` to your `settings.py` file.","message":"If 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`.","severity":"gotcha","affected_versions":"All"},{"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`.","message":"In production environments, the Django admin interface may appear unstyled (missing CSS) if static files are not collected and served correctly.","severity":"gotcha","affected_versions":"All"}],"env_vars":null,"last_verified":"2026-04-16T00:00:00.000Z","next_check":"2026-07-15T00:00:00.000Z","problems":[{"fix":"Add 'admin_interface' and 'colorfield' to your `INSTALLED_APPS` list in `settings.py`, ensuring they are placed before 'django.contrib.admin'.","cause":"The 'admin_interface' app is not correctly added to `INSTALLED_APPS` in your `settings.py` or is misspelled.","error":"ModuleNotFoundError: No module named 'admin_interface'"},{"fix":"Run `python manage.py collectstatic --clear --noinput` and ensure your web server configuration correctly serves static files from `STATIC_ROOT`. Clear your browser cache.","cause":"Static files for the admin interface have not been collected or your web server is not configured to serve them.","error":"My Django admin looks unstyled / has no CSS in production."},{"fix":"Add `X_FRAME_OPTIONS = 'SAMEORIGIN'` to your `settings.py` file.","cause":"`X_FRAME_OPTIONS` is not set to 'SAMEORIGIN' in your Django settings, preventing the modal behavior.","error":"Related object links open new browser popups instead of modals in the admin."},{"fix":"Ensure your app (e.g., `'my_app'`) is listed in `INSTALLED_APPS` and that `django.contrib.admin` is also present. Make sure to restart your Django development server after changes.","cause":"The Django application containing the models has not been added to `INSTALLED_APPS` in `settings.py`, or `django.contrib.admin` itself is missing.","error":"Newly created apps/models are not showing up in the Django admin index after adding them."}]}