@esthetic/wp-release

wp-release

This module is a wrapper around semantic-release for use with WordPress themes and plugins, supported by commitlint, husky, and commitizen to enforce proper commit messages for semantic-release to parse.

Setup

Install Package

npm install Mill-Mountain-Digital-va/wp-release --save-dev

Initial Config

Update package.json with the following items:

{
	"commitlint": {
		"extends": ["@commitlint/config-conventional"]
	},
	"config": {
		"commitizen": {
			"path": "./node_modules/cz-conventional-changelog"
		}
	},
	"release": {
		"extends": "wp-release"
	}
}

Other Options

wp-release

There are two additional config items that can be specified in package.json under config.wpRelease:

• ignore: array of globs to indicate which files to exclude from the generated zip file of the project.
• entryFile: filename that contains the header that WordPress uses to check version number ("Version: x.x" at the top of the file). By default wp-release will update the version number in style.css or a php file that matches the project name listed in package.json, but this option can be used if you use a non-standard filename for your main plugin file.

{
	"config": {
		"wpRelease": {
			"entryFile": "custom-name.php",
			"ignore": [
				".env.sample",
				".git/**",
				".gitignore",
				"node_modules/**",
				"some-build-file.js"
			]
		}
	}
}

The default ignore list is:

[
	".DS_Store",
	".env",
	".env.sample",
	".git/**",
	".github/**",
	".npm/**",
	".gitignore",
	".huskyrc.js",
	".releaserc",
	"node_modules/**",
	"release.config.js",
]

semantic-release

By default, wp-release uses almost all of the default config options for semantic-release. View semantic-release's config options to see those and further customize things you may need to adjust. For example, using custom branch names and release channels:

{
	"release": {
		"extends": "wp-release",
		"branches": [
			"main",
			{
				"name": "beta",
				"prerelease": true
			}
		]
	}
}