10. 打包与提交
这节是硬规则。主程序导入时逐条验,官网提交时也先替你走一遍同样的检查,不合格当场退回。
打对的包 打错的包
mytpl.zip mytpl.zip
└─ mytpl/ ├─ templates/mytpl/ 多压了一层
├─ Dtr.php ├─ mytpl/Dtr.php
├─ Config.php └─ other/Dtr.php 两个根目录
├─ Form.html mytpl.zip
├─ pic.png └─ mytpl/
├─ views/... ├─ Dtr.php name 写成了 tpl-movie
└─ public/pc/... └─ views/...
命令行:进到 templates 目录里压,别连外层一起压
cd templates && zip -r ../mytpl.zip mytpl -x "*.DS_Store"
Windows:进 templates,右键 mytpl 文件夹 → 发送到 → 压缩文件夹
| 项目 | 规则 |
|---|---|
| zip 的根 | 只有一个目录,就是应用本身;深度不能超过一层 |
| 标记文件 | 模板要 Dtr.php,插件要 plugin.json,都在应用目录第一层 |
| 应用名 | 包里的 name 必须等于官网标识 ID 里那段目录名,一位都不能差 |
| 模板最少文件 | Dtr.php、views/index.php、views/layout.php |
| 插件最少文件 | plugin.json 和 entry 指向的那个 .php |
| 不能进包 | __MACOSX、.DS_Store、Thumbs.db 会被跳过;数据库备份、你的 config、站点 storage 内容、别的站点素材一律不要放 |
| 体积与数量 | zip 本身 20MB,解压后 64MB,文件数 3000 个,两处都卡这个数 |
| 文件名 | 不要出现尖括号、冒号、双引号、斜杠、星号、问号,中文文件名别用空格开头 |
| 包名 | 商店里的包按 标识 ID-版本号.zip 命名,自己不用管,提交给老李的包随便叫 |
10.1 标识 ID 与目录名
标识 ID = 前缀 + 目录名
模板 tpl-mytpl → 主程序里的 templates/mytpl/ → Dtr.php 里 'name' => 'mytpl'
插件 pub-mytool → 主程序里的 public/mytool/ → plugin.json 里 "name": "mytool"
目录名规则:小写字母开头,只能用小写字母、数字、短横线,短横线不打头不收尾也不连着写,
长度 3 到 32 位,default 和 core 是保留名不能用。
插件的 name 放宽到允许下划线,但官网目录名按上面这条严的来,省得两头不一致。
标识 ID 提交后不能再改。它一旦上架就是商店里的商品编号、主程序里的目录、更新比对的那一项,三处共用一个名字。
同名的包在商店里只有一份:tpl- 开头的是模板,pub- 开头的是插件,
core 是主程序本体,不给人占。
10.2 审核看什么
- 能不能装上:走一遍主程序的导入流程,报不报错。
- 装完能不能跑:前台首页、列表、内页、后台配置页都点开看,控制台不能有 PHP 报错。
- 标识 ID 与包里的 name 一致,Dtr.php 或 plugin.json 字段齐全。
- 不夹带无关东西:源码里不留测试脚本、备份、别人的素材、你的账号信息。
- 不偷数据:不外发客户站点的内容,不偷偷装额外脚本,不留后门与弱口令。
- 不越权改核心:插件只通过钩子和路由挂进去,改核心文件的直接退回。
- 自适应:390px 宽手机不横向溢出,后台管理面板宽度变化不撑破。
- 说明写得像人话:简介、功能列表、怎么开、有什么限制,客户照着能装能用。
驳回会写清哪一条不行,改完同一个标识 ID 重传一版就行,不用重新排队报新应用。
内容有问题去论坛发帖,或直接联系老李 QQ 260468289。