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.

Parameters

$element: (string) Category name.
$category: (WP_Term|null) The category object, or null if there's no corresponding category.

Source

File: wp-includes/category-template.php

View on Trac

Used By

Used By	Description
wp-includes/class-walker-category.php: Walker_Category::start_el()	Starts the element output.
wp-includes/class-walker-category-dropdown.php: Walker_CategoryDropdown::start_el()	Starts the element output.
wp-includes/category-template.php: wp_dropdown_categories()	Displays or retrieves the HTML dropdown list of categories.

Changelog

Version	Description
1.2.0	Introduced.

© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/hooks/list_cats