_get_term_hierarchy( string $taxonomy ): array
- Since
- 2.3.0
- Source
wp-includes/taxonomy.php:3912
Retrieves children of taxonomy as term IDs.
Parameters
$taxonomystring- Taxonomy name.
Return
array- Empty if $taxonomy isn't hierarchical or returns children as term IDs.
Uses · 4
- is_taxonomy_hierarchical()Determines whether the taxonomy object is hierarchical.
- get_option()Retrieves an option value based on an option name.
- get_terms()Retrieves the terms in a given taxonomy or list of taxonomies.
- update_option()Updates the value of an option that was already added.
Used by · 8
- WP_Term_Query::get_terms()Retrieves the query results.
- WP_Terms_List_Table::display_rows_or_placeholder()
- _get_term_children()Gets the subset of $terms that are descendants of $term_id.
- _pad_term_counts()Adds count of children to parent count.
- _wp_batch_split_terms()Splits a batch of shared taxonomy terms.
- _wp_menu_item_classes_by_context()Adds the class property classes for the current context, if applicable.
- clean_taxonomy_cache()Cleans the caches for a taxonomy.
- get_term_children()Merges all term children into a single array of their IDs.
Source
function _get_term_hierarchy( $taxonomy ) { if ( ! is_taxonomy_hierarchical( $taxonomy ) ) { return array(); } $children = get_option( "{$taxonomy}_children" ); if ( is_array( $children ) ) { return $children; } $children = array(); $terms = get_terms( array( 'taxonomy' => $taxonomy, 'get' => 'all', 'orderby' => 'id', 'fields' => 'id=>parent', 'update_term_meta_cache' => false, ) ); foreach ( $terms as $term_id => $parent ) { if ( $parent > 0 ) { $children[ $parent ][] = $term_id; } } update_option( "{$taxonomy}_children", $children ); return $children;}History
Introduced in 2.3.0. Unchanged from 6.7.7 through 7.1.0.
Signature, return type and hooks compared across 5 parsed releases.
About this page
- Parsed data
- Generated from the wordpress-develop 6.8.8 tag, from
src/wp-includes/taxonomy.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.