django-grouped-admin-actions 1.0

Improve your admin action dropdown by using option groups.

Description

Improve the usability of your admin action dropdown by using option groups and the action’s docstrings as title tags.

Installation

Install from pypi.org:

pip install django-grouped-admin-actions

Usage

Use the GroupedAdminActionsMixin in your ModelAdmin classes:

from django.contrib import admin
from grouped_admin_actions.admin import GroupedAdminActionsMixin
from .models import YourModel

@admin.register(YourModel)
class YourModelAdmin(GroupedAdminActionsMixin, admin.ModelAdmin):
    actions = [
        'action_one',
        'action_two',
        'action_three',
        ...
    ]

Setup your admin actions with meaningful docstrings and use action groups as decorator:

from grouped_admin_actions.admin import action_group

group_one = ActionGroup("Action 1")
group_two = ActionGroup("Action 2")

@group_one
def action_one(modeladmin, request, queryset):
    """This is action one in group 1."""
    ...

@group_one
def action_two(modeladmin, request, queryset):
    """This is action two in group 1."""
    ...

@group_two
def action_three(modeladmin, request, queryset):
    """This is action three in group 2."""
    ...

Now you get a grouped action dropdown in your dango admin changelist views with the action’s docstring as title tag of each option.