Django Admin自定义list_display方法的list_filter配置问题

Django Admin 的list_filter默认仅支持直接使用模型字段，自定义方法（如你写的get_language）无法直接作为过滤项；而直接使用language字段时，会显示默认的布尔值文本（yes/no），不符合你的显示需求。解决方法是自定义一个过滤器类，具体实现如下：

完整代码示例 #

from django.contrib import admin
from .models import Movie  # 建议明确导入模型，避免使用import *

class LanguageFilter(admin.SimpleListFilter):
    # 过滤器在Admin侧边栏显示的标题
    title = 'Language'
    # 对应模型中的字段名，用于URL传递过滤参数
    parameter_name = 'language'

    def lookups(self, request, model_admin):
        # 返回过滤器选项：(数据库存储值, 页面显示文本)
        return (
            (1, 'Persian With English Subtitle'),
            (0, 'Persian'),
        )

    def queryset(self, request, queryset):
        # 根据选中的选项筛选查询集
        if self.value() is not None:
            return queryset.filter(language=int(self.value()))
        return queryset

class MovieAdminModel(admin.ModelAdmin):
    search_fields = ('title_en',)  # 注意添加逗号，确保是元组类型
    list_display = ('get_language',)
    list_filter = (LanguageFilter,)  # 使用自定义过滤器

    def get_language(self, obj):
        if obj.language == 1:
            return 'Persian With English Subtitle'
        else:
            return 'Persian'
        
    get_language.admin_order_field = "language"
    get_language.short_description = "Language"

admin.site.register(Movie, MovieAdminModel)

代码说明 #

1. 自定义过滤器类LanguageFilter：

   • 继承自admin.SimpleListFilter，必须实现title、parameter_name、lookups、queryset四个核心部分；
   • lookups方法定义过滤器的显示选项，将数据库中的数值（1/0）映射为你需要的文本；
   • queryset方法根据用户选中的选项，对模型查询集进行筛选。

2. 修正原代码的细节问题：

   • search_fields和list_filter必须是元组类型，原代码中('title_en')会被解析为字符串，添加逗号后('title_en',)才是正确的元组格式；
   • 替换import *为明确的模型导入，提升代码可读性并避免命名冲突。

内容的提问来源于stack exchange，提问作者user892134