-
v3.5.0 Stable
released this
2026-11-03 17:07:02 +00:00 | 2 commits to main since this release3.5.0
Release date: 2026-11-03
Highlights
- WooCommerce special-page contexts (TODO #8): dedicated directives for the WooCommerce Cart, Checkout and My Account pages, detected through the page-ID options (no WooCommerce code needed), recommended by default, and mirrored across the front-end, the REST
/effectiveendpoint and the core XML sitemaps. - Compatibility window narrowed to WordPress 7.0 - 7.2 and PHP 8.3 - 8.6:
Requires at leastraised from 4.7 to 7.0,Requires PHPraised from 5.6 to 8.3,Tested up toset to WordPress 7.2 (verified on 7.2-beta3) and PHP support documented through 8.6 (verified on 8.6.0RC3). - Fixed
wp noindex-seo list, which fatalled on every real WP-CLI invocation since 3.4.0 (nonexistent static API call;--contextfilter renamed to--onlyto avoid WP-CLI 2.11+'s reserved global flag). - Directive icons modernized for the SVG era: on WordPress 7.2+ the five directive icons render through the core Icons API — the same system WordPress 7.2 uses for its own admin chrome — while WordPress 7.0 - 7.1 keep the legacy emoji glyphs as a retrocompatible fallback.
Added
- WooCommerce contexts (
woo_cart,woo_checkout,woo_myaccount): the Cart, Checkout and My Account pages are regular pages that conventionally deserve noindex but previously fell into the genericpagebucket. Each now has its own context with all five directives, a "WooCommerce" section on the SEO Settings tab (rendered only when the store pages are configured), and Recommended badges — the three contexts also joined the "Apply Recommended Defaults" set (now 15 contexts). - Detection is option-driven (
woocommerce_cart_page_id,woocommerce_checkout_page_id,woocommerce_myaccount_page_id): no WooCommerce class or function dependency; without WooCommerce the contexts are inert. My Account endpoints (order history, addresses) and the checkout order-pay / order-received endpoints share their parent page's ID, so they are covered automatically. - Precedence: the dedicated contexts run before the generic
pagecontext on the front-end and in/wp-json/noindex-seo/v1/effective, so a Woo page with directives gets them instead of the page-level ones; with no dedicated directives the page context still applies. - Sitemap: special pages whose context has
noindex=1drop out of the pages sitemap even when thepagecontext is not noindexed. - SVG directive icons (retrocompatible). The five robots-directive icons render as color-adaptive 16px SVGs through the WordPress Icons API (
wp_register_icon()/wp_get_icon()), registered in a privatenoindex-seoicon collection — everywhere they appear: the settings grid, the post meta box, Quick Edit, and the post and taxonomy list-table Robots columns. The SVG path is gated to WordPress 7.2+, whose icon sanitizer understands the stroke-based designs (rect/circle,stroke*attributes) and whose registry supports private collections; on WordPress 7.0 - 7.1 the legacy emoji glyphs remain (7.1's narrower sanitizer would strip the SVGs to unstyled fragments), so rendering stays correct on every supported version — and consistent on every OS, unlike the emoji (which each platform draws differently). Follows the core direction of replacing admin dashicons with SVG (wordpress-develop#12270, landed in WP 7.2's admin chrome). The Quick Edit label strings dropped their emoji prefix; the plain directive names were already in the translation catalogs, so no translations were lost.
Changed
- Compatibility window: WordPress 7.0 - 7.2 (was 4.7 - 7.2), PHP 8.3 - 8.6 (was 5.6 - 8.5). The full-range PHPCompatibility scan (PHP 5.6 - 8.6) still passes clean — the code keeps its PHP 5.6-parseable syntax — but the declared and supported window is now 7.0 / 8.3 and up, per the product support policy. The runtime guards for WordPress APIs older than 7.0 remain in place as harmless no-ops and may be removed in 4.0.
- Tooling aligned with the new window:
phpcs.xmltestVersion8.3-8.6 andminimum_supported_wp_version7.0,phpstan.neonphpVersion80300,bin/preflight.shgates scanning the declared range,composer.jsonPHP constraint>=8.3, and the obsoleteWPCompat.*PHPStan ignores removed (every guarded hook exists since 7.0). - Development dependencies refreshed via
composer update: PHPUnit 9.6.38, PHPStan 2.3.5, wordpress-stubs 7.1.2 (no CVEs;composer auditclean). - The "Apply Recommended Defaults" set grew from 12 to 15 contexts (button title and description updated; existing configurations are untouched — the button is opt-in).
Fixed
wp noindex-seo listwas broken on real WP-CLI installs since 3.4.0: the output call went toWP_CLI\Utils::format_items()(a static method that does not exist — the real API is the namespacedWP_CLI\Utils\format_items()function), and the--contextfilter parameter collided with the--contextglobal flag reserved by WP-CLI 2.11+, so the value never reached the handler. The filter is now--only=<context>and the command renders through the real function API. The unit-test stub was aligned with the real WP-CLI surface (namespaced function, not a Utils class), and everywp noindex-seocommand was smoke-tested against the real WP-CLI 2.12 phar.
Security
- No security changes; the new contexts reuse the consolidated settings storage and existing sanitization paths, and PHPCS/PHPStan/composer audit stay clean.
Compatibility
- WordPress: 7.0 - 7.2
- PHP: 8.3 - 8.6
Tests
- PHPUnit: 9.6.38 (198 tests, 817 assertions, all passing) on the WordPress 7.2-beta3 test library, run under PHP 8.3, 8.4, 8.5 and 8.6.0RC3 — including the icon registration, SVG rendering, emoji fallback and admin-markup tests.
- PHPCompatibility: 0 errors on the declared range 8.3-8.6 and on the full review range 5.6-8.6.
- PHPCS (WordPress-Core, WordPress-Docs, WordPress-Extra) and PHPStan level 9: 0 errors.
Downloads
- WooCommerce special-page contexts (TODO #8): dedicated directives for the WooCommerce Cart, Checkout and My Account pages, detected through the page-ID options (no WooCommerce code needed), recommended by default, and mirrored across the front-end, the REST