WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

is_taxonomy_hierarchical()

is_taxonomy_hierarchical( string $taxonomy ): bool

In this article

Back to top

Determines whether the taxonomy object is hierarchical.

Description

Checks to make sure that the taxonomy is an object first. Then Gets the object, and finally returns the hierarchical value in the object.

A false return value might also mean that the taxonomy does not exist.

For more information on this and similar theme functions, check out the Conditional Tags article in the Theme Developer Handbook.

Parameters

$taxonomystringrequired
Name of taxonomy object.

Return

bool Whether the taxonomy is hierarchical.

Source

function is_taxonomy_hierarchical( $taxonomy ) {
	if ( ! taxonomy_exists( $taxonomy ) ) {
		return false;
	}

	$taxonomy = get_taxonomy( $taxonomy );
	return $taxonomy->hierarchical;
}

View all references View on Trac View on GitHub

UsesDescription
taxonomy_exists()wp-includes/taxonomy.php

Determines whether the taxonomy name exists.

get_taxonomy()wp-includes/taxonomy.php

Retrieves the taxonomy object of $taxonomy.

Used byDescription
WP_REST_Menus_Controller::create_item()wp-includes/rest-api/endpoints/class-wp-rest-menus-controller.php

Creates a single term in a taxonomy.

WP_REST_Menus_Controller::update_item()wp-includes/rest-api/endpoints/class-wp-rest-menus-controller.php

Updates a single term from a taxonomy.

register_and_do_post_meta_boxes()wp-admin/includes/meta-boxes.php

Registers the default post meta boxes, and runs the do_meta_boxes actions.

WP_REST_Posts_Controller::get_available_actions()wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php

Gets the link relations available for the post and current user.

WP_REST_Terms_Controller::create_item_permissions_check()wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php

Checks if a request has access to create a term.

WP_REST_Terms_Controller::create_item()wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php

Creates a single term in a taxonomy.

WP_REST_Terms_Controller::update_item()wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php

Updates a single term from a taxonomy.

WP_Term_Query::get_terms()wp-includes/class-wp-term-query.php

Retrieves the query results.

bulk_edit_posts()wp-admin/includes/post.php

Processes the post data for the bulk editing of posts.

wp_ajax_add_tag()wp-admin/includes/ajax-actions.php

Handles adding a tag via AJAX.

WP_Terms_List_Table::prepare_items()wp-admin/includes/class-wp-terms-list-table.php
WP_Terms_List_Table::get_sortable_columns()wp-admin/includes/class-wp-terms-list-table.php
WP_Terms_List_Table::display_rows_or_placeholder()wp-admin/includes/class-wp-terms-list-table.php
wp_nav_menu_item_taxonomy_meta_box()wp-admin/includes/nav-menu.php

Displays a meta box for a taxonomy menu item.

WP_Tax_Query::clean_query()wp-includes/class-wp-tax-query.php

Validates a single query.

WP_Tax_Query::transform_query()wp-includes/class-wp-tax-query.php

Transforms a single query, from one field to another.

_get_term_hierarchy()wp-includes/taxonomy.php

Retrieves children of taxonomy as term IDs.

_pad_term_counts()wp-includes/taxonomy.php

Adds count of children to parent count.

get_ancestors()wp-includes/taxonomy.php

Gets an array of ancestor IDs for a given object.

wp_unique_term_slug()wp-includes/taxonomy.php

Makes term slug unique, if it isn’t already.

wp_insert_term()wp-includes/taxonomy.php

Adds a new term to the database.

wp_delete_term()wp-includes/taxonomy.php

Removes a term from the database.

_wp_menu_item_classes_by_context()wp-includes/nav-menu-template.php

Adds the class property classes for the current context, if applicable.

wp_set_post_terms()wp-includes/post.php

Sets the terms for a post.

wp_xmlrpc_server::_insert_post()wp-includes/class-wp-xmlrpc-server.php

Helper method for wp_newPost() and wp_editPost(), containing shared logic.

Show 20 moreShow less

Changelog

VersionDescription
2.3.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.