Question

Warning: This function has been deprecated. Use wp_dropdown_categories() instead.

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

Legacy function used for generating a categories drop-down control.

---

description

---

参数

$currentcat

(int) (Optional) ID of the current category. Default 0.

$currentparent

(int) (Optional) Current parent category ID. Default 0.

$parent

(int) (Optional) Parent ID to retrieve categories for. Default 0.

$level

(int) (Optional) Number of levels deep to display. Default 0.

$categories

(array) (Optional) Categories to include in the control. Default 0.

---

返回值

(bool|null) False if no categories were found.

---

源代码

File: wp-admin/includes/deprecated.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( '– ', $level );
				$category->name = esc_html( $category->name );
				echo "\n\t<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;
	}
}

---

更新日志

Version	description
3.0.0	Use wp_dropdown_categories()
1.2.0	Introduced.

---

相关函数

Uses

• wp-admin/includes/deprecated.php: wp_dropdown_cats()
• wp-includes/formatting.php: esc_html()
• wp-includes/category.php: get_categories()
• wp-includes/functions.php: _deprecated_function()

---

Used By

• wp-admin/includes/deprecated.php: wp_dropdown_cats()

---

User Contributed Notes