Django Inline Actions 使用教程

Django Inline Actions 使用教程

django-inline-actions django-inline-actions adds actions to each row of the ModelAdmin or InlineModelAdmin. 项目地址: https://gitcode.com/gh_mirrors/dj/django-inline-actions

1. 项目介绍

Django Inline Actions 是一个开源的 Django 扩展，它可以为 Django 管理界面中的 ModelAdmin 或 InlineModelAdmin 的每一行添加操作按钮。这个扩展使得在 Django 管理后台进行行内操作变得更加方便和直观，无需离开当前页面即可执行如查看、删除等操作。

2. 项目快速启动

首先，确保你的环境中安装了 Django，并且版本至少为 3.6.1。

安装

通过 pip 安装 django-inline-actions：

pip install django-inline-actions

集成

1. 将 inline_actions 添加到你的 INSTALLED_APPS 中：

INSTALLED_APPS = [
    # ...
    'inline_actions',
    # ...
]

2. 在你的 ModelAdmin 或 InlineModelAdmin 中添加 InlineActionsModelAdminMixin 或 InlineActionsMixin。

from inline_actions.admin import InlineActionsModelAdminMixin, InlineActionsMixin

class MyModelAdmin(InlineActionsModelAdminMixin, admin.ModelAdmin):
    # 你的 ModelAdmin 配置...

class MyInline(InlineActionsMixin, admin.TabularInline):
    # 你的 InlineModelAdmin 配置...

3. 定义你的操作方法，并添加到 inline_actions 属性中。

class MyModelAdmin(InlineActionsModelAdminMixin, admin.ModelAdmin):
    inline_actions = ['my_custom_action']

    def my_custom_action(self, request, obj, parent_obj=None):
        # 执行你的操作...
        return HttpResponse("操作完成")

4. 如果需要，可以重写 get_inline_actions 方法来动态添加操作。

使用

在管理界面中，相应的操作按钮将会显示在每行数据的旁边，点击后即可执行定义好的操作。

3. 应用案例和最佳实践

案例一：新闻应用

假设你有一个新闻应用，包含文章和作者模型。在作者的管理页面中，你可能想要对每篇文章进行查看或撤销发布操作。

1. 定义 ArticleInline 并继承 InlineActionsMixin。
2. 在 ArticleInline 中添加所需的操作方法。
3. 在 AuthorAdmin 中注册 ArticleInline。

案例二：状态切换操作

如果文章具有发布和草稿两种状态，你可以定义一个切换操作，根据当前状态在发布和草稿之间切换。

1. 在 ArticleInline 中定义 toggle_publish 方法。
2. 根据文章状态动态添加该操作到 inline_actions。
3. 可以通过重写 get ACTIONNAME_label 方法为不同状态提供不同的操作标签。

4. 典型生态项目

目前没有明确指出与 django-inline-actions 相关的典型生态项目。不过，任何使用 Django 管理界面并需要行内操作功能的项目都可能成为该扩展的生态项目。例如，具有复杂管理需求的内容管理系统、在线教育平台或者电子商务网站等。

django-inline-actions django-inline-actions adds actions to each row of the ModelAdmin or InlineModelAdmin. 项目地址: https://gitcode.com/gh_mirrors/dj/django-inline-actions