如何为特定块的Document选择器设置过滤规则仅展示CSV文档

你原本的思路是完全符合Wagtail扩展逻辑的，可以正常运行，属于官方推荐的选择器自定义过滤路径。同时还有一种更轻量的落地方案，不需要修改前端JS代码，实现成本更低。

直接通过重写文档选择器控件的接口请求地址注入自定义参数，配合查询集钩子实现过滤，全程只需要写Python代码：

• 第一步：自定义CSV专属的文档选择器块和控件

from wagtail.documents.widgets import AdminDocumentChooser
from wagtail.documents.blocks import DocumentChooserBlock

# 自定义选择器控件，给请求地址加过滤参数
class CSVAdminDocumentChooser(AdminDocumentChooser):
    def get_choose_url(self):
        base_url = super().get_choose_url()
        # 给选择器接口添加专属的过滤标记参数
        return f"{base_url}?only_csv=1"

# 自定义CSV文档选择器块，直接在你的StreamBlock中引用即可
class CSVDocumentChooserBlock(DocumentChooserBlock):
    widget = CSVAdminDocumentChooser

• 第二步：添加查询集过滤钩子

from wagtail.documents.signals import construct_document_chooser_queryset
from django.dispatch import receiver

@receiver(construct_document_chooser_queryset)
def filter_csv_documents(sender, request, queryset, **kwargs):
    # 只有携带自定义参数的请求才会被过滤，不影响其他位置的选择器
    if request.GET.get("only_csv") == "1":
        # 用iendswith忽略大小写，同时匹配.CSV和.csv后缀
        queryset = queryset.filter(file__iendswith=".csv")
    return queryset

• 上述轻量方案：实现成本极低，不需要动前端代码，完全兼容Wagtail的原生扩展规范，适合绝大多数场景
• 你原本的修改JS传参方案：兼容性更强，适合有特殊自定义需求、需要在前端侧做更多选择器逻辑改造的场景，本身也是合理可落地的

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