django-adminplus 0.2.0

Installing AdminPlus

Grab AdminPlus from github with pip:

pip install -e git://github.com/jsocol/django-adminplus#egg=django-adminplus

And add adminplus to your installed apps:

INSTALLED_APPS = (
    # ...
    'adminplus',
    # ...
)

To use AdminPlus in your Django project, you’ll need to replace django.contrib.admin.site, which is an instance of django.contrib.admin.sites.AdminSite. I recommend doing this in urls.py right before calling admin.autodiscover():

# urls.py
from django.contrib import admin
from adminplus.sites import AdminSitePlus

admin.site = AdminSitePlus()
admin.autodiscover()

urlpatterns = patterns('',
    # ...
    # Include the admin URL conf as normal.
    (r'^admin', include(admin.site.urls)),
    # ...
)

Congratulations! You’re now using AdminPlus.

Using AdminPlus

So now that you’ve installed AdminPlus, you’ll want to use it. AdminPlus is 100% compatible with the built in admin module, so if you’ve been using that, you shouldn’t have to change anything.

AdminPlus offers a new function, admin.site.register_view, to attach arbitrary views to the admin:

# someapp/admin.py
# Assuming you've replaced django.contrib.admin.site as above.
from django.contrib import admin

def my_view(request, *args, **kwargs):
    pass
admin.site.register_view('somepath', my_view)

# And of course, this still works:
from someapp.models import MyModel
admin.site.register(MyModel)

Now my_view will be accessible at admin/somepath and there will be a link to it in the Custom Views section of the admin index.

register_view takes some optional arguments:

• name: a friendly name for display in the list of custom views. For example:

  def my_view(request):
      """Does something fancy!"""
  admin.site.register_view('somepath', my_view, 'My Fancy Admin View!')

• urlname: give a name to the urlpattern so it can be called by redirect(), reverse(), etc.

• visible: a boolean that defines if the custom view is visible in the admin dashboard.

All registered views are wrapped in admin.site.admin_view.