首页 › 关于 › 作者指南

作者指南

目录负责让人找到你的仓库，文派云桥负责让用户装上、更新。站长步骤见怎么用。

被目录正确收录

• 插件：主 PHP 写标准插件头（Plugin Name、Description、Version、Author、License）。
• 主题：根目录 style.css 写 Theme Name。没有主题头的仓库不收。
• 仓库加 README，目录的详情页会渲染它。
• 给仓库加 GitHub topics，帮助按场景找到你。
• 收录标准见提交收录。目录每周重读仓库。

插件：让用户装得上

• 每个版本打 tag。Release 附上可直接安装的 zip（根目录是插件文件夹名）。有两个及以上发布的会出现在默认列表。
• 没有作者附件时，目录仍提供对应 tag 的源码包，方便开发者查看。
• 发布到 Packagist 并写好 composer.json 的 type（wordpress-plugin），目录页会给出命令。

主题：只收作者打包的 zip

• WordPress 安装主题要求 zip 根目录是主题文件夹（小写 slug，内含 style.css）。
• GitHub / GitLab 的「Source code」zip 解压出来是 仓库名-标签 或带 commit 的目录，不能当主题安装包。
• 请在 GitHub Releases（或 GitLab / Codeberg 对应发布）里上传你自己打好的 zip。目录只给出这份附件，不改你的源码，也不重新打包。
• 没有作者 zip 时，主题页不提供下载按钮，仍可从仓库 Releases 自己取。

让用户更得上

外部插件的更新通道由作者自己负责，常见两条路：

• 走文派云桥。用户安装文派云桥插件后，把仓库地址注册为更新源。你正常打 release，用户就能收到更新。
• 内置自更新。在插件里集成 Plugin Update Checker，或在插件头写 Update URI。目录会把这类插件标为「带自更新」。

发布一个版本的清单

1. 更新主文件头部的 Version（主题则是 style.css）。
2. 更新 CHANGELOG 或 README 里的变更记录。
3. 打版本 tag；主题务必在 Release 附上可安装 zip。
4. （可选）提交 Packagist 自动同步。