SuperAPI AI 工具集

create-twig-form-template

编程与开发

查看项目

更新于 10-16 06:58

技能介绍

用途

create-twig-form-template 是一个用于在 PrestaShop 后台创建表单页面 Twig 模板的技能。它面向两类表单渲染模式,帮助开发者按项目既有约定生成模板文件。

主要能力

技能覆盖以下内容:

  • CRUD 表单模板:每页渲染一个表单,使用专用的 form.html.twig。同一模板通常同时服务于新增和编辑,由控制器传入不同的表单数据。
  • 设置表单区块模板:在列表页(或专用配置页)上渲染一个或多个选项区块,每个区块是独立的 form_start/form_end,并带有显式的 action URL。
  • 表单主题覆盖:当特定字段需要超出 Symfony 默认渲染的自定义渲染时使用。首选在表单上直接设置 form_theme 选项(PrestaShop 自定义选项),通常在控制器构建表单时或表单类型的 configureOptions() 中设置;回退方案是在 Twig 中使用 {% form_theme %} 指令。表单主题仅作用于当前表单,无全局副作用。
  • JS 资源引入:当表单需要 JavaScript(用于 initComponents 或 Vue)时,通过 javascripts 块引入资源,资源路径必须与 webpack 入口名称一致。

使用方式

技能要求先阅读 @.ai/Component/Twig/CONTEXT.md 了解模板约定(布局、flash 消息、路由、表单主题)。当模板渲染特定表单模式时,只加载相关的 Forms 子上下文:CRUD 模板加载 @.ai/Component/Forms/CRUD.md,设置区块加载 @.ai/Component/Forms/SETTINGS.md。

CRUD 表单模板创建于 src/PrestaShopBundle/Resources/views/Admin/{Section}/{Domain}/form.html.twig,继承 @PrestaShop/Admin/layout.html.twig,在 content 块中使用 form_start(form)、form_widget(form)、提交按钮和 form_end(form)。始终使用单个 form_widget(form)(原因见 Twig/CONTEXT.md,涉及模块钩子兼容性)。文件上传需添加 enctype="multipart/form-data"。

设置表单区块与 CRUD 模式有两点差异:action URL 是显式的,设置表单 POST 到专用的保存路由(如 admin_countries_save_options),与页面路由不同;提交按钮位于 form_widget 之外,通常在卡片页脚中,但单个 form_widget(form) 规则仍然适用,按钮是同级元素而非 form_widget 调用的子元素。对于同时包含网格和一个或多个设置区块的页面,索引模板将网格和每个设置区块渲染为独立的顶层元素,每个区块有自己的 form_start/form_end。

适用场景

适用于 PrestaShop 后台表单页面的模板开发,包括:

  • 新增/编辑类 CRUD 表单页面
  • 设置类表单区块(如 Advanced > Performance 页面有六个区块)
  • 混合网格与设置区块的页面(如 Improve > International > Locations > Countries)

限制与注意事项

  • 表单主题覆盖应尽量精简,Symfony 默认渲染可处理大多数情况。
  • CSRF token 由 form_end(form) 自动包含。
  • 设置区块必须设置显式的 action: path('...'),页面路由不是保存路由。
  • 参考文件:src/PrestaShopBundle/Resources/views/Admin/Improve/International/Tax/(简单示例)、src/PrestaShopBundle/Resources/views/Admin/Sell/Catalog/Manufacturer/(含图片)、src/PrestaShopBundle/Resources/views/Admin/Improve/International/Country/Blocks/options.html.twig 与 index.html.twig(PR #41406)。
  • 关于收费、价格、平台支持范围等信息,资料中暂未提供。