We have officially announced the L-2 version support policy for WooCommerce and WordPress core since May 2021.
However, in the practice, we're really enforcing only WordPress core with the Requires at least
in readme.txt
and woocommerce-payments.php
.
For WooCommerce, we are yet to fully support this L-2 policy. The real minimum WooCommerce version can be found on woocommerce-payments.php
with the WC requires at least
tag. There are two main reasons for this:
- There is no reliable built-in functionality that prevents a merchant from installing the latest version of WooCommerce Payments (WCPay) with an unsupported WooCommerce version. To deal with this issue, we continue loading WCPay if sites have an active WCPay account, but nudge their owners to upgrade WooCommerce. More details in this PR, which is later refactored to
WC_Payments_Dependency_Service
. - Some of our internal consumers are also not yet using the latest version of WooCommerce. See paJDYF-3fF-p2#comment-9591
As a contributor to WCPay, you would be mindful when adding new features and functions to your PRs as your code needs to work within proper ranges of WordPress and WooCommerce versions. Although we have a CI workflow to check the compatibility between WCPay and these ranges, it's still good for contributors to be aware of this policy.
We have no ETA for this yet, and you're recommended to check the current minimum WooCommerce version in the code at the moment of writing your code. That said, we're working on a few approaches to reduce the gap between the real minimum supported version and the L-2 version. paJDYF-3fF-p2