用途:在 PrestaShop 后台为实体的列表(grid)页面创建 Twig 索引模板。
主要能力:生成遵循 PrestaShop 模板约定的 index 模板,包含网格面板、页面头部工具栏、flash 消息的自动处理,并支持按需自定义列渲染。
使用方式:先阅读 @.ai/Component/Twig/CONTEXT.md 了解模板约定(布局、flash 消息、路由、表单主题)。随后创建文件 src/PrestaShopBundle/Resources/views/Admin/{Section}/{Domain}/index.html.twig,模板继承 '@PrestaShop/Admin/layout.html.twig',在 content 块中通过 include 引入 '@PrestaShop/Admin/Common/Grid/grid_panel.html.twig' 并传入 grid 变量,同时定义 page_header_toolbar 块。grid 变量由控制器的 indexAction 通过 grid presenter 传入,其名称必须与控制器传给 render() 的一致。可参考官方示例:Tax/index.html.twig(简单)与 Manufacturer/index.html.twig(两个网格)。
自定义列渲染:仅在列需要领域特定 HTML 时使用,通过在 grid panel include 中覆盖 {% block column_{column_id}_content %} 实现,常见场景为图片缩略图、自定义徽章、格式化组合值;默认列渲染保持不变,只覆盖必要项。
限制:资料未提供安装命令、收费信息及更多平台细节;仅为 PrestaShop 后台开发场景。