使用 Github Action 发布插件到 WordPress

目前做开发时代码版本管理现在都是使用 Git 了，而 WordPress 官方发布插件提供的代码库是 SVN，借助 Github Action 工作流自动化部署脚本可以大大简化 WordPress 插件的发布流程。

主要步骤

设置 SVN 密码

登录 WordPress 官网，在个人资料页面的 Account & Security => SVN credentials 中设置 SVN 密码。

设置 Repository secrets

在 github 上的插件代码仓库 Settings => Secrets and variables => Actions => Secrets 中添加 SVN_USERNAME 和 SVN_PASSWORD（如下图所示），值就是 WordPress 平台获取到的 SVN 用户名和密码。

设置忽略文件 .distignore

.distignore 文件可以使发布脚本忽略不需要发布到 WordPress 插件中的文件。在你的仓库根目录创建一个 .distignore 文件，填写要忽略的文件或目录，即可实现忽略部分文件或目录了。

以下是我的 .distignore 文件示例：

/.wordpress-org
/.git
/.github
/node_modules
.distignore
.gitignore

添加 Action 脚本

在代码库的 .github/workflows/ 目录中添加一个 publish.yml 文件（文件名随意），yml 内容如下：

name: Deploy to WordPress.org
on:
  push:
    tags:
    - "*"
jobs:
  tag:
    name: New tag
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@master
    - name: WordPress Plugin Deploy
      uses: 10up/action-wordpress-plugin-deploy@stable
      env:
        SVN_PASSWORD: ${{ secrets.SVN_PASSWORD }}
        SVN_USERNAME: ${{ secrets.SVN_USERNAME }}
        SLUG: <你的插件的SLUG>

以上内容可以按照自己需求修改，如果你的仓库名称与插件的 slug 一致，则 SLUG 环境变量不需要设置，否则需要填入正确的插件 slug，关于这个 action 脚本的详细使用，可以参考项目：10up/action-wordpress-plugin-deploy

发布新版本

完成上面的工作后，就可以通过 push 一个新 tag 触发脚本发布新版本到 WordPress 了。

git tag -a 1.0.3 -m 'publish 1.0.3'
git push origin --tags

总结

经过以上配置后，插件新版本的发布变得非常简单，修改完业务代码，更新 readme.txt 和版本号等信息，提交代码之后添加一个新 tag 之后插件的新版本就会自动发布到 WordPress 了，非常方便。对于团队合作开发也非常的友好。