自定义 Admin 操作

在 Django 中，Admin 站点是一个非常强大的工具，它允许开发者快速管理数据库中的数据。然而，有时默认的 Admin 功能可能无法满足特定的需求。这时，我们可以通过自定义 Admin 操作来扩展 Admin 站点的功能。

1. 什么是 Admin 操作？

Admin 操作是指在 Django Admin 站点中，用户可以对选中的对象执行的批量操作。例如，你可以创建一个操作，允许管理员一键删除选中的所有对象，或者将它们标记为已读。

2. 如何创建自定义 Admin 操作？

要创建自定义 Admin 操作，你需要在 Admin 类中定义一个函数，并将其添加到 actions 列表中。

2.1 定义操作函数

首先，你需要定义一个函数，该函数将作为你的自定义操作。这个函数通常接受三个参数：

• modeladmin：当前的 Admin 类实例。
• request：当前的 HTTP 请求对象。
• queryset：选中的对象的查询集。

def make_published(modeladmin, request, queryset):
    queryset.update(status='published')
make_published.short_description = "Mark selected stories as published"

在这个例子中，我们定义了一个名为 make_published 的操作，它将选中的对象的状态更新为 published。我们还为这个操作添加了一个简短的描述，这个描述将显示在 Admin 站点的操作列表中。

2.2 将操作添加到 Admin 类

接下来，你需要将这个操作添加到 Admin 类的 actions 列表中。

from django.contrib import admin
from .models import Story

class StoryAdmin(admin.ModelAdmin):
    list_display = ['title', 'status']
    actions = [make_published]

admin.site.register(Story, StoryAdmin)

在这个例子中，我们将 make_published 操作添加到了 StoryAdmin 类的 actions 列表中。这样，当管理员在 Admin 站点中选中多个 Story 对象时，他们就可以选择这个操作来批量更新这些对象的状态。

3. 实践练习

现在，让我们通过一个简单的练习来巩固所学内容。

3.1 创建模型

首先，创建一个简单的模型 Book，包含 title 和 is_available 字段。

from django.db import models

class Book(models.Model):
    title = models.CharField(max_length=100)
    is_available = models.BooleanField(default=False)

    def __str__(self):
        return self.title

3.2 创建自定义操作

接下来，创建一个自定义操作 make_available，它将选中的书籍标记为可用。

def make_available(modeladmin, request, queryset):
    queryset.update(is_available=True)
make_available.short_description = "Mark selected books as available"

3.3 注册 Admin 类

最后，将这个操作添加到 BookAdmin 类中，并注册到 Admin 站点。

from django.contrib import admin
from .models import Book

class BookAdmin(admin.ModelAdmin):
    list_display = ['title', 'is_available']
    actions = [make_available]

admin.site.register(Book, BookAdmin)

3.4 测试操作

启动 Django 开发服务器，访问 Admin 站点，创建一些 Book 对象，然后尝试使用 make_available 操作来批量更新这些书籍的状态。

4. 总结

通过自定义 Admin 操作，你可以极大地扩展 Django Admin 站点的功能，使其更符合你的业务需求。希望这篇教程能帮助你理解如何创建和使用自定义 Admin 操作。

在接下来的课程中，我们将继续探讨 Django 的其他高级功能，如 Admin 主题和样式定制、权限和分组管理等。敬请期待！