4.0 KiB

Raw Blame History

Contributing

Thanks for your interest in contributing to WooCommerce Blocks! Below are some developer docs for working with the project.

To get started you need to install all required dependencies by running the following command in the plugin directory.

npm install && composer install

NPM commands

We have a set of scripts in npm to automate important developer tasks.

Build

Run $ npm run build to build all assets for production.
Run $ npm start to run the development build and watch for changes.

These scripts compile the code using webpack.

You can also run $ npx webpack to run the development build and not keep watching.

Lint

Run $ npm run lint to check code against our linting rules.

This script runs 3 sub-commands: lint:php, lint:css, lint:js. Use these to run linters across the codebase (linters check for valid syntax).

lint:php runs phpcs via composer, which uses the phpcs.xml ruleset.
lint:css runs stylelint over all the scss code in assets/css, using the rules in .stylelintrc.json.
lint:js runs eslint over all the JavaScript, using the rules in .eslintrc.js.

Test

Run $ npm run test to run unit tests on the JavaScript.

The test scripts use wp-scripts to run jest for component and unit testing.

test:update updates the snapshot tests for components, used if you change a component that has tests attached.
Use test:watch to keep watch of files and automatically re-run tests.

Create an installable zip package

Run $ npm run package-plugin to trigger install and build, and then create a zip file which you can use to install WooCommerce Blocks in WordPress admin.

Releasing new versions of blocks

These instructions cover new releases of the blocks plugin for those with commit access.

Before any release ensure you update:

The readme.txt file supported versions, changelog and list of blocks if the release includes new blocks.

Note: version numbers will automatically be updated in files via the deploy script (see bin/version-changes.sh).

Tagging new releases on GitHub

Tagging a new version on GitHub can be done by running the following script:

$ npm run deploy

This will trigger a build and then run the release script (found in /bin/github-deploy.sh). This tags a new version and creates the GitHub release from your current branch.

Important: Before running the deploy script ensure you have committed all changes to GitHub and that you have the correct branch checked out that you wish to release.

If you want to add additional details or a binary file to the release after deployment, you can edit the release here.

Pushing new releases to WordPress.org

If you have SVN commit access to the WordPress.org plugin repository you can run the following script to prepare a new version:

$ npm run release

This will ask for a tagged version number, check it out from GitHub, check out the SVN repository, and prepare all files. It will give you a command when it's finished to do the actual commit; you have a chance to test/check the files before pushing to WordPress.org.

Important: Before running the release script ensure you have already pushed a new release to GitHub.

Publishing `@woocommerce/block-library`

We publish the blocks to npm at @woocommerce/block-library,.

To release a new version, perform the following steps:

Run npm pack to prep a .tgz file.
Optionally test the package by uploading this onto a test site.
Run npm publish --access public, which will push the version up to npm.

4.0 KiB Raw Blame History