widget_categories_args
Filters the arguments for the Categories widget.
Usage
add_filter( 'widget_categories_args', 'wp_kama_widget_categories_args_filter', 10, 2 ); /** * Function for `widget_categories_args` filter-hook. * * @param array $cat_args An array of Categories widget options. * @param array $instance Array of settings for the current widget. * * @return array */ function wp_kama_widget_categories_args_filter( $cat_args, $instance ){ // filter... return $cat_args; }
- $cat_args(array)
- An array of Categories widget options.
- $instance(array)
- Array of settings for the current widget.
Changelog
Since 2.8.0 | Introduced. |
Since 4.9.0 | Added the $instance parameter. |
Where the hook is called
wp-includes/widgets/class-wp-widget-categories.php 140
wp_list_categories( apply_filters( 'widget_categories_args', $cat_args, $instance ) );