如何设置Wagtail InlinePanel的QuerySet？实现归档而非删除项

需求与问题 #

• 需将InlinePanel中的项标记「归档」，使其不在面板中显示，仅展示未归档项
• 归档项不能删除，需保留用于历史查询和报表生成
• 尝试过的方案均存在问题：
  • JavaScript隐藏会拖慢页面加载
  • 直接过滤QuerySet移除归档项，页面发布时这类项会因InlinePanel不再引用而被删除
  • 设置on_delete=models.SET_NULL无效，关联对象仍会被删除
  • 使用PROTECT会阻止页面发布，无法满足需求

可行实现方式 #

核心思路是给关联模型添加归档标记，自定义InlinePanel过滤未归档项，同时重写页面保存逻辑，确保归档项不会被Wagtail自动删除。

1. 修改关联模型，添加归档字段 #

给Variant模型增加archived布尔字段，用于标记是否归档：

from django.db import models
from wagtail.core.models import Page, ParentalKey

class Variant(models.Model):
    product = ParentalKey(
        'Product',
        related_name='variants',
        on_delete=models.SET_NULL,
        null=True,
    )
    archived = models.BooleanField(default=False, verbose_name='归档')
    # 其他业务字段...

2. 自定义InlinePanel，过滤未归档项 #

继承InlinePanel并重写get_queryset方法，仅返回未归档的Variant：

from wagtail.admin.panels import InlinePanel

class ActiveVariantInlinePanel(InlinePanel):
    def get_queryset(self, instance):
        queryset = super().get_queryset(instance)
        return queryset.filter(archived=False)

3. 重写页面保存逻辑，保留归档项 #

Wagtail的页面发布机制会同步InlinePanel中的关联对象，不在面板中的项会被移除。因此需要在页面保存时，将归档项重新关联到页面，避免被删除：

from wagtail.core.models import Page
from wagtail.admin.panels import MultiFieldPanel

class Product(Page):
    panels = [
        MultiFieldPanel([
            ActiveVariantInlinePanel('variants', label='商品规格'),
        ]),
    ]

    def save(self, *args, **kwargs):
        # 保存前记录所有已归档的关联项
        archived_variants = list(self.variants.filter(archived=True))
        # 执行父类保存逻辑
        super().save(*args, **kwargs)
        # 将归档项重新关联到当前页面
        if archived_variants:
            self.variants.add(*archived_variants)

说明 #

• 该方案无需JavaScript，完全通过后端逻辑实现归档项的隐藏与保留
• 归档项仍保存在数据库中，可正常用于历史查询和报表生成
• 未归档项正常在InlinePanel中展示、编辑，不影响日常操作

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