Skip to main content

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

Project description

Build Status codecov Code Health PyPI version PyPI downloads Py versions License

django-admin-interface

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

django-admin-interface_preview

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

  • 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

  • Django 1.7, 1.8, 1.9, 1.10, 1.11, 2.0, 2.1, 2.2

Installation

  • Run pip install django-admin-interface

  • Add admin_interface, flat_responsive (only if django version < 2.0), flat (only if django version < 1.9) and colorfield to settings.INSTALLED_APPS before 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:

1. 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

2. 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).

3. Remove the pk from the fixture and make sure the active field is set to true (in this way a theme is automatically activated when installed).

  1. Edit the section above to document your theme.

Screenshots

Admin login

django-admin-interface_login

Admin dashboard

django-admin-interface_dashboard

Admin themes management

django-admin-interface_themes_management

Admin theme customization

django-admin-interface_theme_customization

FAQ

I already have a custom 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.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-admin-interface-0.10.5.tar.gz (147.6 kB view details)

Uploaded Source

File details

Details for the file django-admin-interface-0.10.5.tar.gz.

File metadata

File hashes

Hashes for django-admin-interface-0.10.5.tar.gz
Algorithm Hash digest
SHA256 b9f0dfdb6df954c04fae80a2183b3d528f0b83263fc55f34bfb33e27fd8ee90e
MD5 1e8edc14f648f986e5fb146c8fb35d9f
BLAKE2b-256 4c44eb7ca870db9d42167cbb16624edb4fd72958ae6f5d0d7e89b0386a262e83

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page