Warning: This function has been deprecated. Use wp_dropdown_categories() instead.
wp_dropdown_cats( int $current_cat, int $current_parent, int $category_parent, int $level, array $categories ): void|false
Legacy function used for generating a categories drop-down control.
Contents
Description
See also
Parameters
-
$current_catint Optional -
ID of the current category. Default 0.
-
$current_parentint Optional -
Current parent category ID. Default 0.
-
$category_parentint Optional -
Parent ID to retrieve categories for. Default 0.
-
$levelint Optional -
Number of levels deep to display. Default 0.
-
$categoriesarray Optional -
Categories to include in the control. Default 0.
Return
void|false Void on success, false if no categories were found.
Source
File: wp-admin/includes/deprecated.php.
View all references
function wp_dropdown_cats( $current_cat = 0, $current_parent = 0, $category_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 ( $current_cat != $category->term_id && $category_parent == $category->parent) {
$pad = str_repeat( '– ', $level );
$category->name = esc_html( $category->name );
echo "\n\t<option value='$category->term_id'";
if ( $current_parent == $category->term_id )
echo " selected='selected'";
echo ">$pad$category->name</option>";
wp_dropdown_cats( $current_cat, $current_parent, $category->term_id, $level +1, $categories );
}
}
} else {
return false;
}
}
Changelog
| Version | Description |
|---|---|
| 3.0.0 | Use wp_dropdown_categories() |
| 1.2.0 | Introduced. |