新增 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:
@@ -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 占位页面。"))
|
||||
Reference in New Issue
Block a user