admin-extra-urls

pluggable django application that offers one single mixin class ExtraUrlMixin to easily add new url (and related buttons on the screen) to any ModelAdmin.

It provides two decorators link() and action().

  • link() is intended to be used for multiple records. It will produce a button in the change list view.
  • action() works on a single record. It will produce a button in the change form view.

Install

pip install admin-extra-urls

After installation add it to INSTALLED_APPS

INSTALLED_APPS = (
    ...
    'admin_extra_urls',
)

How to use it

class MyModelModelAdmin(ExtraUrlMixin, admin.ModelAdmin):

    @link() # /admin/myapp/mymodel/update_all/
    def update_all(self, request):
        ...
        ...


    @action() # /admin/myapp/mymodel/update/10/
    def update(self, request, pk):
        ...
        ...

You don't need to return a HttpResponse. The default behavior is:

  • with link() browser will be redirected to changelist_view
  • with action() browser will be redirected to change_view

More options

@link(label='Update', icon="icon-refresh icon-white", permission='model_change", order=-1)
def update_all(self, request):
        ....

Note

The package contains a UploadMixin to manage custom file uploads (simply set upload_handler to a function. This can be checked to see how to create wizard with an intermediate form.

Links

Stable master-build master-cov  
Development dev-build dev-cov  
Project home page: https://github.com/saxix/django-admin-extra-urls
Issue tracker: https://github.com/saxix/django-admin-extra-urls/issues?sort
Download: http://pypi.python.org/pypi/django-admin-extra-urls/
Wheel Status