Wagtail教程：构建无URL或重定向的组织性页面

from django.db import models
from django.shortcuts import redirect
from django.http import Http404

from wagtail.models import Page
from wagtail.admin.panels import FieldPanel, MultiFieldPanel, ObjectList, TabbedInterface
from wagtail.snippets.widgets import SlugInput # 假设你有这个自定义widget，否则用default
from wagtail.admin.panels import PublishingPanel # Wagtail 4.0+，旧版本可能是 PublishingPanel
from wagtail.admin.forms import WagtailAdminPageForm # 假设你有这个自定义form

# 假设你有一个BasePage，如果没有，可以直接继承Page
# class BasePage(Page):
#    ...
#    pass

# 一个简单的表单，用于设置 show_in_menus 默认值
class ShowInMenusByDefaultForm(WagtailAdminPageForm):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        if not self.instance.pk: # Only set default for new pages
            if 'show_in_menus' in self.fields:
                self.fields['show_in_menus'].initial = True

class MenuOnlyPage(Page): # 如果有BasePage，则继承BasePage
    """
    此页面类型纯粹用于作为其他页面的父级。它没有自己的内容，
    并且在菜单中的行为也不同。

    MenuOnlyPages 不会像普通页面那样工作，如果被浏览，它们总是重定向到 /。
    """

    # 可选：限制此页面类型的实例数量
    max_count = 10 # 示例：允许创建最多10个MenuOnlyPage实例
    # 可选：限制此页面的父页面类型
    # parent_page_types = ['home.HomePage']
    # 可选：限制此页面的子页面类型
    # subpage_types = ['news.ArticlePage', 'products.ProductListingPage']

    ###################
    # 编辑表单配置
    ###################
    # 清空内容面板，因为此页面没有实际内容
    content_panels = Page.content_panels + []

    # 自定义设置面板，只保留必要的页面设置
    settings_panels = [
        MultiFieldPanel(
            heading='页面设置',
            children=[
                FieldPanel('slug', widget=SlugInput), # 如果SlugInput是自定义的，请替换为默认的FieldPanel('slug')
                FieldPanel('seo_title'), # 添加SEO标题
                FieldPanel('search_description'), # 添加搜索描述
                FieldPanel('show_in_menus'), # 控制是否在菜单中显示
            ]
        )
    ]

    publishing_panels = [
        PublishingPanel()
    ]

    # 自定义编辑处理器，只显示必要的面板
    edit_handler = TabbedInterface(
        base_form_class=ShowInMenusByDefaultForm, # 使用自定义表单，设置show_in_menus默认值
        children=[
            ObjectList(content_panels, heading='内容'),
            ObjectList(settings_panels, heading='设置', classname='settings'),
            ObjectList(publishing_panels, heading='发布'),
        ]
    )

    # 此页面不应出现在搜索索引中。
    search_fields = []

    # 这是一个自定义属性，供模板代码用于检测 MenuOnlyPage。
    # 由于只有模板代码关心这种区别，这是最简单的方法。
    menu_only = models.BooleanField(default=True, editable=False) # 标记为仅菜单页，不可编辑

    class Meta:
        verbose_name = '仅菜单页面'
        verbose_name_plural = '仅菜单页面'

    def get_sitemap_urls(self, request=None):
        """
        将所有 MenuOnlyPage 从 XML Sitemap 中排除。
        """
        return []

    @property
    def preview_modes(self):
        """
        禁用 MenuOnlyPage 的预览，因为它们没有任何内容可供预览。
        """
        return []

    @property
    def is_linkable(self):
        """
        我们的面包屑模板使用此属性来判断是否应为此页面创建链接。
        """
        return False

    def serve(self, request, *args, **kwargs):
        """
        MenuOnlyPages 不会像普通页面那样工作，如果被浏览，它们总是重定向到首页。
        """
        # 为了避免在用户意外访问此页面时，浏览器缓存一个永久重定向，
        # 我们不使用301永久重定向，而是使用302临时重定向。
        response = redirect('/')
        # 如果有缓存控制，可以添加
        # return self.add_cache_control_headers(response)
        return response

    # 如果需要返回404而不是重定向，可以这样实现serve方法：
    # def serve(self, request, *args, **kwargs):
    #     raise Http404("此页面仅用于组织目的，不提供独立内容。")