apply_filters( 'widget_categories_args', array $cat_args , array $instance )
Filters the arguments for the Categories widget.
Parameters
-
$cat_args
array -
An array of Categories widget options.
-
$instance
array -
Array of settings for the current widget.
More Information
This filter is used by the default “WordPress Widget: Categories” before it passes arguments to the wp_list_categories() function.
Source
File: wp-includes/widgets/class-wp-widget-categories.php
.
View all references
wp_list_categories( apply_filters( 'widget_categories_args', $cat_args, $instance ) );
Changelog
Version | Description |
---|---|
4.9.0 | Added the $instance parameter. |
2.8.0 | Introduced. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.
Example migrated from Codex:
To hide some categories create a filter function in your
functions.php
file and hook it to thewidget_categories_args
filter. In this function, add the exclude parameter to the arguments list. Currently, in Version 3.3.2, the exclude parameter is not provided, but for future compatibility you should decide how you want to handle an already existing exclude parameter.