docs: 开发规范/教程/demo 全套 + 修复插件运行期自动加载缺口
- demo 插件 plugins/demo.hello-world:演示短代码过滤器、comment.created 钩子、路由+命名空间视图、迁移+模型、后台设置页、filament.post_form 表单注入 - demo 主题 themes/demo:最小可运行主题(覆盖 partials + 绿色系样式) - 教程 docs/tutorial-plugin.md / docs/tutorial-theme.md(10 分钟上手);规范 docs/development.md(代码/插件/主题/队列/测试/提交) - README 增加开发者文档导航与上手示例 - 修复关键缺口:插件类原来靠 composer.json 硬编码加载,第三方 ZIP 安装的插件无法加载;现改为启动时扫描 plugins/*/src 运行期注册 PSR-4(register 阶段,保证 Filament 面板解析插件页面前就绪),composer.json 移除硬编码 - 测试:demo 插件 3 个用例 + demo 主题渲染;全量 89 通过
This commit is contained in:
@@ -120,9 +120,26 @@ php artisan workerman:serve stop
|
||||
## 测试
|
||||
|
||||
```bash
|
||||
php artisan test # 25 个用例:迁移/老路由 301/主题/插件/会员支付流/AI 审核
|
||||
php artisan test # 84 个用例:迁移/老路由 301/主题/插件/会员支付流/AI 审核/商城购买
|
||||
```
|
||||
|
||||
## 开发者文档
|
||||
|
||||
| 文档 | 内容 |
|
||||
|------|------|
|
||||
| [docs/development.md](docs/development.md) | 开发规范(代码/插件/主题/队列/测试/提交) |
|
||||
| [docs/tutorial-plugin.md](docs/tutorial-plugin.md) | 插件开发教程(10 分钟上手,配套 demo) |
|
||||
| [docs/tutorial-theme.md](docs/tutorial-theme.md) | 主题开发教程(10 分钟上手,配套 demo) |
|
||||
| [docs/plugins.md](docs/plugins.md) | 插件 API 详解(钩子/依赖/商品化/市场契约) |
|
||||
| [docs/themes.md](docs/themes.md) | 主题 API 详解(视图解析/注入点/变量) |
|
||||
| [docs/architecture.md](docs/architecture.md) | 架构与设计决策 |
|
||||
| [docs/api.md](docs/api.md) | 对外 API(小程序/第三方) |
|
||||
| [docs/deploy.md](docs/deploy.md) | 部署(nginx/systemd/workerman/cron) |
|
||||
|
||||
**上手示例**:
|
||||
- 插件:`plugins/demo.hello-world/`(短代码 / 钩子 / 路由 / 后台页 / 迁移 / 表单注入,全演示)
|
||||
- 主题:`themes/demo/`(最小可运行主题,绿色系,覆盖 partials 即可换肤)
|
||||
|
||||
## 目录结构
|
||||
|
||||
```
|
||||
@@ -130,9 +147,9 @@ app/
|
||||
Blog/ # 前台域模块(Controllers/Jobs/Services/Support/View)
|
||||
Filament/ # 后台资源与页面
|
||||
Console/Commands # sablog:import / attachments:sync-s3 / workerman:serve / content:convert
|
||||
themes/ # 主题(sablog / modern)
|
||||
plugins/ # 内置插件(blog-seo / ai-moderation / payment / membership)
|
||||
docs/deploy.md # 部署指南
|
||||
themes/ # 主题(sablog / modern / demo 示例)
|
||||
plugins/ # 内置插件(blog-seo / ai-moderation / payment / membership)+ demo.hello-world 示例
|
||||
docs/ # 全部文档(见上文表格)
|
||||
```
|
||||
|
||||
## 许可
|
||||
|
||||
Reference in New Issue
Block a user