新增 seed_homepage 管理命令:初始化首页内容

- apps/home/migrations/0001_initial.py 只创建了 HomePage 表结构,未像
  `wagtail start` 项目模板那样附带创建首页实例的数据迁移,全新环境
  migrate 后后台看到的仍是 Wagtail 自带占位欢迎页
- 新命令 `python manage.py seed_homepage`(幂等,可重复执行/放入部署
  脚本):
  - 创建 home.HomePage 实例并填充默认 StreamField 区块(Hero/数据
    展示/能力网格/CTA),供运营在此基础上编辑
  - 将默认 Site.root_page 指向新首页
  - 清理 Wagtail 自带占位页
- 注意 Site.root_page 外键 on_delete=CASCADE,需先切换 Site 指向再
  删除占位页,避免级联删除 Site 记录
This commit is contained in:
2026-08-19 17:18:40 +08:00
parent 19af182314
commit ca1e63e973
@@ -0,0 +1,122 @@
"""
初始化首页内容:创建 home.HomePage 实例(若不存在),填充默认 StreamField 内容,
并将默认 Wagtail Site 的 root_page 指向新首页,同时清理 Wagtail 自带的占位欢迎页。
背景:apps/home/migrations/0001_initial.py 只创建了 HomePage 的表结构,并未像
`wagtail start` 项目模板那样附带一个"创建首页实例 + 设置站点根页面"的数据迁移,
所以全新环境 `migrate` 之后,Wagtail 后台看到的仍是自带的
"Welcome to your new Wagtail site!" 占位页面,需要运行本命令完成首页内容初始化。
用法:
python manage.py seed_homepage
行为(幂等,可安全重复执行,适合放进部署脚本/容器启动脚本):
1. 若已存在 home.HomePage 实例,跳过创建,仅确保默认 Site 指向该页面。
2. 若不存在,则:
- 在页面树根节点下创建一个 HomePage 实例,标题"首页",slug "home";
- 填充 body StreamField 默认内容(Hero/数据展示/能力网格/CTA 区块),
方便运营人员在此基础上编辑,而非从空白页开始;
- 将默认 Site 的 root_page 指向新首页;
- 删除 Wagtail 自带的占位欢迎页。
"""
from django.core.management.base import BaseCommand
from wagtail.models import Page, Site
from apps.home.models import HomePage
DEFAULT_BODY = [
(
"hero",
{
"title": "为企业提供专业的技术解决方案",
"subtitle": "聚焦行业痛点,助力企业数字化转型与业务增长",
"background_image": None,
"buttons": [
{"text": "了解产品", "link": "/products/"},
{"text": "联系我们", "link": "/contact/"},
],
},
),
(
"stats",
{
"items": [
{"value": "10+", "label": "行业深耕年限"},
{"value": "500+", "label": "服务企业客户"},
{"value": "98%", "label": "客户满意度"},
],
},
),
(
"feature_grid",
{
"heading": "核心优势",
"items": [
{"icon": "", "title": "专业团队", "description": "资深工程师团队,保障项目交付质量。"},
{"icon": "", "title": "定制方案", "description": "针对企业实际场景提供定制化解决方案。"},
{"icon": "", "title": "持续服务", "description": "提供从咨询、实施到售后的全流程服务。"},
],
},
),
(
"cta",
{
"heading": "开始您的项目咨询",
"description": "留下您的需求,我们的顾问将尽快与您联系。",
"button": {"text": "立即咨询", "link": "/contact/"},
},
),
]
class Command(BaseCommand):
help = "初始化首页内容:创建 HomePage 实例、填充默认区块、设置为站点根页面(可重复执行)。"
def handle(self, *args, **options):
home_page = HomePage.objects.first()
if home_page is not None:
self.stdout.write(
self.style.SUCCESS(f"HomePage 实例已存在:{home_page.title},跳过创建。")
)
self._ensure_site_root(home_page)
return
root_page = Page.objects.get(depth=1)
# 占位欢迎页的 slug 默认同为 "home",此时不能直接删除它——Wagtail 默认
# Site.root_page 外键为 on_delete=CASCADE,若在改指向前删除会连 Site 记录
# 一并级联删掉。因此先用临时 slug 创建首页,指向站点后再清理占位页,
# 最后把 slug 改回 "home"。
home_page = HomePage(title="首页", slug="home-tmp-init", body=DEFAULT_BODY)
root_page.add_child(instance=home_page)
home_page.save_revision().publish()
self.stdout.write(self.style.SUCCESS(f"已创建首页:{home_page.title}"))
self._ensure_site_root(home_page)
self._cleanup_placeholder_pages(root_page, home_page)
home_page.slug = "home"
home_page.save()
def _ensure_site_root(self, home_page):
site = Site.objects.filter(is_default_site=True).first() or Site.objects.first()
if site is None:
site = Site.objects.create(
hostname="localhost", port=80, is_default_site=True, root_page=home_page
)
self.stdout.write(self.style.SUCCESS(f"未找到 Site 配置,已创建默认站点 '{site.hostname}'。"))
return
if site.root_page_id != home_page.pk:
site.root_page = home_page
site.save()
self.stdout.write(self.style.SUCCESS(f"已将站点 '{site.hostname}' 的根页面指向首页。"))
def _cleanup_placeholder_pages(self, root_page, home_page):
"""删除 Wagtail 自带的占位欢迎页(通用 wagtailcore.Page,非任何自定义子类)。"""
placeholder_pages = Page.objects.child_of(root_page).exact_type(Page).exclude(pk=home_page.pk)
count = placeholder_pages.count()
if count:
for page in placeholder_pages:
page.delete()
self.stdout.write(self.style.SUCCESS(f"已清理 {count} 个 Wagtail 占位页面。"))