Changeset 48580 for trunk/src/wp-includes/widgets.php

Timestamp:

07/23/2020 01:48:37 PM (5 years ago)

Author:

SergeyBiryukov

Message:

Docs: Add missing description for wp_convert_widget_settings() parameters.

Props stevenlinx.
Fixes #50738.

File:

• trunk/src/wp-includes/widgets.php (modified) (3 diffs)

trunk/src/wp-includes/widgets.php

@@ -1047 +1047 @@
 
 /**
- * Convert the widget settings from single to multi-widget format.
+ * Converts the widget settings from single to multi-widget format.
  *
  * @since 2.8.0
@@ -1053 +1053 @@
  * @global array $_wp_sidebars_widgets
  *
- * @param string $base_name
- * @param string $option_name
- * @param array  $settings
- * @return array
+ * @param string $base_name   Root ID for all widgets of this type.
+ * @param string $option_name Option name for this widget type.
+ * @param array  $settings    The array of widget instance settings.
+ * @return array The array of widget settings converted to multi-widget format.
  */
 function wp_convert_widget_settings( $base_name, $option_name, $settings ) {
@@ -1062 +1062 @@
     $single  = false;
     $changed = false;
+
     if ( empty( $settings ) ) {
         $single = true;