描述
wp_category_checklist()的分类模式独立版本。
参数
$post_id
int可选-
文章ID,默认值为0。
$args
array|string可选-
用于生成分类项(term)列表的参数数组或字符串。
descendants_and_self
int类别ID,将输出该类别本身及其后代。
默认值0。selected_cats
int[]要标记为选中状态的类别ID数组。默认值为false。popular_cats
int[]类别ID数组,用于接受"popular-category"类
默认值 falsewalker
WalkerWalker对象用于构建输出。默认为空,导致使用Walker_Category_Checklist实例。taxonomy
string要为其生成复选框列表的分类模式。默认'category'
。checked_ontop
bool是否将选中状态的项目移出层次结构并移至列表顶部。默认为true。echo
bool是否回显生成的标记。false返回标记,而不回显。默认值为true。
默认:
array()
返回
string input元素的HTML列表。
钩子
- apply_filters( 'wp_terms_checklist_args',
array|string $args ,int $post_id ) -
过滤分类模式的分类项复选框列表参数。
源码
更新日志
版本 | 描述 |
---|---|
4.4.0 | 引入了$echo 参数。 |
3.0.0 | 开始引入 |
使用示例
请注意,如果不允许当前用户分配分类项,则表单中的复选框将被禁用。此函数适用于面向管理员的列表。此外,此函数并不总是定义的。您可以使用
include ABSPATH . 'wp-admin/includes/template.php';
以确保函数已定义。