Django mixin to easily add urls to any ModelAdmin
Project description
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() 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 the button if in add mode |
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 |
||||
Development |
||||
Project home page: |
||||
Issue tracker: |
https://github.com/saxix/django-admin-extra-urls/issues?sort |
|||
Download: |
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.