Warning: This function has been deprecated. Use get_term_children() instead.
get_category_children( int $id, string $before = '/', string $after = '', array $visited = array() ): string
Retrieve category children list separated before and after the term IDs.
Contents
Description
See also
Parameters
-
$idint Required -
Category ID to retrieve children.
-
$beforestring Optional -
Prepend before category term ID. Default
'/'.Default:
'/' -
$afterstring Optional -
Append after category term ID.
Default:
'' -
$visitedarray Optional -
Category Term IDs that have already been added.
Default:
array()
Return
string
Source
File: wp-includes/deprecated.php.
View all references
function get_category_children( $id, $before = '/', $after = '', $visited = array() ) {
_deprecated_function( __FUNCTION__, '2.8.0', 'get_term_children()' );
if ( 0 == $id )
return '';
$chain = '';
/** TODO: Consult hierarchy */
$cat_ids = get_all_category_ids();
foreach ( (array) $cat_ids as $cat_id ) {
if ( $cat_id == $id )
continue;
$category = get_category( $cat_id );
if ( is_wp_error( $category ) )
return $category;
if ( $category->parent == $id && !in_array( $category->term_id, $visited ) ) {
$visited[] = $category->term_id;
$chain .= $before.$category->term_id.$after;
$chain .= get_category_children( $category->term_id, $before, $after );
}
}
return $chain;
}
Changelog
| Version | Description |
|---|---|
| 2.8.0 | Use get_term_children() |
| 1.2.0 | Introduced. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.
If attempting to replace this deprecated function with get_term_children(), note that get_category_children() returns a String, while get_term_children() returns an array of Category IDs. Also note that get_term_children() requires a second parameter of ‘category’, which is the name of the pre-defined Taxonomy for Categories.