Wagtail中如何阻止编辑者删除静态页面？求最优实现方案

页面分类与权限规则 #

我们开发的站点包含两类页面：

• 静态页面：首页（Home）、联系页（Contact）、关于页（About us）、总目录页、总博客页等，必须始终保持发布状态且不可删除，仅允许编辑现有内容
• 动态页面：目录下的各分类、博客条目，允许编辑者创建、编辑、删除

针对编辑者的权限规则：

• 仅能编辑现有静态页面
• 可自由创建、编辑、删除目录与博客的子页面
• 静态页面的删除操作仅能由管理层、设计师及开发者共同决策后，通过发布新版本执行，编辑者无此权限

当前尝试的方案及局限 #

1. 限制静态页面创建 #

通过设置max_count = 1或编辑器组权限控制，防止创建多余静态页面，但Wagtail暂不支持min_count或min_published_count属性，无法从底层保证静态页面不被删除。

2. 拦截delete()方法 #

考虑过重写模型的delete()方法，但该方式无法阻止批量删除，属于临时 workaround，可靠性不足。

3. Wagtail Hooks 方案 #

尝试通过钩子隐藏部分操作按钮，但存在明显缺陷：
代码示例：

# wagtail_hooks.py
from wagtail import hooks

@hooks.register('construct_page_action_menu')
def remove_disabled_actions(menu_items, request, context):
    specific_page = context["page"].specific
    if not specific_page.is_submitable:
        menu_items[:] = [item for item in menu_items if item.name != 'action-submit']
    if not specific_page.is_unpublishable:
        menu_items[:] = [item for item in menu_items if item.name != 'action-unpublish']

@hooks.register('construct_page_listing_buttons')
def remove_page_listing_button_item(buttons, page, page_perms, context=None):
    specific_page = page.specific
    if not specific_page.show_more_dropdown_in_list_actions:
        buttons.pop() # 移除包含删除选项的"更多"下拉菜单

# models.py
class BasePage(Page):
    # 省略字段定义
    
    is_submitable = False
    is_unpublishable = False
    # 隐藏列表视图的"更多"下拉菜单，同时移除其中的删除选项
    show_more_dropdown_in_list_actions = False

方案局限

• 无法移除列表视图的批量操作按钮，也无法自定义批量操作选项
• 无法移除页面编辑视图面包屑旁三点菜单中的"删除""取消发布"选项
• 仅隐藏操作入口，未从权限层面彻底拦截操作，存在绕过风险

推荐的简洁可靠实现方案 #

1. 权限层面拦截：自定义PagePermissionPolicy #

通过自定义页面权限策略，直接拒绝编辑者对静态页面的删除、取消发布操作：

# permissions.py
from wagtail.core.permission_policies import PagePermissionPolicy
from wagtail.core.models import Page
# 导入你的静态页面模型
from .models import HomePage, ContactPage, AboutPage, MainCatalogPage, MainBlogPage

class StaticPagePermissionPolicy(PagePermissionPolicy):
    def user_has_permission(self, user, action, page=None):
        # 针对静态页面模型，限制删除/取消发布权限
        if page and page.specific_class in [HomePage, ContactPage, AboutPage, MainCatalogPage, MainBlogPage]:
            if action in ['delete', 'unpublish']:
                # 仅允许超级管理员或开发者组用户执行
                return user.is_superuser or user.groups.filter(name='Developers').exists()
        # 其他情况沿用默认权限逻辑
        return super().user_has_permission(user, action, page)

# 在wagtail_hooks.py中注册自定义权限策略
from wagtail import hooks

@hooks.register('register_page_permission_policy')
def register_static_page_permission_policy():
    return StaticPagePermissionPolicy(Page)

2. 全场景隐藏操作入口：补充钩子覆盖遗漏场景 #

结合已有钩子，新增以下代码处理所有操作入口：

# wagtail_hooks.py
from wagtail import hooks
from wagtail.admin.widgets import PageListingButton
# 导入你的静态页面模型
from .models import HomePage, ContactPage, AboutPage, MainCatalogPage, MainBlogPage

@hooks.register('construct_page_listing_buttons')
def remove_static_page_buttons(buttons, page, page_perms, context=None):
    specific_page = page.specific
    if specific_page.__class__ in [HomePage, ContactPage, AboutPage, MainCatalogPage, MainBlogPage]:
        # 移除删除、取消发布按钮及"更多"下拉菜单
        buttons[:] = [
            btn for btn in buttons 
            if not (isinstance(btn, PageListingButton) and btn.name in ['delete', 'unpublish'])
            and not hasattr(btn, 'dropdown_items')
        ]

@hooks.register('construct_page_action_menu')
def remove_static_page_actions(menu_items, request, context):
    specific_page = context["page"].specific
    if specific_page.__class__ in [HomePage, ContactPage, AboutPage, MainCatalogPage, MainBlogPage]:
        # 移除删除、取消发布、提交审核等危险操作
        menu_items[:] = [
            item for item in menu_items 
            if item.name not in ['action-delete', 'action-unpublish', 'action-submit']
        ]

# 处理面包屑旁的三点菜单
@hooks.register('construct_settings_menu')
def remove_static_page_settings_actions(menu_items, request, context):
    if 'page' in context:
        specific_page = context['page'].specific
        if specific_page.__class__ in [HomePage, ContactPage, AboutPage, MainCatalogPage, MainBlogPage]:
            menu_items[:] = [
                item for item in menu_items 
                if item.name not in ['delete', 'unpublish']
            ]

3. 批量操作拦截：自定义批量动作 #

通过钩子移除静态页面的批量删除/取消发布选项：

# wagtail_hooks.py
@hooks.register('register_page_listing_mass_actions')
def filter_static_page_mass_actions(actions, request, page_class=None):
    # 若当前列表为静态页面，移除危险批量操作
    if page_class in [HomePage, ContactPage, AboutPage, MainCatalogPage, MainBlogPage]:
        actions[:] = [
            action for action in actions 
            if action.name not in ['delete', 'unpublish']
        ]
    return actions

方案优势 #

• 从权限层面彻底拦截删除/取消发布操作，即使编辑者通过URL直接访问操作接口也会被拒绝
• 全场景隐藏操作入口，避免误导编辑者，降低误操作风险
• 代码结构清晰，符合Wagtail扩展规范，便于维护和扩展

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