wp_category_checklist

函数
wp_category_checklist ( $post_id = 0, $descendants_and_self = 0, $selected_cats = false, $popular_cats = false, $walker = null, $checked_ontop = true )
参数
  • (int) $post_id Optional. Post to generate a categories checklist for. Default 0. $selected_cats must not be an array. Default 0.
    Required:
  • (int) $descendants_and_self Optional. ID of the category to output along with its descendants. Default 0.
    Required:
  • (int[]|false) $selected_cats Optional. Array of category IDs to mark as checked. Default false.
    Required:
    Default: false
  • (int[]|false) $popular_cats Optional. Array of category IDs to receive the "popular-category" class. Default false.
    Required:
    Default: false
  • (Walker) $walker Optional. Walker object to use to build the output. Default is a Walker_Category_Checklist instance.
    Required:
    Default: null
  • (bool) $checked_ontop Optional. Whether to move checked items out of the hierarchy and to the top of the list. Default true.
    Required:
    Default: true
相关
  • wp_terms_checklist()
定义位置
相关方法
wp_link_category_checklistwp_terms_checklistcategory_existswp_popular_terms_checklistupdate_category_cache
引入
2.5.1
弃用
-

wp_category_checklist: 这是一个函数,显示一个分层的复选框列表,用于为文章选择类别。它可以用来让用户轻松地选择和分配类别给他们的文章。

输出一个无序的复选框输入元素列表,并标明类别名称。

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,
		)
	);
}

常见问题

FAQs
查看更多 >