From e76b1a2d78ada0465d9dbb458921d0d4600aeee9 Mon Sep 17 00:00:00 2001 From: Sergey Biryukov Date: Sun, 19 Oct 2025 19:47:32 +0000 Subject: [PATCH] Docs: Correct DocBlock formatting for `pre_site_option` filter. Includes bringing some consistency with the `pre_option` filter DocBlock. . Follow-up to [54145], [54948], [60959]. Props mukesh27, SergeyBiryukov. See #37930, #63166. Built from https://develop.svn.wordpress.org/trunk@60978 git-svn-id: http://core.svn.wordpress.org/trunk@60314 1a063a9b-81f0-0310-95a4-ce76da25c4cd --- wp-includes/option.php | 20 ++++++++++---------- wp-includes/version.php | 2 +- 2 files changed, 11 insertions(+), 11 deletions(-) diff --git a/wp-includes/option.php b/wp-includes/option.php index 1bc590acd6..7cb4736c28 100644 --- a/wp-includes/option.php +++ b/wp-includes/option.php @@ -132,7 +132,7 @@ function get_option( $option, $default_value = false ) { $pre = apply_filters( "pre_option_{$option}", false, $option, $default_value ); /** - * Filters the value of all existing options before it is retrieved. + * Filters the value of any existing option before it is retrieved. * * Returning a value other than false from the filter will short-circuit retrieval * and return that value instead. @@ -2038,21 +2038,21 @@ function get_network_option( $network_id, $option, $default_value = false ) { $pre = apply_filters( "pre_site_option_{$option}", false, $option, $network_id, $default_value ); /** - * Filters the value of an existing network options before it is retrieved. + * Filters the value of any existing network option before it is retrieved. * * Returning a value other than false from the filter will short-circuit retrieval * and return that value instead. * * @since 6.9.0 * - * @param mixed $pre The value to return instead of the network option value. This differs - * from `$default`, which is used as the fallback value in the event - * the option doesn't exist elsewhere in get_network_option(). - * Default false (to skip past the short-circuit). - * @param string $option Name of the option. - * @param int $network_id ID of the network. - * @param mixed $default_value The fallback value to return if the option does not exist. - * Default false. + * @param mixed $pre_option The value to return instead of the network option value. This differs + * from `$default_value`, which is used as the fallback value in the event + * the option doesn't exist elsewhere in get_network_option(). + * Default false (to skip past the short-circuit). + * @param string $option Name of the option. + * @param int $network_id ID of the network. + * @param mixed $default_value The fallback value to return if the option does not exist. + * Default false. */ $pre = apply_filters( 'pre_site_option', $pre, $option, $network_id, $default_value ); diff --git a/wp-includes/version.php b/wp-includes/version.php index 8105451851..f8ed1d08a4 100644 --- a/wp-includes/version.php +++ b/wp-includes/version.php @@ -16,7 +16,7 @@ * * @global string $wp_version */ -$wp_version = '6.9-alpha-60977'; +$wp_version = '6.9-alpha-60978'; /** * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.