Wagtail自定义图片模型后台显示普通select，如何恢复默认模态框？

我按照Wagtail官方文档创建了带署名功能的自定义图片模型，已设置配置项：

WAGTAILIMAGES_IMAGE_MODEL = 'my_images.CustomImage'

但未修改页面模型中的图片字段定义，当前页面模型（models.py）代码如下：

from django.db import models
from modelcluster.fields import ParentalKey
from wagtail.admin.panels import FieldPanel

from wagtail.models import Page
from people_and_places.models import Person

class HomePage(Page):
    image = models.ForeignKey(
        'wagtailimages.Image', on_delete=models.SET_NULL, related_name='+', null=True, blank=True,
    )
    contact = models.ForeignKey(
        Person, on_delete=models.SET_NULL, null=True, blank=True,
        verbose_name="Some Person", help_text="Just testing the ChooserWidget"
    )

    content_panels = Page.content_panels + [
                FieldPanel('image'),
                FieldPanel('contact'),
    ]

图片管理页面功能正常，但后台编辑页面时，图片字段被渲染为普通HTML下拉选择框，而非默认的Wagtail图片选择模态框。我尝试自定义ChooserViewSet但未解决问题，相关代码如下：

尝试的自定义ChooserViewSet代码 #

Image应用的views.py #

from wagtail.admin.viewsets.chooser import ChooserViewSet

class MyImageChooserViewSet(ChooserViewSet):
    model = "images.ImageWithCopyright"
    icon = "user"
    choose_one_text = "Choose an image"
    choose_another_text = "Choose another image"
    edit_item_text = "Edit this image"
    form_fields = ["image", "copyright"]  # fields to show in the "Create" tab

my_image_chooser_viewset = MyImageChooserViewSet("my_image_chooser")

wagtail_hooks.py #

from wagtail import hooks

from .views import my_image_chooser_viewset

@hooks.register("register_admin_viewset")
def register_viewset():
    return my_image_chooser_viewset

请问使用自定义图片模型时，如何以最简洁的Python风格保留标准Wagtail图片模态框的所有功能？怎么将当前的下拉选择框替换为默认的图片选择模态框？

问题根源是页面模型的图片字段仍引用原生wagtailimages.Image，而非你的自定义图片模型；且自定义ChooserViewSet完全没必要——Wagtail会自动为自定义图片模型适配默认选择器，无需额外注册。

只需两步解决：

1. 修改页面模型的图片字段引用
   将字段中的'wagtailimages.Image'替换为你的自定义图片模型路径，示例：

image = models.ForeignKey(
    'my_images.CustomImage', on_delete=models.SET_NULL, related_name='+', null=True, blank=True,
)

2. 移除冗余的ChooserViewSet代码
   删除你写的MyImageChooserViewSet类以及wagtail_hooks.py中的注册代码——Wagtail会自动为自定义图片模型启用默认的图片选择模态框，不需要额外配置。

修改完成后重启服务，后台页面的图片字段就会恢复为默认的模态框选择器，同时保留自定义模型的署名功能。

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