Menu Adam R Brown

WP hooks navigation: Home/browseActions indexFilters index

Source View: list_cats

To save our bandwidth, we show only a snippet of code around each occurence of the hook. View complete file in SVN (without highlighting).

Understanding Source Code

The best way to understand what a hook does is to look at where it occurs in the source code.

Remember, this hook may occur in more than one file. Moreover, the hook's context may change from version to version.

Source View

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           }