get_taxonomy( string $taxonomy ): WP_Taxonomy|false

Retrieves the taxonomy object of $taxonomy.

Description

The get_taxonomy function will first check that the parameter string given is a taxonomy object and if it is, it will return it.

Parameters

$taxonomystringrequired
Name of taxonomy object to return.

Return

WP_Taxonomy|false The taxonomy object or false if $taxonomy doesn’t exist.

More Information

Note that it does NOT return the list of terms associated with the taxonomy. To do this, you should use get_term() to return an object or wp_list_categories() to return an HTML list of terms

Source

function get_taxonomy( $taxonomy ) {
	global $wp_taxonomies;

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

	return $wp_taxonomies[ $taxonomy ];
}

Changelog

VersionDescription
2.3.0Introduced.

User Contributed Notes

  1. Skip to note 2 content

    For example for a custom taxonomy named “features” associated with a custom post type named “rentals”.

    $rental_features = get_taxonomy( 'features' );
    print_r( $rental_features );

    Result:

    stdClass Object ( 
    	[hierarchical] => 
    	[update_count_callback] => 
    	[rewrite] => 
    		Array ( [slug] => features [with_front] => 1 ) 
    	[query_var] => features 
    	[public] => 1 
    	[show_ui] => 1 
    	[show_tagcloud] => 1 
    	[_builtin] => 
    	[labels] => 
    		stdClass Object ( 
    			[name] => Features 
    			[singular_name] => Feature 
    			[search_items] => Search Features 
    			[popular_items] => Popular Features 
    			[all_items] => All Features 
    			[parent_item] => Parent Feature 
    			[parent_item_colon] => Parent Feature: 
    			[edit_item] => Edit Feature 
    			[update_item] => Update Feature 
    			[add_new_item] => Add New Feature 
    			[new_item_name] => New Feature Name 
    			[separate_items_with_commas] => Separate Features with commas 
    			[add_or_remove_items] => Add or remove Features 
    			[choose_from_most_used] => Choose from the most used Features 
    		) 
    	[show_in_nav_menus] => 1 
    	[label] => Features 
    	[singular_label] => Feature 
    	[cap] => 
    		stdClass Object ( 
    			[manage_terms] => manage_categories 
    			[edit_terms] => manage_categories 
    			[delete_terms] => manage_categories 
    			[assign_terms] => edit_posts 
    		) 
    	[name] => features 
    	[object_type] => 
    		Array ( [0] => rentals [1] => rentals ) 
    	)

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