_register_widget_form_callback()
Registers the form callback for a widget.
Внутренняя функция — эта функция рассчитана на использование самим ядром. Не рекомендуется использовать эту функцию в своем коде.
Хуков нет.
Возвращает
null
. Ничего (null).
Использование
_register_widget_form_callback( $id, $name, $form_callback, $options, ...$params );
- $id(int|строка) (обязательный)
- Widget ID.
- $name(строка) (обязательный)
- Name attribute for the widget.
- $form_callback(callable) (обязательный)
- Form callback.
- $options(массив)
- Widget control options. See wp_register_widget_control().
По умолчанию: empty array - ...$params(разное) (обязательный)
- Optional additional parameters to pass to the callback function when it's called.
Заметки
- Global. Массив. $wp_registered_widget_controls The registered widget controls.
Список изменений
С версии 2.8.0 | Введена. |
С версии 5.3.0 | Formalized the existing and already documented ...$params parameter by adding it to the function signature. |
Код _register_widget_form_callback() register widget form callback WP 6.5.2
function _register_widget_form_callback( $id, $name, $form_callback, $options = array(), ...$params ) { global $wp_registered_widget_controls; $id = strtolower( $id ); if ( empty( $form_callback ) ) { unset( $wp_registered_widget_controls[ $id ] ); return; } if ( isset( $wp_registered_widget_controls[ $id ] ) && ! did_action( 'widgets_init' ) ) { return; } $defaults = array( 'width' => 250, 'height' => 200, ); $options = wp_parse_args( $options, $defaults ); $options['width'] = (int) $options['width']; $options['height'] = (int) $options['height']; $widget = array( 'name' => $name, 'id' => $id, 'callback' => $form_callback, 'params' => $params, ); $widget = array_merge( $widget, $options ); $wp_registered_widget_controls[ $id ] = $widget; }