A native integration with Google offering free listings and Performance Max ads to WooCommerce merchants.
This repository is not suitable for support. Please don't use our issue tracker for support requests.
For self help, start with our user documentation.
The best place to get support is the WordPress.org Google for WooCommerce forum.
If you have a WooCommerce.com account, you can start a chat or open a ticket on WooCommerce.com.
We aim to support the latest two minor versions of WordPress, WooCommerce, and PHP. (L-2 policy)
- WordPress 5.9+
- WooCommerce 6.9+
- PHP 7.4+ (64 bits)
As per WordPress Core Handbook we currently support:
- Last 1 Android versions.
- Last 1 ChromeAndroid versions.
- Last 2 Chrome versions.
- Last 2 Firefox versions.
- Last 2 Safari versions.
- Last 2 iOS versions.
- Last 2 Edge versions.
- Last 2 Opera versions.
- Browsers with > 1% usage based on can I use browser usage table
After cloning the repo, install dependencies:
nvm use
to be sure you're using the recommended node version in.nvmrc
npm install
to install JavaScript dependencies.composer install
to gather PHP dependencies.
Now you can build the files using one of these commands:
npm run build
: Build a production versionnpm run dev
: Build a development versionnpm run start
: Build a development version, watch files for changesnpm run start:hot
: Build a development version in Fast Refresh mode, watch files for changes.
Notice this repository has engine-strict=true
directive set. That means you cannot install dependencies with other Node engines rather than the ones defined in the engines
directive inside package.json. It's recommended to use NVM and run nvm use
before installing the dependencies to be sure you're using the recommended Node version.
We added Node ^18
and npm ^9
to allow dependabot to update our dependencies. But these are not supported versions.
The Dependency Extraction Webpack Plugin makes working with frontend dependencies not so obvious, check [Working with DEWP.md
](Working with DEWP.md) for more details.
There are a number of helper scripts exposed via our package.json (below list is not exhaustive, you can view the package.json file directly to see all):
npm run lint:js
: Run eslint over the javascript filesnpm run lint:css
: Run stylelint over the javascript filesnpm run test:js
: Run the JS test suitenpm run test:js:watch
: Run the JS test suite, watch for changes
After running composer install
to install PHP dependencies you can use the following command to run php code standards checks:
./vendor/bin/phpcs
Install composer
, git
, npm
, svn
, and either wget
or curl
.
Change to the plugin root directory and type:
$ composer install
Change to the plugin root directory and type:
$ npm install && npm run dev
To run the unit tests you need WordPress, WooCommerce, and the WordPress Unit Test lib (included in the core development repository).
Install them using the install-wp-tests.sh
script:
$ ./bin/install-wp-tests.sh <db-name> <db-user> <db-pass> <db-host>
Example:
$ ./bin/install-wp-tests.sh wordpress_tests root root localhost
This script installs the test dependencies into your system's temporary directory and also creates a test database.
You can also specify the path to their directories by setting the following environment variables:
WP_TESTS_DIR
: WordPress Unit Test lib directoryWP_CORE_DIR
: WordPress core directoryWC_DIR
: WooCommerce directory
Change to the plugin root directory and type:
$ vendor/bin/phpunit
The tests will execute and you'll be presented with a summary.
E2E testing uses wp-env which requires Docker.
Make sure Docker is running in your machine, and run the following:
npm run wp-env:up
- This will automatically download and run WordPress in a Docker container. You can access it at http://localhost:8889 (Username: admin, Password: password).
To install the PlayWright browser locally you can run:
npx playwright install chromium
Run E2E testing:
npm run test:e2e
to run the test in headless mode.npm run test:e2e-dev
to run the tests in Chromium browser.
To remove the Docker container and images (this will delete everything in the WordPress Docker container):
npm run wp-env destroy
release/*
branches or pushing changes to release/*
branches. To run it manually, please visit here and follow this instruction to do so.
By default the latest version of WordPress will be installed. WP_ENV_CORE
can be used to install a specific version.
WP_ENV_CORE=WordPress/WordPress#6.2.2 npm run wp-env:up
This does not work with Release Candidate versions as the tag is not available. Instead we can bring the wp-env:up
with the latest version and then upgrade WordPress through WP CLI.
npm run -- wp-env run tests-cli -- wp core update --version=6.3-RC3
npm run -- wp-env run tests-cli -- wp core update-db
WooCommerce is installed through WP CLI so we can use this to update to a newer version like a release candidate.
npm run -- wp-env run tests-cli -- wp plugin update woocommerce --version=8.0.0-rc.1
npm run -- wp-env run tests-cli -- wp wc update
The new Google Ads API Client Library version is now available with PHP 7.4 support under this "legacy" branch.
We are using it in composer in order to support PHP 7.4.
Going forward, Google will always add the prefix "legacy-" for the branch supporting PHP 7.4.
Made with 💜 by Woo.
We're hiring! Come work with us!