django-admin-extra-urls 3.2

Install

pip install django-admin-extra-urls

After installation add it to INSTALLED_APPS

INSTALLED_APPS = (
    ...
    'admin_extra_urls',
)

How to use it

from admin_extra_urls import api as extras

class MyModelModelAdmin(extras.ExtraUrlMixin, admin.ModelAdmin):
    extra_buttons = [extras.ChangeFormButton('/{original.pk}/'),]
    actions = ['smart_action']

    @extras.action() # /admin/myapp/mymodel/update_all/
    def consolidate(self, request):
        ...
        ...

    @extras.action() # /admin/myapp/mymodel/update/10/
    def update(self, request, pk):
        # if we use `pk` in the args, the button will be in change_form
        obj = self.get_object(pk=pk)
        ...

    @action(urls=[r'^aaa/(?P<pk>.*)/(?P<state>.*)/$',
                  r'^bbb/(?P<pk>.*)/$'])
    def revert(self, request, pk, state=None):
        obj = self.get_object(pk=pk)
        ...


    @extras.action(label='Truncate', permission=lambda request, obj: request.user.is_superuser)
    def truncate(self, request):

        if request.method == 'POST':
            self.model.objects._truncate()
        else:
            return extras._confirm_action(self, request, self.truncate,
                                   'Continuing will erase the entire content of the table.',
                                   'Successfully executed', )

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

• if the method contains the pk argument button will be displayed in the ‘update’ view and the browser will be redirected to change_view

action() options

Integration with other libraries

@admin.register(Rule)
class RuleAdmin(ExtraUrlMixin, ImportExportMixin, BaseModelAdmin):
    @action(label='Export')
    def _export(self, request):
        if '_changelist_filters' in request.GET:
            real_query = QueryDict(request.GET.get('_changelist_filters'))
            request.GET = real_query
        return self.export_action(request)

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