From ca1e63e9730efef1580bd9b79e087245ce2ab89f Mon Sep 17 00:00:00 2001 From: Zhengen TANG Date: Wed, 19 Aug 2026 17:18:40 +0800 Subject: [PATCH] =?UTF-8?q?=E6=96=B0=E5=A2=9E=20seed=5Fhomepage=20?= =?UTF-8?q?=E7=AE=A1=E7=90=86=E5=91=BD=E4=BB=A4=EF=BC=9A=E5=88=9D=E5=A7=8B?= =?UTF-8?q?=E5=8C=96=E9=A6=96=E9=A1=B5=E5=86=85=E5=AE=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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 记录 --- .../core/management/commands/seed_homepage.py | 122 ++++++++++++++++++ 1 file changed, 122 insertions(+) create mode 100644 apps/core/management/commands/seed_homepage.py diff --git a/apps/core/management/commands/seed_homepage.py b/apps/core/management/commands/seed_homepage.py new file mode 100644 index 0000000..d4e669c --- /dev/null +++ b/apps/core/management/commands/seed_homepage.py @@ -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 占位页面。"))