用途:在创建或修改 Bagisto 店铺前台主题时启用,适用于把自定义前台主题做成分发用的独立包、定制面向顾客的页面、覆盖默认店铺模板,以及使用 Vite 驱动的资源。资料称其为 Bagisto 店铺主题开发技能。
主要能力与结构:主题配置写在 config/themes.php,包含名称、assets_path、views_path 及 vite 的 hot_file、build_directory、package_assets_directory。customize 是主题注册其前台定制内容的唯一位置,其下所有键均可选:customize.sections 缺省时按 SectionTypeEnum 顺序提供全部核心区块类型,主题自有区块类型以该处列出的 SectionType 类表示;customize.image_cache.templates 把 cache/{template}/{path} 名称映射到带公开 applyFilter() 的类,在运行该主题的渠道上合并到核心 imagecache.templates(small、medium、large)之上,用于覆盖核心名称或新增名称,且不修改 config/imagecache.php,由 Webkul\ImageCache\TemplateRegistry 按请求主机解析;customize.image_cache.product_images 决定哪些模板进入产品图片数组,产品图片助手及产品 API、图库、购物车项始终携带 small、medium、large 与 original,且仅为此处列出的名称附带 {name}_image_url。管理端请求始终解析核心模板,CatalogApiCache 按渠道主题为列表建立键。
必要用法:按需加载参考文件,creating-a-theme.md 用于搭建主题包并注册,assets.md 用于 Vite 管线、构建和开发服务器流程,layouts.md 用于店铺布局、Blade 组件和自定义布局,reference.md 用于包结构、关键文件、注意事项和测试。资料明确要求:在宣布任何改动完成前,必须使用 bagisto-change-verification 子技能。
限制:资料未提供版本、依赖版本、安装命令、收费或效果数据;具体实现细节需查阅上述参考文件与 UPGRADE.md 相关章节。