Walker_Category_Checklist::start_el()
Start the element output.
Method of the class: Walker_Category_Checklist{}
Hooks from the method
Return
null
. Nothing (null).
Usage
$Walker_Category_Checklist = new Walker_Category_Checklist(); $Walker_Category_Checklist->start_el( $output, $data_object, $depth, $args, $current_object_id );
- $output(string) (required) (passed by reference — &)
- Used to append additional content (passed by reference).
- $data_object(WP_Term) (required)
- The current term object.
- $depth(int)
- Depth of the term in reference to parents.
- $args(array)
- An array of arguments. See wp_terms_checklist().
Default: array() - $current_object_id(int)
- ID of the current term.
Notes
- See: Walker::start_el()
Changelog
Since 2.5.1 | Introduced. |
Since 5.9.0 | Renamed $category to $data_object and $id to $current_object_id to match parent class for PHP 8 named parameter support. |
Walker_Category_Checklist::start_el() Walker Category Checklist::start el code WP 6.6.2
public function start_el( &$output, $data_object, $depth = 0, $args = array(), $current_object_id = 0 ) { // Restores the more descriptive, specific name for use within this method. $category = $data_object; if ( empty( $args['taxonomy'] ) ) { $taxonomy = 'category'; } else { $taxonomy = $args['taxonomy']; } if ( 'category' === $taxonomy ) { $name = 'post_category'; } else { $name = 'tax_input[' . $taxonomy . ']'; } $args['popular_cats'] = ! empty( $args['popular_cats'] ) ? array_map( 'intval', $args['popular_cats'] ) : array(); $class = in_array( $category->term_id, $args['popular_cats'], true ) ? ' class="popular-category"' : ''; $args['selected_cats'] = ! empty( $args['selected_cats'] ) ? array_map( 'intval', $args['selected_cats'] ) : array(); if ( ! empty( $args['list_only'] ) ) { $aria_checked = 'false'; $inner_class = 'category'; if ( in_array( $category->term_id, $args['selected_cats'], true ) ) { $inner_class .= ' selected'; $aria_checked = 'true'; } $output .= "\n" . '<li' . $class . '>' . '<div class="' . $inner_class . '" data-term-id=' . $category->term_id . ' tabindex="0" role="checkbox" aria-checked="' . $aria_checked . '">' . /** This filter is documented in wp-includes/category-template.php */ esc_html( apply_filters( 'the_category', $category->name, '', '' ) ) . '</div>'; } else { $is_selected = in_array( $category->term_id, $args['selected_cats'], true ); $is_disabled = ! empty( $args['disabled'] ); $output .= "\n<li id='{$taxonomy}-{$category->term_id}'$class>" . '<label class="selectit"><input value="' . $category->term_id . '" type="checkbox" name="' . $name . '[]" id="in-' . $taxonomy . '-' . $category->term_id . '"' . checked( $is_selected, true, false ) . disabled( $is_disabled, true, false ) . ' /> ' . /** This filter is documented in wp-includes/category-template.php */ esc_html( apply_filters( 'the_category', $category->name, '', '' ) ) . '</label>'; } }