Wagtail 4.1中模型无法通过wagtail_hooks.py显示在后台的求助

使用Wagtail 4.1版本，已按文档操作，但Book模型未显示在后台管理面板中，相关配置如下：

模型代码（models.py） #

class Book(models.Model):
    title = models.CharField(max_length=255)
    author = models.CharField(max_length=255)
    cover_photo = models.ForeignKey(
        'wagtailimages.Image',
        null=True, blank=True,
        on_delete=models.SET_NULL,
        related_name='+'
    )

panels = [
    FieldPanel('title'),
    FieldPanel('author'),
    FieldPanel('cover_photo')
]

wagtail_hooks.py代码 #

class BookAdmin(ModelAdmin):
    model = Book
    menu_label = 'Book'  # ditch this to use verbose_name_plural from model
    menu_icon = 'pilcrow'  # change as required
    menu_order = 201  # will put in 3rd place (000 being 1st, 100 2nd)
    add_to_settings_menu = True  # or True to add your model to the Settings sub-menu
    exclude_from_explorer = True # or True to exclude pages of this type from Wagtail's explorer view
    list_display = ('title', 'author')
    list_filter = ('author',)
    search_fields = ('title', 'author')


# Now you just need to register your customised ModelAdmin class with Wagtail
modeladmin_register(BookAdmin)

INSTALLED_APPS配置 #

INSTALLED_APPS = [
    ...
    "news",
    "app",
    "wagtail.contrib.modeladmin",
]

请问可能遗漏了什么配置？

• 检查wagtail_hooks.py的位置：该文件必须放在你注册的app（比如app或news）的根目录下，与models.py、views.py同级，否则Wagtail无法加载这个钩子。
• 修正模型panels配置：你的Book是普通Django Model（非Wagtail Page子类），模型本身定义的panels无效，需要将配置移到BookAdmin类中，示例如下：

  from wagtail.admin.panels import FieldPanel, TabbedInterface, ObjectList
  
  class BookAdmin(ModelAdmin):
      model = Book
      # 新增编辑面板配置
      edit_handler = TabbedInterface([
          ObjectList([
              FieldPanel('title'),
              FieldPanel('author'),
              FieldPanel('cover_photo'),
          ], heading='Book Details'),
      ])
      # 其余原有配置不变...
  

  或者更简单的方式直接指定字段：fields = ('title', 'author', 'cover_photo')
• 确认菜单位置：你设置了add_to_settings_menu = True，这个配置会把Book模型放到后台的**设置（Settings）**子菜单里，而非主菜单。如果想放在主菜单，将该参数改为False。
• 验证用户权限：登录后台的用户必须拥有Book模型的查看权限。进入「Settings > Groups」，找到当前用户所在的组，确保勾选了对应权限（例如app | book | can view book）。
• 确认模型迁移完成：运行python manage.py makemigrations和python manage.py migrate，确保Book模型对应的数据库表已创建。
• 检查导入语句：确认wagtail_hooks.py中导入了必要模块：

  from wagtail.contrib.modeladmin.options import ModelAdmin, modeladmin_register
  from .models import Book
  

内容的提问来源于stack exchange，提问作者Mr. ksen