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 ) {