wp_category_checklist() │ WP 2.5.1

Outputs an unordered list of checkbox input elements labeled with category names.

No Hooks.

Return

null. Nothing (null).

Usage

wp_category_checklist( $post_id, $descendants_and_self, $selected_cats, $popular_cats, $walker, $checked_ontop );

$post_id(int)

Post to generate a categories checklist for. $selected_cats must not be an array.

$descendants_and_self(int)

ID of the category to output along with its descendants.

$selected_cats(int[]|false)

Array of category IDs to mark as checked.
Default: false

$popular_cats(int[]|false)

Array of category IDs to receive the "popular-category" class.
Default: false

$walker(Walker)

Walker object to use to build the output.
Default: Walker_Category_Checklist instance

$checked_ontop(true|false)

Whether to move checked items out of the hierarchy and to the top of the list.
Default: true

Notes

• See: wp_terms_checklist()

Changelog

wp_category_checklist() wp category checklist code ^{WP 6.5.2}

function wp_category_checklist( $post_id = 0, $descendants_and_self = 0, $selected_cats = false, $popular_cats = false, $walker = null, $checked_ontop = true ) {
	wp_terms_checklist(
		$post_id,
		array(
			'taxonomy'             => 'category',
			'descendants_and_self' => $descendants_and_self,
			'selected_cats'        => $selected_cats,
			'popular_cats'         => $popular_cats,
			'walker'               => $walker,
			'checked_ontop'        => $checked_ontop,
		)
	);
}