On this page
apply_filters( 'list_cats', string $element, WP_Term|null $category )
Filters a taxonomy drop-down display element.
Description
A variety of taxonomy drop-down display elements can be modified just prior to display via this filter. Filterable arguments include ‘show_option_none’, ‘show_option_all’, and various forms of the term name.
See also
Parameters
$elementstring-
Category name.
$categoryWP_Term|null-
The category object, or null if there's no corresponding category.
Source
File: wp-includes/category-template.php. View all references
$show_option_none = apply_filters( 'list_cats', $parsed_args['show_option_none'], null );
Related
Used By
| Used By | Description |
|---|---|
| Walker_CategoryDropdown::start_el() wp-includes/class-walker-category-dropdown.php | Starts the element output. |
| Walker_Category::start_el() wp-includes/class-walker-category.php | Starts the element output. |
| wp_dropdown_categories() wp-includes/category-template.php | Displays or retrieves the HTML dropdown list of categories. |
Changelog
| Version | Description |
|---|---|
| 1.2.0 | Introduced. |
© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/hooks/list_cats