Changeset 38299

Timestamp:

08/22/2016 12:40:15 AM (10 years ago)

Author:

westonruter

Message:

Docs: Update outdated phpdoc for WP_Customize_Manager::validate_setting_values() to reflect changes in [37942].

Props dlh.
See #37247.
Fixes #37759.

File:

• trunk/src/wp-includes/class-wp-customize-manager.php (modified) (2 diffs)

trunk/src/wp-includes/class-wp-customize-manager.php

@@ -992 +992 @@
          * 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
@@ -1002 +1003 @@
          * @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`.
          */