get_taxonomy() WP 2.3.0
Gets an object containing settings (data) of the specified taxonomy.
The function retrieves taxonomy data, not a list of terms of the specified taxonomy. To get the list of terms, use get_terms() or wp_list_categories().
The get_taxonomy function will first check that the parameter string given is a taxonomy object and if it is, it will return it.
Basis of: is_taxonomy_hierarchical()
1 time = 0.000009s = speed of light | 50000 times = 0.01s = speed of light | PHP 7.0.14, WP 4.7
No Hooks.
Return
WP_Taxonomy/false. The Taxonomy Object or false if $taxonomy doesn't exist.
Usage
get_taxonomy( $taxonomy );
- $taxonomy(string) (required)
- Name of taxonomy object to return.
Examples
#1. Get taxonomy data
To demonstrate how this function works, let's get "category" taxonomy data, which is attached to the "post" post type:
$category_tax_features = get_taxonomy('category'); print_r( $category_tax_features );
Displays:
stdClass Object ( [labels] => stdClass Object ( [name] => Categories [singular_name] => Category [search_items] => Search Categories [popular_items] => [all_items] => All Categories [parent_item] => Parent Category [parent_item_colon] => Parent Category: [edit_item] => Edit Category [view_item] => View Category [update_item] => Update Category [add_new_item] => Add New Category [new_item_name] => New Category Name [separate_items_with_commas] => [add_or_remove_items] => [choose_from_most_used] => [not_found] => [menu_name] => Categories [name_admin_bar] => category ) [description] => [public] => 1 [hierarchical] => 1 [show_ui] => 1 [show_in_menu] => 1 [show_in_nav_menus] => 1 [show_tagcloud] => 1 [meta_box_cb] => post_categories_meta_box [rewrite] => Array ( [with_front] => [hierarchical] => 1 [ep_mask] => 512 [slug] => cat ) [query_var] => category_name [update_count_callback] => [_builtin] => 1 [show_admin_column] => 1 [cap] => stdClass Object ( [manage_terms] => manage_categories [edit_terms] => manage_categories [delete_terms] => manage_categories [assign_terms] => edit_posts ) [name] => category [object_type] => Array ( [0] => post ) [label] => Categories )
Notes
- Global. Array. $wp_taxonomies The registered taxonomies.
Changelog
Since 2.3.0 | Introduced. |
Code of get_taxonomy() get taxonomy WP 5.6
function get_taxonomy( $taxonomy ) {
global $wp_taxonomies;
if ( ! taxonomy_exists( $taxonomy ) ) {
return false;
}
return $wp_taxonomies[ $taxonomy ];
}Related Functions
From category: Any taxonomy
- edit_term_link()
- get_edit_term_link()
- get_taxonomies()
- get_term()
- get_term_by()
- get_term_children()
- get_term_field()
- get_term_link()
- get_terms()