Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Django admin customizing interface

branch: master
README.rst

django-admin-customizer

Build Status Coverage Status PYPI Package

Django admin customizing interface

Features

  • Multiple admin instances for the same model
  • Customization of:
    • list_display
    • list_filter
    • raw_id_fields
    • search_fields

TODO

  • actions configurator
  • base admin class support

Requirements

  • Django 1.3, 1.4, 1.5, 1.6. Django 1.2 or older is NOT supported.
  • Python 2.6 or 2.7

Installation guide

Install from pypi, with pip:

pip install django-admin-customizer

Or with setuptools:

easy_install django-admin-customizer

Add admin_customizer to INSTALLED_APPS:

INSTALLED_APPS += ("admin_customizer", )

Add the admin customizer's urls to your root url conf. This is the url where your will access your custom admin instances. Eg: in your project's urls.py add:

(r'^admin/_/', include('admin_customizer.urls')),

After that you need to run:

manage.py syncdb

Or if you use south:

manage.py syncdb --migrate

You need to update admin_customizer's models to get it working, initially and after each model change with:

manage.py refresh_available_fields

Note:

If you delete models the registered admins will be deleted for them.

If you delete fields from models the registered admins will have them removed after you run refresh_available_fields.

django-admin-customizer has static files for widgets in the edit interface. If you use staticfiles just run:

manage.py collectstatic

If you do not use django.contrib.staticfiles you must manually symlink the site-packages/admin_customizer/static/admin_customizer dir to <your media root>/admin_customizer.

Making extra actions available

TODO

Settings

ADMIN_CUSTOMIZER_MAX_FIELD_DEPTH - depth to look for relations when inspecting models.

Middleware

To enable urlpattern reloading add 'admin_customizer.middleware.URLResolverReloadMiddleware' to MIDDLEWARE_CLASSES.

Warning!

You must have working django cache for this to work properly ! See django's cache documentation on this.

If you do not enable this you will have to restart the webserver after every AdminSite or RegisteredModel change !

Screenshots

Edit page:

https://github.com/downloads/ionelmc/django-admin-customizer/admin-customizer-registered-model-edit-page.pngBitdeli badge
Something went wrong with that request. Please try again.