WP hooks navigation: Home/browse • Actions index • Filters index
To save our bandwidth, we show only a snippet of code around each occurence of the hook. View complete file in SVN (without highlighting).
The best way to understand what a hook does is to look at where it occurs in the source code.
do_action( "hook_name" )apply_filters( "hook_name", "what_to_filter" ).Remember, this hook may occur in more than one file. Moreover, the hook's context may change from version to version.
This hook occurs 3 times in this file.
| Line | Code |
|---|---|
| 417 | * term name. |
| 418 | * |
| 419 | * @since 1.2.0 |
| 420 | * |
| 421 | * @see wp_dropdown_categories() |
| 422 | * |
| 423 | * @param string $element Category name. |
| 424 | * @param WP_Term|null $category The category object, or null if there's no corresponding category. |
| 425 | */ |
| 426 | $show_option_none = apply_filters( 'list_cats', $parsed_args['show_option_none'], null ); |
| 427 | $output .= "\t<option value='" . esc_attr( $option_none_value ) . "' selected='selected'>$show_option_none</option>\n"; |
| 428 | } |
| 429 | |
| 430 | if ( ! empty( $categories ) ) { |
| 431 | |
| 432 | if ( $parsed_args['show_option_all'] ) { |
| 433 | |
| 434 | /** This filter is documented in wp-includes/category-template.php */ |
| 435 | $show_option_all = apply_filters( 'list_cats', $parsed_args['show_option_all'], null ); |
| 436 | $selected = ( '0' === strval( $parsed_args['selected'] ) ) ? " selected='selected'" : ''; |
| 437 | $output .= "\t<option value='0'$selected>$show_option_all</option>\n"; |
| 438 | } |
| 439 | |
| 440 | if ( $parsed_args['show_option_none'] ) { |
| 441 | |
| 442 | /** This filter is documented in wp-includes/category-template.php */ |
| 443 | $show_option_none = apply_filters( 'list_cats', $parsed_args['show_option_none'], null ); |
| 444 | $selected = selected( $option_none_value, $parsed_args['selected'], false ); |
| 445 | $output .= "\t<option value='" . esc_attr( $option_none_value ) . "'$selected>$show_option_none</option>\n"; |
| 446 | } |
| 447 | |
| 448 | if ( $parsed_args['hierarchical'] ) { |
| 449 | $depth = $parsed_args['depth']; // Walk the full depth. |
| 450 | } else { |
| 451 | $depth = -1; // Flat. |
| 452 | } |