Abilities API: Update the core/settings-get @SInCE tags to 7.2.0.

WordPress 7.1 has shipped, so the ability and the `show_in_abilities`
setting argument now target 7.2.0.

Author: jorgefilipecosta

src/wp-includes/abilities/class-wp-settings-abilities.php

@@ -4,7 +4,7 @@
  *
  * @package WordPress
  * @subpackage Abilities API
- * @since 7.1.0
+ * @since 7.2.0
  */
 
 declare( strict_types = 1 );
@@ -34,7 +34,7 @@
  * not part of the public API. It may be changed or removed at any time without notice.
  * Do not use it directly or rely on its existence.
  *
- * @since 7.1.0
+ * @since 7.2.0
  *
  * @access private
  */
@@ -43,7 +43,7 @@ final class WP_Settings_Abilities {
 	/**
 	 * The ability category used for settings abilities.
 	 *
-	 * @since 7.1.0
+	 * @since 7.2.0
 	 * @var string
 	 */
 	private const CATEGORY = 'site';
@@ -54,7 +54,7 @@ final class WP_Settings_Abilities {
 	 * Cached so the input/output schema and the executed result derive from the exact same
 	 * structure, and {@see get_registered_settings()} is only walked once per request.
 	 *
-	 * @since 7.1.0
+	 * @since 7.2.0
 	 * @var array<string, array{option: string, group: string, default: mixed, schema: array<string, mixed>}>|null
 	 */
 	private $exposed_settings = null;
@@ -64,7 +64,7 @@ final class WP_Settings_Abilities {
 	 *
 	 * Must run on the `wp_abilities_api_init` hook.
 	 *
-	 * @since 7.1.0
+	 * @since 7.2.0
 	 */
 	public function register(): void {
 		/*
@@ -97,7 +97,7 @@ public function register(): void {
 	/**
 	 * Registers the read-only `core/settings-get` ability.
 	 *
-	 * @since 7.1.0
+	 * @since 7.2.0
 	 */
 	private function register_get_settings(): void {
 		// Compute once; execute_get_settings() reuses this exact structure.
@@ -145,7 +145,7 @@ private function register_get_settings(): void {
 	/**
 	 * Executes the `core/settings-get` ability.
 	 *
-	 * @since 7.1.0
+	 * @since 7.2.0
 	 *
 	 * @param mixed $input Optional. The ability input. Default empty array.
 	 * @return array<string, mixed> Map of exposed setting name to current value.
@@ -184,7 +184,7 @@ public function execute_get_settings( $input = array() ): array {
 	/**
 	 * Checks whether the current user may use the settings abilities.
 	 *
-	 * @since 7.1.0
+	 * @since 7.2.0
 	 *
 	 * @return bool True if the current user can manage options.
 	 */
@@ -198,7 +198,7 @@ public function has_permission(): bool {
 	 * Both `group` and `fields` are optional; supplying both narrows the response to their
 	 * intersection, and supplying neither returns every exposed setting.
 	 *
-	 * @since 7.1.0
+	 * @since 7.2.0
 	 *
 	 * @param list<string> $groups      Available settings groups.
 	 * @param list<string> $field_names Available exposed setting names.
@@ -236,7 +236,7 @@ private function get_settings_input_schema( array $groups, array $field_names ):
 	 * underlying option name, the settings group, the registration default, and a JSON Schema
 	 * describing the value.
 	 *
-	 * @since 7.1.0
+	 * @since 7.2.0
 	 *
 	 * @return array<string, array{option: string, group: string, default: mixed, schema: array<string, mixed>}> Settings keyed by exposed name.
 	 */
@@ -266,7 +266,7 @@ private function get_exposed_settings(): array {
 	/**
 	 * Builds the JSON Schema describing a single setting's value.
 	 *
-	 * @since 7.1.0
+	 * @since 7.2.0
 	 *
 	 * @param array<string, mixed>      $args The setting registration arguments.
 	 * @param bool|array<string, mixed> $show The setting's `show_in_abilities` value.
@@ -294,7 +294,7 @@ private function value_schema( array $args, $show ): array {
 	/**
 	 * Casts a stored option value to the type declared in its settings registration.
 	 *
-	 * @since 7.1.0
+	 * @since 7.2.0
 	 *
 	 * @param mixed  $value The raw option value.
 	 * @param string $type  The registered setting type.

src/wp-includes/option.php

@@ -2740,7 +2740,7 @@ function set_site_transient( $transient, $value, $expiration = 0 ) {
  * @since 4.7.0
  * @since 6.0.1 The `show_on_front`, `page_on_front`, and `page_for_posts` options were added.
  * @since 7.2.0 The `wp_page_for_privacy_policy` option was registered, exposed as `page_for_privacy_policy`.
- * @since 7.1.0 Added `show_in_abilities` support for the exposed settings.
+ * @since 7.2.0 Added `show_in_abilities` support for the exposed settings.
  */
 function register_initial_settings() {
 	register_setting(
@@ -3015,7 +3015,7 @@ function register_initial_settings() {
  * @since 5.5.0 `$new_whitelist_options` was renamed to `$new_allowed_options`.
  *              Please consider writing more inclusive code.
  * @since 6.6.0 Added the `label` argument.
- * @since 7.1.0 Added the `show_in_abilities` argument.
+ * @since 7.2.0 Added the `show_in_abilities` argument.
  *
  * @global array $new_allowed_options
  * @global array $wp_registered_settings
@@ -3249,7 +3249,7 @@ function unregister_setting( $option_group, $option_name, $deprecated = '' ) {
  * Retrieves an array of registered settings.
  *
  * @since 4.7.0
- * @since 7.1.0 Registered setting data includes the `show_in_abilities` argument.
+ * @since 7.2.0 Registered setting data includes the `show_in_abilities` argument.
  *
  * @global array $wp_registered_settings
  *

tests/phpunit/tests/abilities-api/wpRegisterCoreSettingsGetAbility.php

@@ -34,7 +34,7 @@ class Tests_Abilities_API_WpRegisterCoreSettingsGetAbility extends WP_UnitTestCa
 	 * that uses the Abilities API before the REST server loads. The ability must
 	 * self-register core's initial settings (see WP_Settings_Abilities::register()).
 	 *
-	 * @since 7.1.0
+	 * @since 7.2.0
 	 */
 	public static function set_up_before_class(): void {
 		parent::set_up_before_class();
@@ -72,7 +72,7 @@ public static function set_up_before_class(): void {
 	/**
 	 * Tear down after the class.
 	 *
-	 * @since 7.1.0
+	 * @since 7.2.0
 	 */
 	public static function tear_down_after_class(): void {
 		add_action( 'wp_abilities_api_categories_init', '_unhook_core_ability_categories_registration', 1 );