django-admin-extra-urls 4.1.1

安装

pip install django-admin-extra-urls

安装后将其添加到INSTALLED_APPS

INSTALLED_APPS = (
    ...
    'admin_extra_urls',
)

如何使用它

from admin_extra_urls.api import url, button, link, href

class MyModelModelAdmin(extras.ExtraUrlMixin, admin.ModelAdmin):

    @link(label='Search On Google', 'http://www.google.com?q={target}') # /admin/myapp/mymodel/update_all/
    def search_on_google(self, button):
        # this is called by the template engine just before rendering the button
        # `context` is the Context instance in the template
        if 'original' in button.context:
            obj = button.context['original']
            return {'target': obj.name}
        else:
            button.visible = False

    @link()
    def search_on_bing(self, button):
        return 'http://www.bing.com?q=target'


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

    @button() # /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(request, pk)
        ...

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


    @button(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', )

如果用button装饰的方法的返回值是HttpResponse，则将使用该返回值。否则，如果方法包含pk参数，则用户将被重定向到“更新”视图，否则浏览器将重定向到管理员的列表视图

button()选项

这些是button()接受的参数

与其他库的集成

django-import-export

@admin.register(Rule)
class RuleAdmin(ExtraUrlMixin, ImportExportMixin, BaseModelAdmin):
    @button(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)

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

在本地运行项目测试

使用 pip install -e '.[dev]' 安装开发依赖项，然后运行tox。

链接