https://github.com/ionelmc/django-admin-customizer
Django admin customizing interface
https://github.com/ionelmc/django-admin-customizer
Last synced: about 1 month ago
JSON representation
Django admin customizing interface
- Host: GitHub
- URL: https://github.com/ionelmc/django-admin-customizer
- Owner: ionelmc
- License: bsd-2-clause
- Created: 2012-02-29T20:36:27.000Z (over 13 years ago)
- Default Branch: master
- Last Pushed: 2015-02-25T23:23:52.000Z (over 10 years ago)
- Last Synced: 2025-04-04T04:41:27.915Z (6 months ago)
- Language: Python
- Homepage: https://pypi.python.org/pypi/django-admin-customizer
- Size: 272 KB
- Stars: 36
- Watchers: 5
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
Awesome Lists containing this project
README
===============================
django-admin-customizer
===============================
.. image:: https://secure.travis-ci.org/ionelmc/django-admin-customizer.png
:alt: Build Status
:target: http://travis-ci.org/ionelmc/django-admin-customizer
.. image:: https://coveralls.io/repos/ionelmc/django-admin-customizer/badge.png?branch=master
:alt: Coverage Status
:target: https://coveralls.io/r/ionelmc/django-admin-customizer
.. image:: https://badge.fury.io/py/django-admin-customizer.png
:alt: PYPI Package
:target: https://pypi.python.org/pypi/django-admin-customizer
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``:
.. code-block:: python
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:
.. code-block:: python
(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 /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:
.. image:: https://github.com/downloads/ionelmc/django-admin-customizer/admin-customizer-registered-model-edit-page.png
.. image:: https://d2weczhvl823v0.cloudfront.net/ionelmc/django-admin-customizer/trend.png
:alt: Bitdeli badge
:target: https://bitdeli.com/free