开发文档 ›全部章节 ›打包与提交 ›打包与提交

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。