From 3ffa7459918cf5b0c748010317b01d268d5b358b Mon Sep 17 00:00:00 2001 From: Weston Ruter Date: Mon, 22 Aug 2016 00:40:15 +0000 Subject: [PATCH] Docs: Update outdated phpdoc for `WP_Customize_Manager::validate_setting_values()` to reflect changes in [37942]. Props dlh. See #37247. Fixes #37759. git-svn-id: https://develop.svn.wordpress.org/trunk@38299 602fd350-edb4-49c9-b593-d223f7449a82 --- src/wp-includes/class-wp-customize-manager.php | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/src/wp-includes/class-wp-customize-manager.php b/src/wp-includes/class-wp-customize-manager.php index 09e48b290c..daa5884512 100644 --- a/src/wp-includes/class-wp-customize-manager.php +++ b/src/wp-includes/class-wp-customize-manager.php @@ -991,9 +991,10 @@ final class WP_Customize_Manager { /** * Validates setting values. * - * Sanitization is applied to the values before being passed for validation. * Validation is skipped for unregistered settings or for values that are - * already null since they will be skipped anyway. + * already null since they will be skipped anyway. Sanitization is applied + * to values that pass validation, and values that become null or `WP_Error` + * after sanitizing are marked invalid. * * @since 4.6.0 * @access public @@ -1001,7 +1002,7 @@ final class WP_Customize_Manager { * @see WP_REST_Request::has_valid_params() * @see WP_Customize_Setting::validate() * - * @param array $setting_values Mapping of setting IDs to values to sanitize and validate. + * @param array $setting_values Mapping of setting IDs to values to validate and sanitize. * @return array Mapping of setting IDs to return value of validate method calls, either `true` or `WP_Error`. */ public function validate_setting_values( $setting_values ) {