WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

get_object_taxonomies()

get_object_taxonomies( string|string[]|WP_Post $object_type, string $output = 'names' ): string[]|WP_Taxonomy[]

In this article

Back to top

Returns the names or objects of the taxonomies which are registered for the requested object or object type, such as a post object or post type name.

Description

Example:

$taxonomies = get_object_taxonomies( 'post' );

This results in:

Array( 'category', 'post_tag' )

Parameters

$object_typestring|string[]|WP_Postrequired
Name of the type of taxonomy object, or an object (row from posts).
$outputstringoptional
The type of output to return in the array. Accepts either 'names' or 'objects'. Default 'names'.

Default:'names'

Return

string[]|WP_Taxonomy[] The names or objects of all taxonomies of $object_type.

Source

function get_object_taxonomies( $object_type, $output = 'names' ) {	global $wp_taxonomies;	if ( is_object( $object_type ) ) {	if ( 'attachment' === $object_type->post_type ) {	return get_attachment_taxonomies( $object_type, $output );	}	$object_type = $object_type->post_type;	}	$object_type = (array) $object_type;	$taxonomies = array();	foreach ( (array) $wp_taxonomies as $tax_name => $tax_obj ) {	if ( array_intersect( $object_type, (array) $tax_obj->object_type ) ) {	if ( 'names' === $output ) {	$taxonomies[] = $tax_name;	} else {	$taxonomies[ $tax_name ] = $tax_obj;	}	}	}	return $taxonomies; }

View all references View on Trac View on GitHub

Used byDescription
WP_REST_Menu_Items_Controller::prepare_item_for_response()wp-includes/rest-api/endpoints/class-wp-rest-menu-items-controller.php

Prepares a single nav menu item output for response.

WP_REST_Menu_Items_Controller::get_item_schema()wp-includes/rest-api/endpoints/class-wp-rest-menu-items-controller.php

Retrieves the nav menu item’s schema, conforming to JSON Schema.

WP_REST_Posts_Controller::prepare_tax_query()wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php

Prepares the ‘tax_query’ for a collection of posts.

WP_REST_Posts_Controller::prepare_taxonomy_limit_schema()wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php

Prepares the collection schema for including and excluding items by terms.

register_and_do_post_meta_boxes()wp-admin/includes/meta-boxes.php

Registers the default post meta boxes, and runs the do_meta_boxes actions.

WP_REST_Posts_Controller::get_available_actions()wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php

Gets the link relations available for the post and current user.

WP_REST_Posts_Controller::get_schema_links()wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php

Retrieves Link Description Objects that should be added to the Schema for the posts collection.

WP_REST_Posts_Controller::prepare_links()wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php

Prepares links for the request.

WP_REST_Posts_Controller::get_item_schema()wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php

Retrieves the post’s schema, conforming to JSON Schema.

WP_REST_Posts_Controller::prepare_item_for_response()wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php

Prepares a single post output for response.

WP_REST_Posts_Controller::handle_terms()wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php

Updates the post’s terms from a REST request.

WP_REST_Posts_Controller::check_assign_terms_permission()wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php

Checks whether current user can assign all terms sent with the current request.

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_REST_Post_Types_Controller::prepare_item_for_response()wp-includes/rest-api/endpoints/class-wp-rest-post-types-controller.php

Prepares a post type object for serialization.

WP_Post_Type::unregister_taxonomies()wp-includes/class-wp-post-type.php

Removes the post type from all taxonomies.

wp_queue_posts_for_term_meta_lazyload()wp-includes/post.php

Queues posts for lazy-loading of term meta.

get_inline_data()wp-admin/includes/template.php

Adds hidden fields with the data for use in the inline editor for posts and pages.

bulk_edit_posts()wp-admin/includes/post.php

Processes the post data for the bulk editing of posts.

WP_Posts_List_Table::inline_edit()wp-admin/includes/class-wp-posts-list-table.php

Outputs the hidden row displayed when inline editing

WP_Posts_List_Table::get_columns()wp-admin/includes/class-wp-posts-list-table.php
WP_Query::get_posts()wp-includes/class-wp-query.php

Retrieves an array of posts based on query variables.

update_object_term_cache()wp-includes/taxonomy.php

Updates the cache for the given term object ID(s).

get_the_taxonomies()wp-includes/taxonomy.php

Retrieves all taxonomies associated with a post.

get_post_taxonomies()wp-includes/taxonomy.php

Retrieves all taxonomy names for the given post.

is_object_in_taxonomy()wp-includes/taxonomy.php

Determines if the given object type is associated with the given taxonomy.

clean_object_term_cache()wp-includes/taxonomy.php

Removes the taxonomy relationship to terms from the cache.

_wp_menu_item_classes_by_context()wp-includes/nav-menu-template.php

Adds the class property classes for the current context, if applicable.

_update_term_count_on_transition_post_status()wp-includes/post.php

Updates the custom taxonomies’ term counts when a post’s status is changed.

wp_delete_attachment()wp-includes/post.php

Trashes or deletes an attachment.

wp_publish_post()wp-includes/post.php

Publishes a post by transitioning the post status.

wp_insert_post()wp-includes/post.php

Inserts or update a post.

wp_delete_post()wp-includes/post.php

Trashes or deletes a post or page.

wp_xmlrpc_server::_insert_post()wp-includes/class-wp-xmlrpc-server.php

Helper method for wp_newPost() and wp_editPost(), containing shared logic.

wp_xmlrpc_server::_prepare_post()wp-includes/class-wp-xmlrpc-server.php

Prepares post data for return in an XML-RPC object.

wp_xmlrpc_server::_prepare_post_type()wp-includes/class-wp-xmlrpc-server.php

Prepares post data for return in an XML-RPC object.

Show 31 moreShow less

Changelog

VersionDescription
2.3.0Introduced.

User Contributed Notes

  1. Skip to note 5 content
    Codex
    You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note

    Taxonomy objects for post type
    If the $output parameter is 'objects', taxonomy objects will be returned as described in get_taxonomies().

    <?php	$taxonomy_objects = get_object_taxonomies( 'post', 'objects' );	print_r( $taxonomy_objects); ?>

    will output

    Array ( [category] => stdClass Object ( [hierarchical] => 1 [update_count_callback] => [rewrite] => [query_var] => category_name [public] => 1 [show_ui] => 1 [show_tagcloud] => 1 [_builtin] => 1 [labels] => stdClass Object ( ... ) ... [name] => category [label] => Categories ) [post_tag] => stdClass Object ( ... ) [post_format] => stdClass Object ( .... ) )
  3. Skip to note 7 content
    Codex
    You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

    Taxonomy names for post object
    To get the taxonomies for the current post, the current post object can be passed instead of the post type.

    <?php add_action('wp_head','wpdocs_output_current_post_taxonomies'); /** * Output taxonomies for the current post */ function wpdocs_output_current_post_taxonomies(){	global $post;	$taxonomy_names = get_object_taxonomies( $post );	print_r( $taxonomy_names ); } ?>

    will output

    Array ( [0] => category [1] => post_tag [2] => post_format )
  4. Skip to note 8 content
    etom2012
    You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

    Its nice to know that I can get multiple post type taxonomies at once without making a loop.

    <?php $post_taxonomies_objects = get_object_taxonomies( array( 'page', 'post', 'custom_post_type_slug' ), 'objects' ); /** * Output taxonomies objects for the selected post types. */ print_r( $post_taxonomies_objects ); ?>

    or for just a array with taxonomies names

    <?php $post_taxonomies_names = get_object_taxonomies( array( 'page', 'post', 'custom_post_type_slug' ), 'names ); /** * Output taxonomies names for the selected post types. */ print_r( $post_taxonomies_names ); ?>

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