Changeset 63391

Timestamp:

08/28/2026 11:09:30 AM (3 weeks ago)

Author:

gziolo

Message:

Abilities API: Add missing @since 7.1.0 changelog entries

Document the 7.1 changes to existing docblocks that had no changelog line: the public meta argument, the wp_ability_validate_input and wp_ability_validate_output filters, exception handling in invoke_callback(), and the new schema property and collection parameters in the REST list controller.

Follow-up to [62238], [62398], [62420], [62548], [62729], [62737].

Props khokansardar.
See #65058, #64311, #64990, #65568.

Location:

trunk/src/wp-includes

Files:

• abilities-api.php (modified) (1 diff)
• abilities-api/class-wp-abilities-registry.php (modified) (2 diffs)
• abilities-api/class-wp-ability.php (modified) (5 diffs)
• rest-api/endpoints/class-wp-rest-abilities-v1-list-controller.php (modified) (2 diffs)

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

@@ -233 +233 @@
  *
  * @since 6.9.0
+ * @since 7.1.0 Added the `public` meta argument.
  * @since 7.2.0 The `category` argument is now optional and defaults to `uncategorized`.
  *

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

@@ -41 +41 @@
          *
          * @since 6.9.0
+         * @since 7.1.0 Added the `public` meta argument.
          * @since 7.2.0 The `category` argument is now optional and defaults to `uncategorized`.
          *
@@ -111 +112 @@
                  *
                  * @since 6.9.0
+                 * @since 7.1.0 Added the `public` meta argument.
                  * @since 7.2.0 The `category` argument is now optional and defaults to `uncategorized`.
                  *

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

@@ -140 +140 @@
          *
          * @since 6.9.0
+         * @since 7.1.0 Added the `public` meta argument.
          *
          * @see wp_register_ability()
@@ -210 +211 @@
          *
          * @since 6.9.0
+         * @since 7.1.0 Added the `public` meta argument.
          *
          * @see WP_Abilities_Registry::register()
@@ -513 +515 @@
          *
          * @since 6.9.0
+         * @since 7.1.0 Added the `wp_ability_validate_input` filter.
          *
          * @param mixed $input Optional. The input data to validate. Default `null`.
@@ -578 +581 @@
          *
          * @since 6.9.0
+         * @since 7.1.0 Exceptions thrown by the callback are now caught and returned as a `WP_Error`.
          *
          * @param callable $callback The callable to invoke.
@@ -706 +710 @@
          *
          * @since 6.9.0
+         * @since 7.1.0 Added the `wp_ability_validate_output` filter.
          *
          * @param mixed $output The output data to validate.

trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-abilities-v1-list-controller.php

@@ -245 +245 @@
          *
          * @since 6.9.0
+         * @since 7.1.0 Added the `meta.public` property.
          *
          * @return array<string, mixed> Item schema data.
@@ -331 +332 @@
          *
          * @since 6.9.0
+         * @since 7.1.0 Added the `namespace` and `meta` parameters and the `rest_abilities_collection_params` filter.
          *
          * @return array<string, mixed> Collection parameters.