用于生成类别下拉控件的旧功能。

原型

wp_dropdown_cats( int $currentcat, int $currentparent, int $parent, int $level, array $categories )

参数

$currentcat (int) (Optional)  当前类别的ID。默认值为0。

$currentparent (int) (Optional)  当前父类别ID。默认值为0。

$parent (int) (Optional)  用于检索类别的父ID。默认值为0。

$level (int) (Optional)  深度显示的级别数。默认值为0。

$categories (array) (Optional)  要包含在控件中的类别。默认值为0。

返回值

(bool|null)  如果未找到任何类别,则返回false。

源文件

路径:wp-admin/includes/deprecated.php

<?php
...
function wp_dropdown_cats( $currentcat = 0, $currentparent = 0, $parent = 0, $level = 0, $categories = 0 ) {
	_deprecated_function( __FUNCTION__, '3.0.0', 'wp_dropdown_categories()' );
	if (!$categories )
		$categories = get_categories( array('hide_empty' => 0) );
	if ( $categories ) {
		foreach ( $categories as $category ) {
			if ( $currentcat != $category->term_id && $parent == $category->parent) {
				$pad = str_repeat( '&#8211; ', $level );
				$category->name = esc_html( $category->name );
				echo "nt<option value='$category->term_id'";
				if ( $currentparent == $category->term_id )
					echo " selected='selected'";
				echo ">$pad$category->name</option>";
				wp_dropdown_cats( $currentcat, $currentparent, $category->term_id, $level +1, $categories );
			}
		}
	} else {
		return false;
	}
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/wp_dropdown_cats/