Changeset 32535 for trunk/src/wp-includes/class-wp-customize-setting.php

Timestamp:

05/21/2015 10:04:29 PM (11 years ago)

Author:

wonderboymusic

Message:

In class-wp-customize-*, clarify/add some @param/@return blocks. Disambiguate some functions that are trying to return the void response of another function they call internally.

See #32444.

File:

• trunk/src/wp-includes/class-wp-customize-setting.php (modified) (4 diffs)

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

@@ -134 +134 @@
         public function is_current_blog_previewed() {
                 if ( ! isset( $this->_previewed_blog_id ) ) {
-                        return null;
+                        return;
                 }
                 return ( get_current_blog_id() === $this->_previewed_blog_id );
@@ -276 +276 @@
          * @since 3.4.0
          *
-         * @param mixed $value The value to sanitize.
-         * @return mixed Null if an input isn't valid, otherwise the sanitized value.
+         * @param string|array $value The value to sanitize.
+         * @return string|array|null Null if an input isn't valid, otherwise the sanitized value.
          */
         public function sanitize( $value ) {
@@ -332 +332 @@
          *
          * @param mixed $value The value to update.
-         * @return mixed The result of saving the value.
          */
         protected function _update_theme_mod( $value ) {
                 // Handle non-array theme mod.
-                if ( empty( $this->id_data[ 'keys' ] ) )
-                        return set_theme_mod( $this->id_data[ 'base' ], $value );
-
+                if ( empty( $this->id_data[ 'keys' ] ) ) {
+                        set_theme_mod( $this->id_data[ 'base' ], $value );
+                        return;
+                }
                 // Handle array-based theme mod.
                 $mods = get_theme_mod( $this->id_data[ 'base' ] );
                 $mods = $this->multidimensional_replace( $mods, $this->id_data[ 'keys' ], $value );
-                if ( isset( $mods ) )
-                        return set_theme_mod( $this->id_data[ 'base' ], $mods );
+                if ( isset( $mods ) ) {
+                        set_theme_mod( $this->id_data[ 'base' ], $mods );
+                }
         }
 
@@ -352 +353 @@
          *
          * @param mixed $value The value to update.
-         * @return bool|null The result of saving the value.
+         * @return bool The result of saving the value.
          */
         protected function _update_option( $value ) {