wp_list_cats

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

WordPress Version: 5.4

/**
 * Lists categories.
 *
 * @since 1.2.0
 * @deprecated 2.1.0 Use wp_list_categories()
 * @see wp_list_categories()
 *
 * @param string|array $args
 * @return null|string|false
 */
function wp_list_cats($args = '')
{
    _deprecated_function(__FUNCTION__, '2.1.0', 'wp_list_categories()');
    $parsed_args = wp_parse_args($args);
    // Map to new names.
    if (isset($parsed_args['optionall']) && isset($parsed_args['all'])) {
        $parsed_args['show_option_all'] = $parsed_args['all'];
    }
    if (isset($parsed_args['sort_column'])) {
        $parsed_args['orderby'] = $parsed_args['sort_column'];
    }
    if (isset($parsed_args['sort_order'])) {
        $parsed_args['order'] = $parsed_args['sort_order'];
    }
    if (isset($parsed_args['optiondates'])) {
        $parsed_args['show_last_update'] = $parsed_args['optiondates'];
    }
    if (isset($parsed_args['optioncount'])) {
        $parsed_args['show_count'] = $parsed_args['optioncount'];
    }
    if (isset($parsed_args['list'])) {
        $parsed_args['style'] = $parsed_args['list'] ? 'list' : 'break';
    }
    $parsed_args['title_li'] = '';
    return wp_list_categories($parsed_args);
}

WordPress Version: 5.3

/**
 * Lists categories.
 *
 * @since 1.2.0
 * @deprecated 2.1.0 Use wp_list_categories()
 * @see wp_list_categories()
 *
 * @param string|array $args
 * @return false|null|string
 */
function wp_list_cats($args = '')
{
    _deprecated_function(__FUNCTION__, '2.1.0', 'wp_list_categories()');
    $parsed_args = wp_parse_args($args);
    // Map to new names.
    if (isset($parsed_args['optionall']) && isset($parsed_args['all'])) {
        $parsed_args['show_option_all'] = $parsed_args['all'];
    }
    if (isset($parsed_args['sort_column'])) {
        $parsed_args['orderby'] = $parsed_args['sort_column'];
    }
    if (isset($parsed_args['sort_order'])) {
        $parsed_args['order'] = $parsed_args['sort_order'];
    }
    if (isset($parsed_args['optiondates'])) {
        $parsed_args['show_last_update'] = $parsed_args['optiondates'];
    }
    if (isset($parsed_args['optioncount'])) {
        $parsed_args['show_count'] = $parsed_args['optioncount'];
    }
    if (isset($parsed_args['list'])) {
        $parsed_args['style'] = $parsed_args['list'] ? 'list' : 'break';
    }
    $parsed_args['title_li'] = '';
    return wp_list_categories($parsed_args);
}

WordPress Version: 4.6

/**
 * Lists categories.
 *
 * @since 1.2.0
 * @deprecated 2.1.0 Use wp_list_categories()
 * @see wp_list_categories()
 *
 * @param string|array $args
 * @return false|null|string
 */
function wp_list_cats($args = '')
{
    _deprecated_function(__FUNCTION__, '2.1.0', 'wp_list_categories()');
    $r = wp_parse_args($args);
    // Map to new names.
    if (isset($r['optionall']) && isset($r['all'])) {
        $r['show_option_all'] = $r['all'];
    }
    if (isset($r['sort_column'])) {
        $r['orderby'] = $r['sort_column'];
    }
    if (isset($r['sort_order'])) {
        $r['order'] = $r['sort_order'];
    }
    if (isset($r['optiondates'])) {
        $r['show_last_update'] = $r['optiondates'];
    }
    if (isset($r['optioncount'])) {
        $r['show_count'] = $r['optioncount'];
    }
    if (isset($r['list'])) {
        $r['style'] = $r['list'] ? 'list' : 'break';
    }
    $r['title_li'] = '';
    return wp_list_categories($r);
}

WordPress Version: 4.4

/**
 * Lists categories.
 *
 * @since 1.2.0
 * @deprecated 2.1.0 Use wp_list_categories()
 * @see wp_list_categories()
 *
 * @param string|array $args
 * @return false|null|string
 */
function wp_list_cats($args = '')
{
    _deprecated_function(__FUNCTION__, '2.1', 'wp_list_categories()');
    $r = wp_parse_args($args);
    // Map to new names.
    if (isset($r['optionall']) && isset($r['all'])) {
        $r['show_option_all'] = $r['all'];
    }
    if (isset($r['sort_column'])) {
        $r['orderby'] = $r['sort_column'];
    }
    if (isset($r['sort_order'])) {
        $r['order'] = $r['sort_order'];
    }
    if (isset($r['optiondates'])) {
        $r['show_last_update'] = $r['optiondates'];
    }
    if (isset($r['optioncount'])) {
        $r['show_count'] = $r['optioncount'];
    }
    if (isset($r['list'])) {
        $r['style'] = $r['list'] ? 'list' : 'break';
    }
    $r['title_li'] = '';
    return wp_list_categories($r);
}

WordPress Version: 4.1

/**
 * @since 1.2.0
 * @deprecated 2.1.0
 * @deprecated Use wp_list_categories()
 * @see wp_list_categories()
 *
 * @param string|array $args
 * @return false|null|string
 */
function wp_list_cats($args = '')
{
    _deprecated_function(__FUNCTION__, '2.1', 'wp_list_categories()');
    $r = wp_parse_args($args);
    // Map to new names.
    if (isset($r['optionall']) && isset($r['all'])) {
        $r['show_option_all'] = $r['all'];
    }
    if (isset($r['sort_column'])) {
        $r['orderby'] = $r['sort_column'];
    }
    if (isset($r['sort_order'])) {
        $r['order'] = $r['sort_order'];
    }
    if (isset($r['optiondates'])) {
        $r['show_last_update'] = $r['optiondates'];
    }
    if (isset($r['optioncount'])) {
        $r['show_count'] = $r['optioncount'];
    }
    if (isset($r['list'])) {
        $r['style'] = $r['list'] ? 'list' : 'break';
    }
    $r['title_li'] = '';
    return wp_list_categories($r);
}

WordPress Version: 3.9

/**
 * @since 1.2.0
 * @deprecated 2.1.0
 * @deprecated Use wp_list_categories()
 * @see wp_list_categories()
 *
 * @param string|array $args
 * @return unknown
 */
function wp_list_cats($args = '')
{
    _deprecated_function(__FUNCTION__, '2.1', 'wp_list_categories()');
    $r = wp_parse_args($args);
    // Map to new names.
    if (isset($r['optionall']) && isset($r['all'])) {
        $r['show_option_all'] = $r['all'];
    }
    if (isset($r['sort_column'])) {
        $r['orderby'] = $r['sort_column'];
    }
    if (isset($r['sort_order'])) {
        $r['order'] = $r['sort_order'];
    }
    if (isset($r['optiondates'])) {
        $r['show_last_update'] = $r['optiondates'];
    }
    if (isset($r['optioncount'])) {
        $r['show_count'] = $r['optioncount'];
    }
    if (isset($r['list'])) {
        $r['style'] = $r['list'] ? 'list' : 'break';
    }
    $r['title_li'] = '';
    return wp_list_categories($r);
}

WordPress Version: 3.7

/**
 * @since 1.2
 * @deprecated 2.1
 * @deprecated Use wp_list_categories()
 * @see wp_list_categories()
 *
 * @param string|array $args
 * @return unknown
 */
function wp_list_cats($args = '')
{
    _deprecated_function(__FUNCTION__, '2.1', 'wp_list_categories()');
    $r = wp_parse_args($args);
    // Map to new names.
    if (isset($r['optionall']) && isset($r['all'])) {
        $r['show_option_all'] = $r['all'];
    }
    if (isset($r['sort_column'])) {
        $r['orderby'] = $r['sort_column'];
    }
    if (isset($r['sort_order'])) {
        $r['order'] = $r['sort_order'];
    }
    if (isset($r['optiondates'])) {
        $r['show_last_update'] = $r['optiondates'];
    }
    if (isset($r['optioncount'])) {
        $r['show_count'] = $r['optioncount'];
    }
    if (isset($r['list'])) {
        $r['style'] = $r['list'] ? 'list' : 'break';
    }
    $r['title_li'] = '';
    return wp_list_categories($r);
}