sidebars_widgets
Filters the list of sidebars and their widgets.
Usage
add_filter( 'sidebars_widgets', 'wp_kama_sidebars_widgets_filter' );
/**
* Function for `sidebars_widgets` filter-hook.
*
* @param array $sidebars_widgets An associative array of sidebars and their widgets.
*
* @return array
*/
function wp_kama_sidebars_widgets_filter( $sidebars_widgets ){
// filter...
return $sidebars_widgets;
}
- $sidebars_widgets(array)
- An associative array of sidebars and their widgets.
Changelog
| Since 2.7.0 | Introduced. |
Where the hook is called
sidebars_widgets
wp-includes/widgets.php 1051
return apply_filters( 'sidebars_widgets', $sidebars_widgets );
Where the hook is used in WordPress
wp-includes/class-wp-customize-widgets.php 2036
add_filter( 'sidebars_widgets', $filter_callback, 1000 );
wp-includes/class-wp-customize-widgets.php 2045
remove_filter( 'sidebars_widgets', $filter_callback, 1000 );
wp-includes/class-wp-customize-widgets.php 375
add_filter( 'sidebars_widgets', array( $this, 'preview_sidebars_widgets' ), 1 );