action-wordpress-plugin-deploy完全入门：把WordPress插件一键自动部署到WordPress.org市场

action-wordpress-plugin-deploy完全入门把WordPress插件一键自动部署到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一句话认识这个项目 action-wordpress-plugin-deploy是 10up 团队开发的一款GitHub Actions 自动部署工具它能把你的WordPress 插件从 Git 仓库一键发布到WordPress.org 插件市场SVN 仓库。只需打一个 Git tag插件文件、版本目录、素材包就会自动同步、提交并生效从此告别手动svn commit。⚡ 全自动打 tag 即发布无需人工干预 智能过滤自动排除测试文件、GitHub 配置文件 素材搬家.wordpress-org目录自动归位到assets dry-run 模式上线前可先彩排零风险 可选打包部署完成自动生成标准 ZIP 安装包它解决了什么痛点WordPress.org 的插件仓库基于SVN管理目录结构包含trunk开发版、tags版本快照、assets图标截图。以往每次发版都要手动 checkout SVN 仓库删改同步文件、处理assets目录本地复制 tag、设置图片 mime 类型执行svn commit还要祈祷不出错而使用 action-wordpress-plugin-deploy 后以上步骤全部由 deploy.sh 在云端自动完成检出 SVN、同步trunk、复制版本 tag、设置截图 MIME 类型、一次性提交——一次 tag 推送 一次正式发布。部署前准备3 个必做动作 ✅① 注册 WordPress.org SVN 账号到 WordPress.org 后台注册/登录记下你的 SVN 用户名和密码这是提交到插件仓库的凭据。② 在仓库中配置 Secrets在代码仓库的Settings → Secrets中新增两个加密变量存储后不可查看安全无忧Secret 名称说明SVN_USERNAMEWordPress.org 的 SVN 用户名SVN_PASSWORDWordPress.org 的 SVN 密码③ 获取部署 Action在插件仓库中把该 Action 引入工作流即可若需获取源码可执行git clone https://gitcode.com/gh_mirrors/ac/action-wordpress-plugin-deploy最快上手一键部署 3 步走 项目内置了 3 套现成的工作流示例位于examples/目录直接复制到自己插件仓库的.github/workflows/目录即可触发方式示例文件适用场景推送新 tagdeploy-on-pushing-a-new-tag.yml最常用打 tag 即部署推送 tag 创建 Releasedeploy-on-pushing-a-new-tag-and-create-release-with-attached-zip.yml发版同时附上 ZIP 下载发布 Release 时部署deploy-on-publishing-a-new-release-and-attach-a-zip-file-to-the-release.yml以 Release 为唯一发版入口以推送 tag 触发为例核心配置如下注意必须包含 checkout 步骤name: Deploy to WordPress.org on: push: tags: - * jobs: tag: runs-on: ubuntu-latest # 建议固定使用 ubuntu-latest steps: - uses: actions/checkoutmaster - name: Build # 可选插件有构建步骤时保留 run: | npm install npm run build - name: WordPress Plugin Deploy uses: 10up/action-wordpress-plugin-deploystable env: SVN_USERNAME: ${{ secrets.SVN_USERNAME }} SVN_PASSWORD: ${{ secrets.SVN_PASSWORD }} SLUG: my-super-cool-plugin完成后在插件仓库执行git tag v1.0.0 git push --tags几分钟后 WordPress.org 上就多了一个新版本 核心配置项速查表 ⚙️变量默认值作用SLUG仓库名WordPress.org 插件 slug大小写不一致时需手动指定VERSIONtag 名发布版本号一般无需设置仅调试时用ASSETS_DIR.wordpress-org存放图标、截图等素材的目录BUILD_DIR关闭从指定构建目录部署编译产物忽略 ignore 规则generate-zipfalse部署后生成 ZIP输出zip-path供后续步骤使用dry-runfalse只走流程不提交 SVN无需 SVN 凭据排除文件.distignore 还是 .gitattributes部署时不想上传测试目录、编辑器配置两种方式任选其一优先读取.distignore.distignore有构建步骤的现代插件推荐与 WP-CLI 语法一致只支持排除/.wordpress-org /.git /.github /node_modules .distignore .gitignore.gitattributes无构建步骤的插件推荐用export-ignore标记# Directories /.wordpress-org export-ignore /.github export-ignore # Files /.gitattributes export-ignore /.gitignore export-ignore 小贴士若两个文件都没有Action 会自动生成一份基础.gitattributes保证 Git/GitHub 专属文件不会混入线上插件。进阶技巧安全彩排 ZIP 一键打包 先彩排再真发dry-run- name: WordPress Plugin Deploy uses: 10up/action-wordpress-plugin-deploystable with: dry-run: true # 完整执行但跳过最终 SVN 提交 生成 ZIP 并挂到 Release- name: WordPress Plugin Deploy id: deploy uses: 10up/action-wordpress-plugin-deploystable with: generate-zip: true部署后输出zip-path配合 Release 步骤即可把插件 ZIP 直接挂到发版页用户无需进仓库翻找。项目结构一览 action-wordpress-plugin-deploy/ ├── action.yml # Action 入口定义输入/输出 ├── deploy.sh # 核心部署脚本SVN 检出、同步、提交 ├── examples/ # 3 套即插即用的工作流示例 │ ├── deploy-on-pushing-a-new-tag.yml │ ├── deploy-on-pushing-a-new-tag-and-create-release-with-attached-zip.yml │ └── deploy-on-publishing-a-new-release-and-attach-a-zip-file-to-the-release.yml ├── README.md # 完整文档 ├── CHANGELOG.md # 版本更新记录 └── CONTRIBUTING.md # 贡献指南输入输出定义见 action.ymlgenerate-zip、dry-run为输入zip-path为输出配置直观好上手。常见问题 FAQ ❓Q1打 tag 后没有触发部署检查 tag 推送的分支是否在on.push.tags匹配范围内并确认工作流文件位于.github/workflows/目录下。Q2同一版本重复发布会怎样脚本会检测到tags/版本号已存在并直接跳过不会覆盖线上版本重复触发是安全的。Q3slug 大小写和仓库名不一样设置环境变量SLUG为 WordPress.org 上的实际 slug 即可无需改仓库名。Q4截图点击后为什么被强制下载脚本已自动为assets下的 png/jpg/gif/svg 设置svn:mime-type此问题由工具在提交时自动修复无需手动处理。总结发版效率翻倍的 WordPress 插件自动部署方案 action-wordpress-plugin-deploy 把WordPress 插件发布到 WordPress.org这件繁琐的事压缩成了打一个 tag 的动作。借助examples/里的现成工作流和 dry-run 彩排模式新手也能在 10 分钟内搭好一条稳定可靠的自动发布流水线。配合 README.md 中的完整说明与 CHANGELOG.md 的更新记录持续跟进版本演进让插件发版从此快人一步【免费下载链接】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），仅供参考