semantic-release plugin to create a zip file for a WordPress plugin or theme.

$ npm install -D @semantic-release/wordpress

The plugin can be configured in the semantic-release configuration file:

{
  "plugins": [
    "@semantic-release/commit-analyzer",
    "@semantic-release/release-notes-generator",
    ["@semantic-release/wordpress", {
      "type": "plugin",
      "slug" : "my-plugin",
      "withAssets": true,
      "withReadme": true,
      "withVersionFile": true,
    }]
  ]
}

With this example, for each release, the plugin will:

• Verify that the plugin is valid
• Create a zip file for the plugin (/tmp/wp-release/my-plugin.zip)
• Create a zip file for the assets (/tmp/wp-release/assets.zip)
• Copy the readme.txt file (/tmp/wp-release/readme.txt)
• Create a version file (/tmp/wp-release/version.txt)

Plugin uses no environment variables, but has a lot of configuration options

Plugin will automatically replace versions in your main file (for plugins) and the style.css file (for themes). We follow the WordPress codex, so your plugin file must have the same slug as the plugin folder.

If you have other variables which need to have the version replaced, you can add them to the versionFiles option.

If you need any further processing of the package files, next release version will be output to /tmp/wp-release/VERSION file, if the withVersionFile option is set to true.

If your package is on wp.org repository, you might have assets (screenshots, banners, logos) which you want to include in the assets file. Plugin respects the Codex, and expects those to be in .wordpress-org/assets folder. Main theme screenshot should be named screenshot and should be there as well.

readme.txt is a special Markdown file needed for packages on wp.org to work. It can be in the .wordpress-org folder, or in the repository root.
Plugin will automatically replace the version in the file if the withReadme option is set to true.

By default, plugin will include all files in the package zip file. If you want to exclude some files, you can use the exclude option. It accepts an array of files and folders, and uses glob for path resolution. You can also use the include option which works in the same manner.

• Include and exclude options are not mutually exclusive so you can use both.
• Plugin also looks for .distinclude and .distexclude / .distignore files which take precedence over the options set in the plugin.
• By default we exclude a lot of build artifacts and files which are not needed in the package. You can see the full list in constants.ts.

Plugin with assets, readme and additional version files

{
  "plugins": [
    ["@semantic-release/wordpress", {
      "type": "plugin",
      "slug" : "my-plugin",
      "withAssets": true,
      "withReadme": true,
      "withVersionFile": false,
      "versionFiles": [
        "constants.php",
        "includes/db-schema.php"
      ]
    }]
  ]
}