On this page
get_taxonomies( array $args = array(), string $output = 'names', string $operator = 'and' ): string[]|WP_Taxonomy[]
Retrieves a list of registered taxonomy names or objects.
Parameters
$argsarray Optional-
An array of
key => valuearguments to match against the taxonomy objects.
Default:
array() $outputstring Optional-
The type of output to return in the array. Accepts either taxonomy
'names'or'objects'. Default'names'.Default:
'names' $operatorstring Optional-
The logical operation to perform. Accepts
'and'or'or'.'or'means only one element from the array needs to match;'and'means all elements must match.
Default'and'.Default:
'and'
Return
string[]|WP_Taxonomy[] An array of taxonomy names or objects.
More Information
Parameter $args is an array of key -> value arguments to match against the taxonomies. Only taxonomies having attributes that match all arguments are returned.
- name
- object_type (array)
- label
- singular_label
- show_ui
- show_tagcloud
- show_in_rest
- public
- update_count_callback
- rewrite
- query_var
- manage_cap
- edit_cap
- delete_cap
- assign_cap
- _builtin
Returned value is an array, a list of taxonomy names or objects. If returning names, you will get an array of the taxonomy names such as
Array ( [special_taxonomy] => special_taxonomy [custom_taxonomy] => custom_taxonomy )
If returning objects, you will get an array of objects such as:
Array ( [special_taxonomy] => stdClass Object [custom_taxonomy] => stdClass Object )
wherein each object will contain the following fields:
stdClass Object (
[hierarchical] =>
[update_count_callback] =>
[rewrite] =>
[query_var] =>
[public] =>
[show_ui] =>
[show_tagcloud] =>
[_builtin] =>
[labels] => stdClass Object (
[name] =>
[singular_name] =>
[search_items] =>
[popular_items] =>
[all_items] =>
[parent_item] =>
[parent_item_colon] =>
[edit_item] =>
[view_item] =>
[update_item] =>
[add_new_item] =>
[new_item_name] =>
[separate_items_with_commas] =>
[add_or_remove_items] =>
[choose_from_most_used] =>
[menu_name] =>
[name_admin_bar] => )
[show_in_nav_menus] =>
[cap] => stdClass Object (
[manage_terms] =>
[edit_terms] =>
[delete_terms] =>
[assign_terms] => )
[name] =>
[object_type] => Array ()
[label] )
Source
File: wp-includes/taxonomy.php. View all references
function get_taxonomies( $args = array(), $output = 'names', $operator = 'and' ) {
global $wp_taxonomies;
$field = ( 'names' === $output ) ? 'name' : false;
return wp_filter_object_list( $wp_taxonomies, $args, $operator, $field );
}
Related
Uses
| Uses | Description |
|---|---|
| wp_filter_object_list() wp-includes/functions.php | Filters a list of objects, based on a set of key => value arguments. |
Used By
| Used By | Description |
|---|---|
| _build_block_template_result_from_post() wp-includes/block-template-utils.php | Builds a unified template object based a post Object. |
| WP_REST_Term_Search_Handler::__construct() wp-includes/rest-api/search/class-wp-rest-term-search-handler.php | Constructor. |
| WP_Sitemaps_Taxonomies::get_object_subtypes() wp-includes/sitemaps/providers/class-wp-sitemaps-taxonomies.php | Returns all public, registered taxonomies. |
| create_initial_rest_routes() wp-includes/rest-api.php | Registers default REST API routes. |
| WP_REST_Taxonomies_Controller::get_items_permissions_check() wp-includes/rest-api/endpoints/class-wp-rest-taxonomies-controller.php | Checks whether a given request has permission to read taxonomies. |
| WP_REST_Taxonomies_Controller::get_items() wp-includes/rest-api/endpoints/class-wp-rest-taxonomies-controller.php | Retrieves all public taxonomies. |
| WP_Customize_Nav_Menus::search_available_items_query() wp-includes/class-wp-customize-nav-menus.php | Performs post queries for available-item searching. |
| WP_Customize_Nav_Menus::available_item_types() wp-includes/class-wp-customize-nav-menus.php | Returns an array of all the available item types. |
| export_wp() wp-admin/includes/export.php | Generates the WXR export file for download. |
| set_screen_options() wp-admin/includes/misc.php | Saves option for number of rows when listing posts, pages, comments, etc. |
| wp_ajax_menu_get_metabox() wp-admin/includes/ajax-actions.php | Ajax handler for retrieving menu meta boxes. |
| wp_nav_menu_taxonomy_meta_boxes() wp-admin/includes/nav-menu.php | Creates meta boxes for any taxonomy menu item. |
| WP::parse_request() wp-includes/class-wp.php | Parses the request to find the correct WordPress query. |
| WP_Query::parse_tax_query() wp-includes/class-wp-query.php | Parses various taxonomy related query vars. |
| WP_Widget_Tag_Cloud::form() wp-includes/widgets/class-wp-widget-tag-cloud.php | Outputs the Tag Cloud widget settings form. |
| get_post_class() wp-includes/post-template.php | Retrieves an array of the class names for the post container element. |
| get_taxonomies_for_attachments() wp-includes/media.php | Retrieves all of the taxonomies that are registered for attachments. |
| wp_xmlrpc_server::wp_getTaxonomies() wp-includes/class-wp-xmlrpc-server.php | Retrieve all taxonomies. |
Changelog
| Version | Description |
|---|---|
| 3.0.0 | Introduced. |
© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/get_taxonomies