Changeset 61270 for trunk/src/wp-admin/includes/widgets.php

Timestamp:

11/19/2025 06:15:54 AM (5 months ago)

Author:

westonruter

Message:

Docs: Add missing descriptions and fix types for some @return tags.

Props huzaifaalmesbah, sabernhardt, westonruter.
See #64224.
Fixes #64262.

File:

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

trunk/src/wp-admin/includes/widgets.php

@@ -70 +70 @@
  * @param array $a First array.
  * @param array $b Second array.
- * @return int
+ * @return int Comparison result.
  */
 function _sort_name_callback( $a, $b ) {
@@ -130 +130 @@
  *
  * @param array $params
- * @return array
+ * @return array Widget control arguments.
  */
 function wp_list_widget_controls_dynamic_sidebar( $params ) {
@@ -158 +158 @@
  *
  * @param string $id_base
- * @return int
+ * @return int Next available widget ID number.
  */
 function next_widget_id_number( $id_base ) {
@@ -186 +186 @@
  *
  * @param array $sidebar_args
- * @return array
+ * @return array Passed through value of `$sidebar_args` param.
  */
 function wp_widget_control( $sidebar_args ) {
@@ -323 +323 @@
 /**
  * @param string $classes
- * @return string
+ * @return string Modified body classes.
  */
 function wp_widgets_access_body_class( $classes ) {