semantic-release plugin to create a zip file for a WordPress plugin or theme.
Step | Description |
---|---|
verifyConditions |
Verify if the theme / plugin is valid. Check that the necessary files exist and if they contain needed metadata |
prepare |
Copy the theme / plugins files and optionally prepare the asset bundle |
publish |
Create a zip file for the theme / plugin, and optionally zip the assets |
success |
Clean up the intermediate files |
$ 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:
Plugin uses no environment variables, but has a lot of configuration options
Options | Description | Default |
---|---|---|
type |
Type of the package to create. Can be plugin or theme |
None. You must set this explicitly |
slug |
Package slug. | None. You must set this explicitly |
path |
The path of root folder that contains plugin or theme | ./ |
withAssets |
Does the package have assets (screenshots, banners, logo) | false |
withReadme |
Does the package have a readme.txt file | false |
withVersionFile |
Do we need to create a file with the next release version | true |
releasePath |
Base path for all of the release files | /tmp/wp-release |
versionFiles |
Array of additional files containing the package version. | [] |
include |
Files to include in the package zip file. | **/* |
exclude |
Files to exclude from the package zip file | List of files and folders defined in constants.ts |
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
.
[!IMPORTANT] Version in your plugin / theme must be set to 0.0.0 for this plugin to work
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
.
[!WARNING] Version in your readme.txt must also be set to 0.0.0 for this plugin to work
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.
.distinclude
and .distexclude
/ .distignore
files which take precedence over the options set in the plugin.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"
]
}]
]
}