Changeset 45449

Timestamp:

05/26/2019 10:04:04 PM (6 years ago)

Author:

johnbillion

Message:

Docs: Improve docs for variadic functions relating to widgets and their controls.

See #37402

File:

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

trunk/src/wp-includes/widgets.php

@@ -338 +338 @@
  *                               panel and/or theme.
  * }
+ * @param mixed      ...$params       Optional additional parameters to pass to the callback function when it's called.
  */
 function wp_register_sidebar_widget( $id, $name, $output_callback, $options = array() ) {
@@ -465 +466 @@
  * @global array $_wp_deprecated_widgets_callbacks
  *
- * @param int|string   $id               Sidebar ID.
- * @param string       $name             Sidebar display name.
- * @param callable     $control_callback Run when sidebar is displayed.
- * @param array $options {
+ * @param int|string $id               Sidebar ID.
+ * @param string     $name             Sidebar display name.
+ * @param callable   $control_callback Run when sidebar is displayed.
+ * @param array      $options {
  *     Optional. Array or string of control options. Default empty array.
  *
@@ -477 +478 @@
  *                               text widget. The widget id will end up looking like `{$id_base}-{$unique_number}`.
  * }
+ * @param mixed      ...$params        Optional additional parameters to pass to the callback function when it's called.
  */
 function wp_register_widget_control( $id, $name, $control_callback, $options = array() ) {
@@ -540 +542 @@
  * @param array    $options         Optional. Widget control options. See wp_register_widget_control().
  *                                  Default empty array.
+ * @param mixed    ...$params       Optional additional parameters to pass to the callback function when it's called.
  */
 function _register_widget_update_callback( $id_base, $update_callback, $options = array() ) {
@@ -572 +575 @@
  * @param array      $options       Optional. Widget control options. See wp_register_widget_control().
  *                                  Default empty array.
- */
+ * @param mixed      ...$params     Optional additional parameters to pass to the callback function when it's called.
+ */
+
 function _register_widget_form_callback( $id, $name, $form_callback, $options = array() ) {
     global $wp_registered_widget_controls;