Changeset 61602 for trunk/tests/phpunit/tests/rest-api/wpRestAbilitiesV1RunController.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/tests/phpunit/tests/rest-api/wpRestAbilitiesV1RunController.php (modified) (2 diffs)

trunk/tests/phpunit/tests/rest-api/wpRestAbilitiesV1RunController.php

@@ -380 +380 @@
         );
 
+        // Ability with nested namespace (3 segments).
+        $this->register_test_ability(
+            'test/math/add',
+            array(
+                'label'               => 'Nested Add',
+                'description'         => 'Adds numbers with nested namespace',
+                'category'            => 'math',
+                'input_schema'        => array(
+                    'type'                 => 'object',
+                    'properties'           => array(
+                        'a' => array(
+                            'type'        => 'number',
+                            'description' => 'First number',
+                        ),
+                        'b' => array(
+                            'type'        => 'number',
+                            'description' => 'Second number',
+                        ),
+                    ),
+                    'required'             => array( 'a', 'b' ),
+                    'additionalProperties' => false,
+                ),
+                'output_schema'       => array(
+                    'type' => 'number',
+                ),
+                'execute_callback'    => static function ( array $input ) {
+                    return $input['a'] + $input['b'];
+                },
+                'permission_callback' => static function () {
+                    return current_user_can( 'edit_posts' );
+                },
+                'meta'                => array(
+                    'show_in_rest' => true,
+                ),
+            )
+        );
+
         // Read-only ability for query params testing.
         $this->register_test_ability(
@@ -431 +468 @@
         $this->assertEquals( 200, $response->get_status() );
         $this->assertEquals( 8, $response->get_data() );
+    }
+
+    /**
+     * Test executing an ability with a nested namespace (3 segments) via REST.
+     *
+     * @ticket 64098
+     */
+    public function test_execute_nested_namespace_ability(): void {
+        $request = new WP_REST_Request( 'POST', '/wp-abilities/v1/abilities/test/math/add/run' );
+        $request->set_header( 'Content-Type', 'application/json' );
+        $request->set_body(
+            wp_json_encode(
+                array(
+                    'input' => array(
+                        'a' => 10,
+                        'b' => 7,
+                    ),
+                )
+            )
+        );
+
+        $response = $this->server->dispatch( $request );
+
+        $this->assertEquals( 200, $response->get_status() );
+        $this->assertEquals( 17, $response->get_data() );
     }