Skip to main content

Custom ordering for the apps and models in the admin app.

Project description

=============================
django-modeladmin-reorder
=============================

Features
--------

* Reorder apps in admin index — this will allow you to position most used apps in top of the page, instead of listing apps alphabetically. e.g. ``sites`` app before the ``auth`` app

* Rename app labels easily for third party apps without having to modify the source code. e.g. rename ``auth`` app to ``Authorisation`` for the django admin app.

* Reorder models within an app. e.g. ``auth.User`` model before the ``auth.Group`` model.

* Exclude any of the models from the app list. e.g. Exclude ``auth.Group`` from the app list. Please note this only excludes the model from the app list and it doesn't protect it from access via url.

* Cross link models from multiple apps. e.g. Add ``sites.Site`` model to the ``auth`` app.

* Rename individual models in the app list. e.g. rename ``auth.User`` from ``User`` to ``Staff``


Documentation
-------------

The full documentation is at https://django-modeladmin-reorder.readthedocs.org.


Install
----------

Install django-modeladmin-reorder::

pip install django-modeladmin-reorder


Configuration
----------

1. Add `admin_reorder` to `INSTALLED_APPS`::

INSTALLED_APPS = (
...
'admin_reorder',
...
)

2. Add the `ModelAdminReorder` to `MIDDLEWARE_CLASSES`::

MIDDLEWARE_CLASSES = (
...
'admin_reorder.middleware.ModelAdminReorder',
...
)


3. Add the setting `ADMIN_REORDER` to your settings.py::


ADMIN_REORDER = (
# Keep original label and models
'sites',

# Rename app
{'app': 'auth', 'label': 'Authorisation'},

# Reorder app models
{'app': 'auth', 'models': ('auth.User', 'auth.Group')},

# Exclude models
{'app': 'auth', 'models': ('auth.User', )},

# Cross-linked models
{'app': 'auth', 'models': ('auth.User', 'sites.Site')},

# models with custom name
{'app': 'auth', 'models': (
'auth.Group',
{'model': 'auth.User', 'label': 'Staff'},
)},
)


History
-------

0.1.0 (2014-08-01)
++++++++++++++++++

* First release on PyPI.

Project details


Download files

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

Files for django-modeladmin-reorder, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size django-modeladmin-reorder-0.1.0.tar.gz (6.5 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page