如何以编程方式为Wagtail AbstractEmailForm子类添加表单字段

你当前的模型结构符合Wagtail AbstractEmailForm 的设计逻辑——这类表单页面的自定义字段全部存储在关联模型LanderPageFormField对应的数据库表中，不属于LanderPage本身的固有模型字段。
你之前写的实例化代码存在两处关键问题，直接导致生成的表单没有字段：

• 仅传入了LanderPage自身的基础字段值，完全没有给关联的form_fields关系插入任何表单字段记录
• 没有走Wagtail Page模型的正规创建保存流程，仅生成了内存中的模型实例，没有完成持久化

1. 可视化配置场景（适配当前模型结构） #

当前代码中已经在content_panels里配置了InlinePanel('form_fields', label="Form fields")，这就是给后台留的可视化配置入口：

• 后台打开对应LanderPage的编辑页面，找到“Form fields”配置区块
• 点击添加按钮，即可可视化新增表单字段，比如姓名、电子邮箱这类字段：选择对应字段类型（单行文本、邮箱输入框等），配置必填规则、提示文字、校验要求
• 所有配置会自动存入LanderPageFormField表，前台渲染表单时会自动读取这些配置生成对应输入项，无需手写表单代码。

2. 代码批量创建场景（无需进后台手动配置） #

如果需要用代码一次性创建好带完整表单字段的LanderPage实例，需要修正之前的实例化逻辑，同时给关联字段表写入数据：

# 第一步：找到要挂载新页面的父页面节点
parent_page = Page.objects.get(slug='your-parent-page-slug')

# 第二步：初始化LanderPage自身的基础字段
new_page = LanderPage(
    title='Test sub page',
    slug='testsub',
    body='body text here',
    from_address='j@site.com',
    to_address='j@site.com',
    subject='new inquiry'
)

# 第三步：将新页面挂载到父节点下完成持久化
parent_page.add_child(instance=new_page)

# 第四步：通过关联管理器插入需要的表单字段
# 新增姓名字段
new_page.form_fields.create(
    label='姓名',
    field_type='singleline',
    required=True,
    help_text='请输入你的真实姓名'
)

# 新增电子邮箱字段
new_page.form_fields.create(
    label='电子邮箱地址',
    field_type='email',
    required=True,
    help_text='请输入常用联系邮箱'
)

补充说明 #

AbstractFormField内置了常用的字段类型，直接传入对应的标识符即可使用，无需额外自定义：

• singleline：单行文本输入框
• multiline：多行文本输入框
• email：邮箱格式校验输入框
• number：数字输入框
• url：链接格式输入框
• checkbox：勾选框
• select：下拉选择框

如果你不需要后台灵活配置表单字段的能力，完全可以把姓名、邮箱这类字段直接定义为LanderPage模型的固定字段，再手动编写对应表单类渲染——这种场景下就没必要继承AbstractEmailForm的整套动态字段逻辑了。

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