W3cubDocs

/WordPress

get_taxonomy( string $taxonomy )

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

$taxonomy

(string) (Required) 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

File: wp-includes/taxonomy.php 

function get_taxonomy( $taxonomy ) {
	global $wp_taxonomies;

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

	return $wp_taxonomies[ $taxonomy ];
}

Uses

Uses Description
wp-includes/taxonomy.php: taxonomy_exists()

Determines whether the taxonomy name exists.

Used By

Used By Description
wp-includes/rest-api.php: rest_get_route_for_term()

Gets the REST API route for a term.
wp-includes/taxonomy.php: is_taxonomy_viewable()

Determines whether a taxonomy is considered “viewable”.
wp-admin/includes/meta-boxes.php: register_and_do_post_meta_boxes()

Registers the default post meta boxes, and runs the do_meta_boxes actions.
wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php: WP_REST_Terms_Controller::check_is_taxonomy_allowed()

Checks that the taxonomy is valid.
wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php: WP_REST_Terms_Controller::prepare_links()

Prepares links for the request.
wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php: WP_REST_Terms_Controller::get_item_schema()

Retrieves the term’s schema, conforming to JSON Schema.
wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php: WP_REST_Terms_Controller::get_collection_params()

Retrieves the query params for collections.
wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php: WP_REST_Terms_Controller::create_item_permissions_check()

Checks if a request has access to create a term.
wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php: WP_REST_Terms_Controller::__construct()

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

Checks if a request has access to read terms in the specified taxonomy.
wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php: WP_REST_Terms_Controller::get_items()

Retrieves terms associated with a taxonomy.
wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php: WP_REST_Posts_Controller::prepare_links()

Prepares links for the request.
wp-includes/rest-api/endpoints/class-wp-rest-taxonomies-controller.php: WP_REST_Taxonomies_Controller::get_item_permissions_check()

Checks if a given request has access to a taxonomy.
wp-includes/rest-api/endpoints/class-wp-rest-taxonomies-controller.php: WP_REST_Taxonomies_Controller::get_item()

Retrieves a specific taxonomy.
wp-includes/customize/class-wp-customize-nav-menu-item-setting.php: WP_Customize_Nav_Menu_Item_Setting::get_type_label()

Get type label.
wp-admin/includes/class-wp-posts-list-table.php: WP_Posts_List_Table::categories_dropdown()

Displays a categories drop-down for filtering on the Posts list table.
wp-includes/taxonomy.php: unregister_taxonomy()

Unregisters a taxonomy.
wp-includes/class-wp-customize-nav-menus.php: WP_Customize_Nav_Menus::search_available_items_query()

Performs post queries for available-item searching.
wp-includes/class-wp-customize-nav-menus.php: WP_Customize_Nav_Menus::load_available_items_query()

Performs the post_type and taxonomy queries for loading available menu items.
wp-admin/includes/class-wp-posts-list-table.php: WP_Posts_List_Table::column_default()

Handles the default column output.
wp-admin/includes/class-wp-terms-list-table.php: WP_Terms_List_Table::handle_row_actions()

Generates and displays row action links.
wp-admin/includes/class-wp-media-list-table.php: WP_Media_List_Table::column_default()

Handles output for the default column.
wp-admin/includes/class-wp-terms-list-table.php: WP_Terms_List_Table::no_items()
wp-includes/general-template.php: get_the_archive_title()

Retrieve the archive title based on the queried object.
wp-admin/includes/class-wp-links-list-table.php: WP_Links_List_Table::extra_tablenav()
wp-admin/includes/template.php: get_inline_data()

Adds hidden fields with the data for use in the inline editor for posts and pages.
wp-admin/includes/template.php: wp_terms_checklist()

Output an unordered list of checkbox input elements labelled with term names.
wp-admin/includes/template.php: wp_popular_terms_checklist()

Retrieve a list of the most popular terms from the specified taxonomy.
wp-admin/includes/media.php: get_attachment_fields_to_edit()

Retrieves the attachment fields to edit form fields.
wp-admin/includes/media.php: get_compat_media_markup()
wp-admin/includes/post.php: _wp_translate_postdata()

Rename $_POST data from form names to DB post columns.
wp-admin/includes/post.php: edit_post()

Update an existing post with values provided in $_POST.
wp-admin/includes/post.php: bulk_edit_posts()

Process the post data for the bulk editing of posts.
wp-admin/includes/ajax-actions.php: wp_ajax_inline_save()

Ajax handler for Quick Edit saving a post from a list table.
wp-admin/includes/ajax-actions.php: wp_ajax_inline_save_tax()

Ajax handler for quick edit saving for a term.
wp-admin/includes/ajax-actions.php: _wp_ajax_add_hierarchical_term()

Ajax handler for adding a hierarchical term.
wp-admin/includes/ajax-actions.php: wp_ajax_add_link_category()

Ajax handler for adding a link category.
wp-admin/includes/ajax-actions.php: wp_ajax_add_tag()

Ajax handler to add a tag.
wp-admin/includes/ajax-actions.php: wp_ajax_get_tagcloud()

Ajax handler for getting a tagcloud.
wp-admin/includes/ajax-actions.php: wp_ajax_ajax_tag_search()

Ajax handler for tag search.
wp-admin/includes/meta-boxes.php: post_tags_meta_box()

Display post tags form fields.
wp-admin/includes/meta-boxes.php: post_categories_meta_box()

Display post categories form fields.
wp-admin/includes/class-wp-media-list-table.php: WP_Media_List_Table::get_columns()
wp-admin/includes/class-wp-terms-list-table.php: WP_Terms_List_Table::column_posts()
wp-admin/includes/class-wp-terms-list-table.php: WP_Terms_List_Table::inline_edit()

Outputs the hidden row displayed when inline editing
wp-admin/includes/class-wp-terms-list-table.php: WP_Terms_List_Table::__construct()

Constructor.
wp-admin/includes/class-wp-terms-list-table.php: WP_Terms_List_Table::ajax_user_can()
wp-admin/includes/class-wp-terms-list-table.php: WP_Terms_List_Table::get_bulk_actions()
wp-admin/includes/nav-menu.php: wp_nav_menu_item_taxonomy_meta_box()

Displays a meta box for a taxonomy menu item.
wp-admin/includes/class-wp-posts-list-table.php: WP_Posts_List_Table::inline_edit()

Outputs the hidden row displayed when inline editing
wp-admin/includes/class-wp-posts-list-table.php: WP_Posts_List_Table::get_columns()
wp-includes/capabilities.php: map_meta_cap()

Maps meta capabilities to primitive capabilities.
wp-includes/category-template.php: wp_list_categories()

Displays or retrieves the HTML list of categories.
wp-includes/general-template.php: feed_links_extra()

Display the links to the extra feeds such as category feeds.
wp-includes/general-template.php: wp_title()

Display or retrieve page title for all areas of blog.
wp-includes/widgets/class-wp-widget-tag-cloud.php: WP_Widget_Tag_Cloud::widget()

Outputs the content for the current Tag Cloud widget instance.
wp-includes/taxonomy.php: _pad_term_counts()

Add count of children to parent count.
wp-includes/taxonomy.php: get_term_link()

Generate a permalink for a taxonomy term archive.
wp-includes/taxonomy.php: get_the_taxonomies()

Retrieve all taxonomies associated with a post.
wp-includes/taxonomy.php: wp_update_term_count_now()

Perform term count update immediately.
wp-includes/taxonomy.php: wp_get_object_terms()

Retrieves the terms associated with the given object(s), in the supplied taxonomies.
wp-includes/taxonomy.php: wp_set_object_terms()

Create Term and Taxonomy Relationships.
wp-includes/taxonomy.php: wp_delete_term()

Removes a term from the database.
wp-includes/taxonomy.php: is_taxonomy_hierarchical()

Determines whether the taxonomy object is hierarchical.
wp-includes/link-template.php: get_term_feed_link()

Retrieves the feed link for a term.
wp-includes/link-template.php: get_edit_term_link()

Retrieves the URL for editing a given term.
wp-includes/link-template.php: edit_term_link()

Displays or retrieves the edit term link with formatting.
wp-includes/admin-bar.php: wp_admin_bar_edit_menu()

Provide an edit link for posts and terms.
wp-includes/post.php: wp_insert_post()

Insert or update a post.
wp-includes/canonical.php: redirect_canonical()

Redirects incoming links to the proper URL based on the site url.
wp-includes/post-formats.php: _post_format_request()

Filters the request to allow for the format prefix.
wp-includes/nav-menu.php: wp_setup_nav_menu_item()

Decorates a menu item object with the shared navigation menu item properties.
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::wp_newTerm()

Create a new term.
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::wp_editTerm()

Edit a term.
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::wp_deleteTerm()

Delete a term.
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::wp_getTerm()

Retrieve a term.
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::wp_getTerms()

Retrieve all terms for a taxonomy.
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::wp_getTaxonomy()

Retrieve a taxonomy.

Changelog

Version Description
2.3.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/get_taxonomy