Single mixin class to easily add buttons on any Django ModelAdmin related page
Clone or download
Latest commit 209b50e Sep 3, 2018
Permalink
Failed to load latest commit information.
src bump version Sep 3, 2018
tests code clean Sep 3, 2018
.gitignore django 1.9 support Dec 17, 2015
.travis.yml bump version Sep 3, 2018
CHANGES code clean Sep 3, 2018
LICENSE python 3 compatibility Oct 18, 2014
MANIFEST.in code clean Feb 1, 2018
Makefile updates Makefile Feb 1, 2018
README.rst Fixed broken download url Mar 13, 2018
setup.cfg django 1.9 support Dec 17, 2015
setup.py updates setup.py Feb 1, 2018
tox.ini bump version Sep 3, 2018

README.rst

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

from admin_extra_urls.extras import ExtraUrlMixin, link, action

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):
        obj = self.get_object(pk=pk)
        ...

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

  • with link() button is displayed in the 'list' view and the browser will be redirected to changelist_view
  • with action() button is displayed in the 'update' view and the browser will be redirected to change_view

link() / action() options

path None path url path for the action. will be the url where the button will point to.
label None label for the button. by default the "labelized" function name
icon '' icon for the button
permission None permission required to use the button. Can be a callable (current object as argument).
css_class "btn btn-success" extra css classes to use for the button
order 999 in case of multiple button the order to use
visible lambda o: o and o.pk callable or bool. By default do not display "action" button if in add mode

Integration with other libraries

django-import-export

@admin.register(Rule)
class RuleAdmin(ExtraUrlMixin, ImportExportMixin, BaseModelAdmin):
    @link(label='Export')
    def _export(self, request):
        return self.export_action(request)

    @link(label='Import')
    def _import(self, request):
        return self.import_action(request)

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/admin-extra-urls/