wp_dropdown_cats

The timeline below displays how wordpress function wp_dropdown_cats has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 6.1

/**
 * Legacy function used for generating a categories drop-down control.
 *
 * @since 1.2.0
 * @deprecated 3.0.0 Use wp_dropdown_categories()
 * @see wp_dropdown_categories()
 *
 * @param int $current_cat     Optional. ID of the current category. Default 0.
 * @param int $current_parent  Optional. Current parent category ID. Default 0.
 * @param int $category_parent Optional. Parent ID to retrieve categories for. Default 0.
 * @param int $level           Optional. Number of levels deep to display. Default 0.
 * @param array $categories    Optional. Categories to include in the control. Default 0.
 * @return void|false Void on success, false if no categories were found.
 */
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;
    }
}

WordPress Version: 5.7

/**
 * Legacy function used for generating a categories drop-down control.
 *
 * @since 1.2.0
 * @deprecated 3.0.0 Use wp_dropdown_categories()
 * @see wp_dropdown_categories()
 *
 * @param int $currentcat    Optional. ID of the current category. Default 0.
 * @param int $currentparent Optional. Current parent category ID. Default 0.
 * @param int $parent        Optional. Parent ID to retrieve categories for. Default 0.
 * @param int $level         Optional. Number of levels deep to display. Default 0.
 * @param array $categories  Optional. Categories to include in the control. Default 0.
 * @return void|false Void on success, false if no categories were found.
 */
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 "\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;
    }
}

WordPress Version: 4.6

/**
 * Legacy function used for generating a categories drop-down control.
 *
 * @since 1.2.0
 * @deprecated 3.0.0 Use wp_dropdown_categories()
 * @see wp_dropdown_categories()
 *
 * @param int $currentcat    Optional. ID of the current category. Default 0.
 * @param int $currentparent Optional. Current parent category ID. Default 0.
 * @param int $parent        Optional. Parent ID to retrieve categories for. Default 0.
 * @param int $level         Optional. Number of levels deep to display. Default 0.
 * @param array $categories  Optional. Categories to include in the control. Default 0.
 * @return bool|null False if no categories were found.
 */
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 "\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;
    }
}

WordPress Version: 4.4

/**
 * Legacy function used for generating a categories drop-down control.
 *
 * @since 1.2.0
 * @deprecated 3.0.0 Use wp_dropdown_categories()
 * @see wp_dropdown_categories()
 *
 * @param int $currentcat    Optional. ID of the current category. Default 0.
 * @param int $currentparent Optional. Current parent category ID. Default 0.
 * @param int $parent        Optional. Parent ID to retrieve categories for. Default 0.
 * @param int $level         Optional. Number of levels deep to display. Default 0.
 * @param array $categories  Optional. Categories to include in the control. Default 0.
 * @return bool|null False if no categories were found.
 */
function wp_dropdown_cats($currentcat = 0, $currentparent = 0, $parent = 0, $level = 0, $categories = 0)
{
    _deprecated_function(__FUNCTION__, '3.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 "\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;
    }
}

WordPress Version: 4.1

/**
 * {@internal Missing Short Description}}
 *
 * @since 1.2.0
 * @deprecated 3.0.0
 * @deprecated Use wp_dropdown_categories()
 * @see wp_dropdown_categories()
 *
 * @param int $currentcat
 * @param int $currentparent
 * @param int $parent
 * @param int $level
 * @param array $categories
 * @return bool|null
 */
function wp_dropdown_cats($currentcat = 0, $currentparent = 0, $parent = 0, $level = 0, $categories = 0)
{
    _deprecated_function(__FUNCTION__, '3.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 "\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;
    }
}

WordPress Version: 3.7

/**
 * {@internal Missing Short Description}}
 *
 * @since 1.2.0
 * @deprecated 3.0.0
 * @deprecated Use wp_dropdown_categories()
 * @see wp_dropdown_categories()
 *
 * @param unknown_type $currentcat
 * @param unknown_type $currentparent
 * @param unknown_type $parent
 * @param unknown_type $level
 * @param unknown_type $categories
 * @return unknown
 */
function wp_dropdown_cats($currentcat = 0, $currentparent = 0, $parent = 0, $level = 0, $categories = 0)
{
    _deprecated_function(__FUNCTION__, '3.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 "\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;
    }
}