Django 进阶 之 自定义Actions

Django的Model的Admin管理页面上一般都有一个删除选中行的下拉框选项，用于批量删除选中的记录

在应用中，只这一项操作往往还不足以更好的使用，需要自定义一些应用于实际情况的批量操作

一、 把Actions方法定义到modelAdmin类外部，可以应用到多个model上

from django.contrib import admin
from .models import Poem,ToDo


'''
modeladmin：是当前的modeladmin
request：是http请求
queryset：是用户所选对象的集合
'''
def print_poem(modeladmin, request, queryset):
    for qs in queryset:
        print(qs)

def set_type_action(modeladmin, request, queryset):
    for qs in queryset:
        qs.type = 2
        qs.save()
set_type_action.short_description='设为宋词'    #给事件添加自定义描述

class PoemModelAdmin(admin.ModelAdmin):
    list_display = ('title','author','type')   #定制显示字段
    list_display_links = ['author',]    #定制点击内容到修改页面的字段
    search_fields = ['title','author']  #定制搜索字段
    list_editable = ['title',]   #定制列表页上可编辑的字段（同一字段不可以是既可链接又可编辑的）
    list_filter = ['author',]   #定制可过滤字段

    # 注册行为操作
    actions = [print_poem, set_type_action]

    class Meta:
        model = Poem


admin.site.register(Poem, PoemModelAdmin)

 

二、 如果Action方法的操作只能应用于某一个Model，则可以把Actions方法放到modelAdmin类中

from django.contrib import admin
from .models import Poem,ToDo

class PoemModelAdmin(admin.ModelAdmin):
    list_display = ('title','author','type')   #定制显示字段
    list_display_links = ['author',]    #定制点击内容到修改页面的字段
    search_fields = ['title','author']  #定制搜索字段
    list_editable = ['title',]   #定制列表页上可编辑的字段（同一字段不可以是既可链接又可编辑的）
    list_filter = ['author',]   #定制可过滤字段

    # 把行为方法定义到类内部中
    def print_poem(self, request, queryset):
        for qs in queryset:
            print(qs)

    def set_type_action(self, request, queryset):
        for qs in queryset:
            qs.type = 2
            qs.save()
        self.message_user(request,'成功更新%d条记录'% len(queryset))

    set_type_action.short_description = '设为宋词'  # 给事件添加自定义描述

    # 注册行为操作
    actions = [print_poem, set_type_action]
    # actions = None  #禁用actions操作，将不显示actions下拉框

    class Meta:
        model = Poem


admin.site.register(Poem, PoemModelAdmin)

 

三、 如果对model进行的操作需要有一个中间页面来判断选择，就像批量删除的那个中间页面那样，可以使用下面的方法

from django import forms
from .models import Poem, AddPdfFileModel

class SetTypeForm(forms.Form):
    type = forms.IntegerField()
    _selected_action = forms.CharField(widget=forms.MultipleHiddenInput) #这个字段是必需的，表示选择了多少项

{% extends 'admin/base_site.html' %}

{% load i18n admin_urls %}

{% block content %}
    <form action="" method="post">{% csrf_token %}
    {{ form.as_p }}
    <ul>
        {% for ob in objects %}
        <li>{{ ob }}</li>
        {% endfor %}
    </ul>
    <!--此项表明要提交的操作是一个action，只对应要提交的action  -->
    <input type="hidden" name="action" value="set_type_action2">
    <!--此项是为了让处理函数识别出是提交过来的-->
    <input type="hidden" name="post" value="yes">
    <input type="submit" value="提交">
    </form>
{% endblock %}

from django.contrib import admin
from .models import Poem,ToDo
from .forms import SetTypeForm

class PoemModelAdmin(admin.ModelAdmin):
    list_display = ('title','author','type')   #定制显示字段
    list_display_links = ['author',]    #定制点击内容到修改页面的字段
    search_fields = ['title','author']  #定制搜索字段
    list_editable = ['title',]   #定制列表页上可编辑的字段（同一字段不可以是既可链接又可编辑的）
    list_filter = ['author',]   #定制可过滤字段

    def set_type_action2(self,request, queryset):
        if request.POST.get('post'):
            form = SetTypeForm(request.POST)
            if form.is_valid():
                type = form.cleaned_data['type']
            for qs in queryset:
                qs.type = type
                qs.save()
            self.message_user(request,'成功更新%d条记录' % len(queryset))
            return None
        else:
            return render(request, 'manage/set_type.html',
                        {'form':SetTypeForm(initial={
                            '_selected_action':request.POST.getlist(admin.ACTION_CHECKBOX_NAME)
                        }), 'objects': queryset})

    set_type_action2.short_description='批量设类型'

    # 注册行为操作
    actions = [print_poem, set_type_action, set_type_action2]
    # actions = None  #禁用actions操作，将不显示actions下拉框

    class Meta:
        model = Poem


admin.site.register(Poem, PoemModelAdmin)

 

四、 自定义全局的Action方法，可以应用于所有的model

def say_hello(modeladmin, request, queryset):
    print('Hello')

admin.site.add_action(say_hello, '全局方法1')

 

五、 全局禁用某个方法

admin.site.disable_action('delete_selected')    #全局禁用某个方法

 

六、 在某个model中不想显示和使用某个全局方法

    #如果在当前model下不想显示全局的某个方法，可使用下面的方式控制
    def get_actions(self, request):
        actions = super(PoemModelAdmin, self).get_actions(request)
        if '全局方法1' in actions:
            del actions['全局方法1']
        return actions