Changeset 61602 for trunk/src/wp-includes/abilities-api/class-wp-ability.php

Timestamp:

02/09/2026 04:59:52 PM (2 months ago)

Author:

jorgefilipecosta

Message:

Abilities API: Allow nested namespace ability names (2-4 segments).

Expand ability name validation from exactly 2 segments (namespace/ability) to 2-4 segments, enabling names like my-plugin/resource/find and my-plugin/resource/sub/find.
This allows plugins to organize abilities into logical resource groups. The validation regex changes from /^[a-z0-9-]+\/[a-z0-9-]+$/ to /^[a-z0-9-]+(?:\/[a-z0-9-]+){1,3}$/, which accepts the first segment plus 1-3 additional slash-delimited segments.
Updates the validation regex, error messages, docblocks, and adds corresponding unit and REST API tests.

Props jorgefilipecosta, justlevine, jorbin.
Fixes #64596.

File:

• trunk/src/wp-includes/abilities-api/class-wp-ability.php (modified) (2 diffs)

trunk/src/wp-includes/abilities-api/class-wp-ability.php

@@ -53 +53 @@
     /**
      * The name of the ability, with its namespace.
-     * Example: `my-plugin/my-ability`.
+     * Examples: `my-plugin/my-ability`, `my-plugin/resource/find`.
      *
      * @since 6.9.0
@@ -341 +341 @@
     /**
      * Retrieves the name of the ability, with its namespace.
-     * Example: `my-plugin/my-ability`.
+     * Examples: `my-plugin/my-ability`, `my-plugin/resource/find`.
      *
      * @since 6.9.0