SuperAPI AI 工具集

admin-theme-development

编程与开发

查看项目

更新于 10-15 17:24

技能介绍

用途:在 Bagisto 中开发自定义后台(admin)主题,最终产物是一个可独立分发与维护的 Laravel 包,包含全部视图、资源、服务提供者与 Vite 配置。

主要能力:定义后台主题配置(config/themes.php 中的 admin-default 与 admin 数组,含 name、assets_path、views_path、vite 等属性);复制并覆盖默认后台视图与资源;创建自定义仪表盘页面与自定义 master 布局;通过服务提供者发布视图;使用 Vite 编译 CSS/JS 资源;使用后台 Blade 组件(accordion、button、charts、datagrid、drawer、dropdown、flat-picker、media、modal、tabs、shimmer 等)与 x-admin::layouts 布局(自带侧边栏、顶栏、响应式、暗色模式、面包屑)。

使用方式:创建包目录结构后复制后台资源与视图,编写服务提供者并在 bootstrap/providers.php 注册,更新 composer.json 的 PSR-4 自动加载并执行 composer dump-autoload;在 config/themes.php 与 config/bagisto-vite.php 中登记主题;执行 php artisan vendor:publish --provider="Webkul\CustomAdminTheme\Providers\CustomAdminThemeServiceProvider" 发布视图,php artisan optimize:clear 清缓存;在包目录执行 npm install、npm run dev 或 npm run build 编译资源。开发时可用符号链接替代重复发布。

适用场景:创建自定义后台主题包、定制后台样式、覆盖默认后台模板、构建可分发的后台主题包。

限制与注意:修改主题配置后需清缓存;注册包后需执行 composer dump-autoload;需复制完整后台视图与资源;自定义布局需手动加载 @bagistoVite 资源;应在包源码而非已发布文件中开发;开发工作流需配置符号链接。具体版本兼容性与依赖版本以资料所列 package.json 为准,其余未提供。