5分钟快速上手如何用action-wordpress-plugin-deploy发布你的第一个WordPress插件版本【免费下载链接】action-wordpress-plugin-deployDeploy your plugin to the WordPress.org repository using GitHub Actions项目地址: https://gitcode.com/gh_mirrors/ac/action-wordpress-plugin-deployaction-wordpress-plugin-deploy 是一款基于 GitHub Actions 的WordPress 插件自动发布工具它在 WordPress.org 插件仓库中提交你的代码实现打一个标签、插件自动上线。无论你是刚写完第一个插件的新手还是想告别手动 SVN 操作的老手这套 WordPress 插件部署流程都能在 5 分钟内跑通。本文是一份面向初学者的完整指南带你一步步发布你的第一个 WordPress 插件版本。这个工具能做什么简单来说你只需要在代码仓库里打一个版本标签比如1.0.0它会自动完成以下工作步骤自动完成的操作1️⃣ 拉取检出 WordPress.org 插件仓库trunk / tags / assets2️⃣ 同步按标签内容同步代码到trunk排除测试、编辑器配置等无关文件3️⃣ 资源把.wordpress-org目录中的横幅、图标、截图移入assets目录4️⃣ 发布复制为对应版本号的 tag 并提交到 SVN一次 commit 搞定更贴心的是如果该版本已经发布过它会直接跳过重复发布还支持dry-run试运行和自动生成 ZIP 包。快速开始3步完成WordPress插件发布配置第一步设置 SVN 账号密钥发布到 WordPress.org 需要 SVN 凭据。进入仓库Settings → Secrets添加两项SVN_USERNAME你的 WordPress.org 用户名SVN_PASSWORD你的 SVN 密码注意不是登录密码而是在 WordPress.org 的 SVN 凭据设置页生成的密钥一旦保存就无法再次查看请妥善保管。第二步放入工作流文件把示例文件的内容复制到你的仓库.github/workflows/deploy.yml中即可。项目内置了 3 个官方示例按需选择推送新标签时部署examples/deploy-on-pushing-a-new-tag.yml推送新标签并创建 Release 附带 ZIPexamples/deploy-on-pushing-a-new-tag-and-create-release-with-attached-zip.yml发布 Release 时部署并附上 ZIPexamples/deploy-on-publishing-a-new-release-and-attach-a-zip-file-to-the-release.yml最基础的推标签即部署工作流长这样已精简name: Deploy to WordPress.org on: push: tags: - * jobs: tag: name: New tag runs-on: ubuntu-latest # 建议保持 ubuntu依赖 SVN steps: - uses: actions/checkoutv4 - name: Build # 按需修改或删除 run: | npm install npm run build - name: WordPress Plugin Deploy uses: 10up/action-wordpress-plugin-deploystable env: SVN_PASSWORD: ${{ secrets.SVN_PASSWORD }} SVN_USERNAME: ${{ secrets.SVN_USERNAME }} SLUG: my-super-cool-plugin # 可选⚠️ 小提醒SLUG仅在 WordPress.org 插件仓库名与仓库名含大小写不一致时才需要填写匹配的话可以直接删掉这一行。第三步打标签见证自动发布提交所有改动然后推送一个标签git tag 1.0.0 git push origin 1.0.0CI 会自动触发几分钟后你的 WordPress 插件版本就出现在 WordPress.org 仓库中了。 本地想要体验一下克隆部署效果的话可用git clone https://gitcode.com/gh_mirrors/ac/action-wordpress-plugin-deploy获取项目代码。发布前建议先用 dry-run 试运行第一次配置时强烈建议先彩排在工作流中给该 Action 加上with: dry-run: true此时它会走完全部流程但不真正提交SVN而且不需要配置密钥——非常适合排查路径、排除规则等问题。确认日志无误后去掉这一行再正式发布。可选配置一览表环境变量默认值用途SLUG仓库名WordPress.org 插件仓库 slug大小写不一致时指定VERSION标签名自定义版本号一般不建议设置ASSETS_DIR.wordpress-org存放 banner、图标、截图的目录BUILD_DIR关闭从指定构建产物目录部署忽略排除规则怎么排除不发布的文件测试代码、.github目录、node_modules这类文件不该出现在插件仓库里。两种排除方式二选一.distignore优先适合有构建步骤的现代插件一行一个要忽略的路径.gitattributes适合无构建步骤的插件用export-ignore指令标记两个文件都没有时工具会自动写入一份基础.gitattributes至少保证 Git 相关的文件不会被误传。具体写法可参考README.md中的示例基线。进阶玩法自动生成 ZIP 包发布到 WordPress.org 的同时把 ZIP 包附到你的 Release 上方便用户直接下载。只需开启一个输入with: generate-zip: true它会基于 SVNtrunk生成规范的插件 ZIP并输出zip-path供后续步骤使用解压后的文件夹名不带版本号符合 WordPress 的规范。常见问题FAQQ为什么建议用ubuntu-latest作为运行环境Action 内部需要 SVN 客户端脚本见deploy.sh会在缺失时自动安装 subversion而 Ubuntu 环境下兼容性最稳定。Q同一个版本标签重复推送会怎样不会重复发布——检测到tags/版本号已存在时会直接跳过并提示already published。Q如何查看版本更新历史参见 CHANGELOG.md记录了从 2.1.0 起的所有功能与修复。Q截图点击后被强制下载怎么办不用担心发布脚本会自动为assets中的 PNG/JPG/GIF/SVG 设置正确的 mime 类型。写在最后到这里你的 WordPress 插件已经具备打标签即上线的自动化发布能力了。后续想参与改进或反馈问题可以参考 CONTRIBUTING.md 中的贡献指南。祝你发布顺利早日把第一个插件版本送上 WordPress.org【免费下载链接】action-wordpress-plugin-deployDeploy your plugin to the WordPress.org repository using GitHub Actions项目地址: https://gitcode.com/gh_mirrors/ac/action-wordpress-plugin-deploy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考