Wagtail 4.22自定义页面发布成功消息的优化实现问询

问题分析 #

原方案将文件处理（page_published信号）和消息提示（after_edit_page钩子）分离，且通过解析版本JSON判断上传状态的方式不够可靠——既增加了逻辑复杂度，也可能因版本数据同步问题导致判断错误。下面提供一种将逻辑合并的优雅实现方案。

解决方案 #

将文件处理与消息提示逻辑整合到after_edit_page钩子中，直接通过页面实例字段判断上传状态，避免依赖信号和版本JSON解析。

完整代码实现

from django.utils import timezone
from django.contrib import messages
from wagtail import hooks

@hooks.register('after_edit_page')
def do_after_page_edit(request, page):
    # 仅针对目标页面类型处理
    if isinstance(page, MyPage):
        # 直接检查页面是否上传了文件
        has_uploaded_file = page.uploaded_file is not None

        if has_uploaded_file:
            # 处理上传的文件
            process_data(page.uploaded_file.path)
            
            # 清理文件字段并更新日期
            page.uploaded_file.delete(save=False)
            page.uploaded_file = None
            page.date = timezone.now().date()
            
            # 保存页面但不创建新版本（避免冗余版本）
            page.save(revision=False)
            
            # 添加自定义成功消息
            messages.success(request, f"已更新页面 {page.title} 的数据")
        else:
            # 未上传文件时的提示
            messages.success(request, f"已编辑并发布页面 {page.title}，但未更新数据")

方案优势 #

1. 逻辑统一：所有相关操作（文件处理、状态判断、消息提示）集中在一个钩子中，代码更易维护。
2. 可靠性提升：直接读取页面实例的uploaded_file字段判断状态，无需解析版本JSON，避免潜在的格式或同步问题。
3. 减少冗余：使用save(revision=False)跳过版本创建，避免因清理文件字段产生不必要的页面版本。

替换步骤 #

1. 删除原有的page_published信号接收器代码。
2. 将上述代码替换原有的do_after_page_edit钩子实现。
3. 确保代码所在文件（通常是wagtail_hooks.py）被Wagtail正确识别。

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