Actions for Django inline admin
Project description
Easy-to-use actions for Django admin inlines
Installation
Install django_inlines_actions
pip install django_inlines_actions
Add inlines_actions to your INSTALLED_APPS.
Add the InlineActionsModelAdminMixin to your ModelAdmin.
Add the InlineActionsMixin to your TabularInline.
Add inline_actions attribute to your TabularInline as a tuple of your actions.
inline_actions = ('your_action_name', 'another_action_name',)
Every action must have following signature:
def your_action_name(self, request, obj, parent_obj):
Usage
Action is basically a link to another url with corresponding view. It does not depends on form as some other solutions and not execute on Enter hit. Action should return None to return to the current changeform or a HttpResponse instance. If you want do disable Actions column set inline_actions to None.
inline_actions = ('change_title',) def change_title(self, request, obj, parent_obj): obj.title = obj.title + ' | ' + parent_obj.name obj.save()
Features
Permissions
Permissions are instance of list/tuple classes and can be either custom function or django built-in permission.
def your_action_name(self, request, obj, parent_obj): pass your_action_name.permissions = ('permission_func_name', 'django_builtin_permission_name',)
permissions function must have following signature:
def permission_func_name(self, request, obj, parent_obj):
Must return False to fail permission check otherwise permission will be passed.
If permissions returns False action will no be rendered for user and action will raise PermissionDenied on execution.
Short Description
Short Description are either custom function or simple string.
def your_action_name(self, request, obj, parent_obj): pass your_action_name.short_description = 'My Uniq Description'
your_action_name.short_description = 'short_description_func_name'
short_description function must have following signature:
def short_description_func_name(self, request, obj, parent_obj):
Css Class
Css Class are either custom function or simple string.
def your_action_name(self, request, obj, parent_obj): pass your_action_name.css_class = 'my-css-class-name'
your_action_name.css_class = 'css_class_func_name'
css_class function must have following signature:
def css_class_func_name(self, request, obj, parent_obj):
Example
from django.contrib import admin
from inlines_actions import InlineActionsModelAdminMixin, InlineActionsMixin
from .models import Article1, Author1
class ArticleInline(
InlineActionsMixin,
admin.TabularInline,
):
model = Article1
inline_actions = ('make_published',)
def make_published(self, request, obj, parent_obj):
obj.is_published = not obj.is_published
obj.save()
def make_published_permission(self, request, obj, parent_obj):
if not request.user.is_superuser:
return False
def make_published_short_description(self, request, obj, parent_obj):
return 'Published Make'
def make_published_css_class(self, request, obj, parent_obj):
return 'some_class'
make_published.permissions = ('make_published_permission', 'example_app:can_change_article')
make_published.short_description = make_published_short_description
make_published.css_class = make_published_css_class
class AuthorAdmin(
InlineActionsModelAdminMixin,
admin.ModelAdmin,
):
inlines = (ArticleInline,)
admin.site.register(Author1, AuthorAdmin)
Tests
pip install requirements.txt tox
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django_inlines_actions-0.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 91661a8c36ab7805bc7630963c0f165ee29e7fe07242f2841a50ffd39da79eaf |
|
MD5 | a7d50f18806f9da1f244a42a65da5b07 |
|
BLAKE2b-256 | 3f7156abe0b317287f36307b47d09c738654e6983a8ad7746f561d10631ec440 |
Hashes for django_inlines_actions-0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ce0b7e3ca9e423dfcdbe4112191026dc99e65d5f7b2468b3ef459087bbc994b4 |
|
MD5 | 44bfacf4472ef05e1e137642bb531ca4 |
|
BLAKE2b-256 | 8574017b7090d6cf2d3e2160e08ac21b89302f105f8987581342d04170665f59 |