get_category_children( int $id, string $before = '/', string $after = '', array $visited = array() ): string

Parameters

$idint

Category ID to retrieve children.

$beforestringoptional

Prepend before category term ID. Default '/'.Default: '/'

$afterstringoptional

Append after category term ID. Default empty string.Default: ''

$visitedarrayoptional

Category Term IDs that have already been added. Default empty array.Default: array()

Return

string

Uses · 5

• _deprecated_function()Marks a function as deprecated and inform when it has been used.
• get_all_category_ids()Retrieves all category IDs.
• get_category()Retrieves category data given a category ID or category object.
• is_wp_error()Checks whether the given variable is a WordPress Error.
• get_category_children()Retrieve category children list separated before and after the term IDs.

Used by · 1

• get_category_children()Retrieve category children list separated before and after the term IDs.

Source

View on Trac ↗View on GitHub ↗

1275function get_category_children( $id, $before = '/', $after = '', $visited = array() ) {1276	_deprecated_function( __FUNCTION__, '2.8.0', 'get_term_children()' );1277	if ( 0 == $id )1278		return '';1279 1280	$chain = '';1281	/** TODO: Consult hierarchy */1282	$cat_ids = get_all_category_ids();1283	foreach ( (array) $cat_ids as $cat_id ) {1284		if ( $cat_id == $id )1285			continue;1286 1287		$category = get_category( $cat_id );1288		if ( is_wp_error( $category ) )1289			return $category;1290		if ( $category->parent == $id && !in_array( $category->term_id, $visited ) ) {1291			$visited[] = $category->term_id;1292			$chain .= $before.$category->term_id.$after;1293			$chain .= get_category_children( $category->term_id, $before, $after );1294		}1295	}1296	return $chain;1297}

History

Introduced in 1.2.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.7.7 tag, from src/wp-includes/deprecated.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.