get_taxonomy( string $taxonomy )
Retrieves the taxonomy object of $taxonomy.
Description #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 #Parameters
- $taxonomy
-
(string) (Required) Name of taxonomy object to return.
Return #Return
(WP_Taxonomy|false) The Taxonomy Object or false if $taxonomy doesn't exist.
Source #Source
File: wp-includes/taxonomy.php
261 262 263 264 265 266 267 268 269 | function get_taxonomy( $taxonomy ) { global $wp_taxonomies; if ( ! taxonomy_exists( $taxonomy ) ) { return false; } return $wp_taxonomies[ $taxonomy ];} |
Expand full source code Collapse full source code View on Trac
Changelog #Changelog
| Version | Description |
|---|---|
| 2.3.0 | Introduced. |
Related #Related
Uses #Uses
| Uses | Description |
|---|---|
| wp-includes/taxonomy.php: taxonomy_exists() |
Determines whether the taxonomy name exists. |
Used By #Used By
| Used By | Description |
|---|---|
| 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 |
| 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() |
Map meta capabilities to primitive capabilities. |
| wp-includes/category-template.php: wp_list_categories() |
Display or retrieve 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. |
User Contributed Notes #User Contributed Notes
You must log in before being able to contribute a note or feedback.
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] => Addorremove 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 ))Expand full source codeCollapse full source code