Skip to content

docs: set the WordPress and WooCommerce floors #5

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
MobileMage merged 2 commits into from
Oct 4, 2026
Merged

docs: set the WordPress and WooCommerce floors #5

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
59951e2
docs: set the WordPress and WooCommerce floors
MobileMage Oct 3, 2026
33e2e20
Merge origin/main into docs/wordpress-floors
MobileMage Oct 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions CONTEXT.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -169,6 +169,10 @@ _Avoid_: input, widget, picker
To show the user what a postcode points to before the app stores it.
_Avoid_: verify, validate (for this step)

**Check status**:
What the WooCommerce plugin learned about the postcode of an order: `valid`, `invalid`, `unchecked` or `error`. The order meta `_gatepost_postcode_check` holds it.
_Avoid_: verification status, validation result

**Form value**:
The text that a field gives its form when the form is sent: the canonical form of a postcode, the 6 digits of a legacy postcode, or the text without white space at the start and the end.
_Avoid_: submitted value, output
Expand Down
5 changes: 3 additions & 2 deletions standards/languages/php.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# PHP standards

Version 1.0, 1 Oct 2026.
Version 1.1, 3 Oct 2026.

This file and `standards/CODING_STANDARDS.md` together are the standard for PHP code. Part A applies to the SDK in the `php` repo. Part B applies to WordPress plugins, such as the WooCommerce plugin. Each part names its own code style, because the two ecosystems use different conventions.

Expand All @@ -9,7 +9,8 @@ This file and `standards/CODING_STANDARDS.md` together are the standard for PHP
- PHP 8.1 or later. CI tests PHP 8.1 and the newest PHP release.
- PHP 8.1 reached end of life on 31 Dec 2025, and PHP 8.2 reaches it on 31 Dec 2026. The 8.1 floor serves WordPress stores on older hosting. Under VER-1, ADR 0001 must record this trade-off with current WordPress usage data before the first release. If the data does not support 8.1, raise the floor.
- PHPUnit 11 and later need PHP 8.2. CI runs PHPUnit 10 on PHP 8.1 and the newest PHPUnit on newer PHP versions.
- WordPress and WooCommerce: the floors are not defined yet. The team sets them after it tests the Additional Checkout Fields API, and before the first release of a plugin.
- WordPress 6.7 and WooCommerce 10.0 or later. WooCommerce 10.0 is the first release whose checkout block skips a hidden address field on the server. On 9.9, a required field that a rule hides still stopped the order. WooCommerce 10.0 needs WordPress 6.7. ADR 0002 of the `woocommerce` repo holds the test results and the usage data.
- WordPress's test suite runs only on PHPUnit 9, so the tests of a WordPress plugin use PHPUnit 9.6 on every PHP version.

## Part A: the SDK

Expand Down