Files
wagtailcms/apps/cases/models.py
T
Zhengen c52e3a3ff5 修复 Wagtail API v2 fields= 参数请求自定义字段返回 400 的问题
所有 Page 模型(SEOablePage 及其子类 HomePage/BlogPage/BlogIndexPage/
ProductPage/CaseStudyPage/SolutionPage)此前均未声明 api_fields,导致
前端 fields=body,seo_title_override,... 等请求被 Wagtail API v2 拒绝并
返回 400(Wagtail 默认只暴露 id/meta/title,其余字段必须显式加入
api_fields 才能通过 ?fields= 查询)。这正是生产环境首页显示"尚未连接到
Wagtail CMS"的根因。

- apps/core/models.py: SEOablePage 增加 api_fields(seo_title_override/
  seo_description_override);SimpleContentPage 追加 body
- apps/home/models.py: HomePage 追加 body
- apps/blog/models.py: BlogIndexPage 追加 intro;BlogPage 追加
  published_at/intro/body
- apps/products/models.py: ProductPage 追加 summary/body
- apps/cases/models.py: CaseStudyPage 追加 client_name/industry/
  published_at/summary/body
- apps/solutions/models.py: SolutionPage 追加 industry/summary/body

api_fields 是纯 Wagtail 类属性,不是 Django 模型字段,因此不产生新的
migration(makemigrations --check 确认 No changes detected)。

验证:pytest 67 个用例全部通过;manage.py check 无新增错误(仅已知
treebeard.E001 警告)。
2026-09-14 16:22:01 +08:00

80 lines
2.5 KiB
Python

"""客户案例栏目与案例详情页。详见 documents/设计方案分析与完善版.md §2.5 页面树结构。"""
from django.db import models
from wagtail.admin.panels import FieldPanel
from wagtail.api import APIField
from wagtail.fields import StreamField
from wagtail.search import index
from apps.core.blocks import COMMON_BLOCKS
from apps.core.models import SEOablePage
class CaseStudyIndexPage(SEOablePage):
"""客户案例栏目列表页,子页面为 CaseStudyPage。"""
intro = models.TextField(blank=True, verbose_name="栏目简介")
content_panels = SEOablePage.content_panels + [
FieldPanel("intro"),
]
subpage_types = ["cases.CaseStudyPage"]
parent_page_types = ["home.HomePage"]
class Meta:
verbose_name = "客户案例栏目页"
def get_context(self, request, *args, **kwargs):
context = super().get_context(request, *args, **kwargs)
context["case_studies"] = (
CaseStudyPage.objects.live().descendant_of(self).order_by("-published_at")
)
return context
class CaseStudyPage(SEOablePage):
"""单个客户案例详情页。"""
client_name = models.CharField(max_length=100, verbose_name="客户名称")
industry = models.CharField(max_length=100, blank=True, verbose_name="所属行业")
published_at = models.DateTimeField(verbose_name="发布时间")
summary = models.CharField(max_length=250, blank=True, verbose_name="案例摘要")
cover_image = models.ForeignKey(
"wagtailimages.Image",
null=True,
blank=True,
on_delete=models.SET_NULL,
related_name="+",
verbose_name="封面图",
)
body = StreamField(COMMON_BLOCKS, use_json_field=True, blank=True)
search_fields = SEOablePage.search_fields + [
index.SearchField("client_name"),
index.SearchField("summary"),
index.SearchField("body"),
]
content_panels = SEOablePage.content_panels + [
FieldPanel("client_name"),
FieldPanel("industry"),
FieldPanel("published_at"),
FieldPanel("summary"),
FieldPanel("cover_image"),
FieldPanel("body"),
]
api_fields = SEOablePage.api_fields + [
APIField("client_name"),
APIField("industry"),
APIField("published_at"),
APIField("summary"),
APIField("body"),
]
parent_page_types = ["cases.CaseStudyIndexPage"]
subpage_types = []
class Meta:
verbose_name = "客户案例"