A customizable, open-source ecommerce platform built on WordPress. Build any commerce solution you can imagine.
Go to file
Alfredo Sumaran 9bb7cd7b8b
Apply Rector suggestions for PHP 8.1 (#41482)
* Apply Rector suggestions

* Add changefile(s) from automation for the following project(s): woocommerce

* Restore false positive

$missing_tables will always be an array

* Restore false positive.

Rector issue: AddDefaultValueForUndefinedVariableRector.

This time the early return is valid so there’s no need to move the $process_limit assignment to the top.

* Ask if $orders is an array

$orders is used as an array lines below. Add `is_array` just in case the “paginate” param is used which would change $orders to an object.

* Check if variable is array

Simplifies variable check given that they are used as an array lines below.

* Restore code as taxes is always an array

* Restore false positive

In the previous loop the $data variable is being built as an array of arrays. Then $value in this loop will allways be array.

* Restore false positive

get_children’s method. of a WC_Product instance will always return an array.

* Simplify variable check

Ask if varialbe is array since it only can be array or false.

* Restore false positive

WC_Blocks_Utils::get_blocks_from_page() will always return an array.

* Restore false positive

There’s a check asking if $existing_meta_data[ $meta_data->key ] is array.

* Restore false positive

$child_ids will always be an array.

* Restore false positives

WC_Product->get_visible_children() will always return an array.

* Restore false positives

WC_Product->get_children() will always return an array.

* Restore false positive

WC_Product->get_visible_children() will always return an array.

* Restore false positive

WC_Order->get_items() will always return an array.

* Restore false positive

The get_matching_rates private method will always return an array.

Updated the @return declaration to be an array instead of boolean.

* Remove unnecessary array type casting.

* Restore false positive

$this->get_children() will always return an array.

* Fix lint issues

* Remove unnecessary default assignment

* Remove unnecessary is_array check

* Remove unnecessary is_array check

* Remove unnecessary is_array check

* Change default value from null to false

* Remove unnecessary is_array check

* Update changelog entry

* Update changelog entry

* Update changelog entry

* Add changefile(s) from automation for the following project(s): woocommerce

* Update changelog entry

* Use self for consistency

---------

Co-authored-by: github-actions <github-actions@github.com>
2024-02-01 10:06:12 +00:00
.github Fix post-merge CI / update ci-jobs util to make base-ref optional (#44055) 2024-01-26 13:52:55 -06:00
.husky Remove the post-checkout hook it was causing too much friction. (#37024) 2023-03-03 12:43:18 +13:00
bin Migrate Puppeteer test action from Blocks repo (#42733) 2023-12-13 16:01:34 -08:00
changelog Create changelog/39948-patch-4 2023-09-27 10:01:56 +01:00
docs [e2e tests] Add downloadable product test (#44112) 2024-01-31 17:51:14 +02:00
packages Prepare Packages for Release (#44211) 2024-01-31 18:58:06 +13:00
plugins Apply Rector suggestions for PHP 8.1 (#41482) 2024-02-01 10:06:12 +00:00
tools [e2e tests] Add downloadable product test (#44112) 2024-01-31 17:51:14 +02:00
.codecov.yml Turn on code-cov for PR checking of unit test coverage (#36548) 2023-02-09 22:08:36 +13:00
.editorconfig JS formatting files 2021-10-19 10:35:46 +13:00
.eslintignore JS formatting files 2021-10-19 10:35:46 +13:00
.eslintrc.js Designate root level eslint config 2021-12-13 08:13:40 -08:00
.gitattributes Use `ci-jobs` Utility For `ci.yml` Matrix (#43532) 2024-01-12 20:32:14 -08:00
.gitignore Migrate merchant local-pickup e2e tests to Playwright (#43057) 2024-01-11 21:25:12 +07:00
.markdownlint.json Add reusable blocks documentation for remaining blocks (#40521) 2023-10-03 12:49:46 +00:00
.markdownlintignore undo changes to test fixtures 2023-11-10 15:49:08 +01:00
.npmrc Upgrade to pnpm 7 (#34661) 2022-09-16 09:21:42 +12:00
.nvmrc Update package and node version 2021-12-15 07:08:37 -08:00
.pnpmfile.cjs Optimized `wireit` Fingerprinting File Inputs (#42684) 2023-12-11 16:21:35 -08:00
.prettierrc.js JS formatting files 2021-10-19 10:35:46 +13:00
.stylelintrc Deprecate stylelint-config-wordpress with current package 2021-12-14 09:14:54 -08:00
.syncpackrc Update `wireit` & Optimize Builds (#43595) 2024-01-15 14:06:55 -08:00
CODEOWNERS Add codeowners file (#35765) 2022-11-29 13:18:45 -08:00
CODE_OF_CONDUCT.md appease the linter 2023-11-06 14:20:05 +01:00
DEVELOPMENT.md Removed Unnecessary `run` From `pnpm` 2023-12-09 14:36:22 -08:00
README.md Removed Unnecessary `run` From `pnpm` 2023-12-09 14:36:22 -08:00
SECURITY.md replace developer.woocommerce.com with developer.woo.com 2023-11-10 16:09:27 +01:00
changelog.txt Update changelog.txt from release 8.5.2 (#44095) 2024-01-25 20:22:24 +00:00
package.json Update `wireit` & Optimize Builds (#43595) 2024-01-15 14:06:55 -08:00
phpcs.xml add exclusion for short array syntax 2023-12-14 10:07:41 -04:00
pnpm-lock.yaml Update eslint parser to @babel/eslint-parser (#43859) 2024-01-24 13:06:51 +02:00
pnpm-workspace.yaml Performance: Add a tool and a CI workflow to compare performance between PR and trunk and track metrics on trunk 2023-12-14 10:48:15 +01:00
renovate.json Converted Spaces To Tabs In JSON 2022-05-10 13:31:01 -07:00
tsconfig.base.json Removed TypeScript Incremental Build Support (#37374) 2023-03-23 11:25:42 -07:00

README.md

WooCommerce Monorepo

WooCommerce

Welcome to the WooCommerce Monorepo on GitHub. Here you can find all of the plugins, packages, and tools used in the development of the core WooCommerce plugin as well as WooCommerce extensions. You can browse the source, look at open issues, contribute code, and keep tracking of ongoing development.

We recommend all developers to follow the WooCommerce development blog to stay up to date about everything happening in the project. You can also follow @DevelopWC on Twitter for the latest development updates.

Getting Started

To get up and running within the WooCommerce Monorepo, you will need to make sure that you have installed all of the prerequisites.

Prerequisites

  • NVM: While you can always install Node through other means, we recommend using NVM to ensure you're aligned with the version used by our development teams. Our repository contains an .nvmrc file which helps ensure you are using the correct version of Node.
  • PNPM: Our repository utilizes PNPM to manage project dependencies and run various scripts involved in building and testing projects.
  • PHP 7.4+: WooCommerce Core currently features a minimum PHP version of 7.4. It is also needed to run Composer and various project build scripts. See troubleshooting for troubleshooting problems installing PHP.
  • Composer: We use Composer to manage all of the dependencies for PHP packages and plugins.

Once you've installed all of the prerequisites, you can run the following commands to get everything working.

# Ensure that you're using the correct version of Node
nvm use
# Install the PHP and Composer dependencies for all of the plugins, packages, and tools
pnpm install
# Build all of the plugins, packages, and tools in the monorepo
pnpm build

At this point you are now ready to begin developing and testing. All of the build outputs are cached running pnpm build again will only build the plugins, packages, and tools that have changed since the last time you ran the command.

Check out our development guide if you would like a more comprehensive look at working in our repository.

Repository Structure

  • Plugins: Our repository contains plugins that relate to or otherwise aid in the development of WooCommerce.
    • WooCommerce Core: The core WooCommerce plugin is available in the plugins directory.
  • Packages: Contained within the packages directory are all of the PHP and JavaScript provided for the community. Some of these are internal dependencies and are marked with an internal- prefix.
  • Tools: We also have a growing number of tools within our repository. Many of these are intended to be utilities and scripts for use in the monorepo, but, this directory may also contain external tools.

Reporting Security Issues

To disclose a security issue to our team, please submit a report via HackerOne here.

Support

This repository is not suitable for support. Please don't use our issue tracker for support requests, but for core WooCommerce issues only. Support can take place through the appropriate channels:

NOTE: Unfortunately, we are unable to honor support requests in issues on this repository; as a result, any requests submitted in this manner will be closed.

Community

For peer to peer support, real-time announcements, and office hours, please join our slack community!

Contributing to WooCommerce

If you have a patch or have stumbled upon an issue with WooCommerce core, you can contribute this back to the code. Please read our contributor guidelines for more information on how you can do this.