• 3.5.0 1086e369e3

    v3.5.0 Stable

    javier released this 2026-11-03 17:07:02 +00:00 | 2 commits to main since this release

    3.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 /effective endpoint and the core XML sitemaps.
    • Compatibility window narrowed to WordPress 7.0 - 7.2 and PHP 8.3 - 8.6: Requires at least raised from 4.7 to 7.0, Requires PHP raised from 5.6 to 8.3, Tested up to set 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; --context filter renamed to --only to 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 generic page bucket. 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 page context 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=1 drop out of the pages sitemap even when the page context 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 private noindex-seo icon 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.xml testVersion 8.3-8.6 and minimum_supported_wp_version 7.0, phpstan.neon phpVersion 80300, bin/preflight.sh gates scanning the declared range, composer.json PHP constraint >=8.3, and the obsolete WPCompat.* 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 audit clean).
    • 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 list was broken on real WP-CLI installs since 3.4.0: the output call went to WP_CLI\Utils::format_items() (a static method that does not exist — the real API is the namespaced WP_CLI\Utils\format_items() function), and the --context filter parameter collided with the --context global 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 every wp noindex-seo command 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