get_object_taxonomies()

💡 云策文档标注

概述

get_object_taxonomies() 函数用于获取注册到指定对象或对象类型（如文章对象或文章类型名称）的分类法名称或对象。它支持多种输入格式，并可通过参数控制输出类型。

关键要点

函数返回指定对象类型（如 'post'）关联的分类法名称或对象数组。
参数 $object_type 可以是字符串、字符串数组或 WP_Post 对象，用于指定分类法对象类型。
参数 $output 可选，控制输出类型：'names'（默认）返回名称数组，'objects' 返回 WP_Taxonomy 对象数组。
函数内部处理附件类型，并基于全局 $wp_taxonomies 进行匹配。
常用于获取文章类型的分类法，如 'category' 和 'post_tag'。

代码示例

// 获取文章类型的分类法名称（默认输出）
$taxonomies = get_object_taxonomies( 'post' );
// 结果：Array( 'category', 'post_tag' )

// 获取文章类型的分类法对象
$taxonomies = get_object_taxonomies( 'post', 'objects' );
// 返回包含 category、post_tag 等对象的数组

// 传递文章对象获取分类法
global $post;
$taxonomies = get_object_taxonomies( $post );
// 结果类似：Array( 'category', 'post_tag', 'post_format' )

注意事项

函数自 WordPress 2.3.0 引入，兼容性良好。
输出数组格式取决于 $output 参数：'names' 时为索引数组，'objects' 时为关联数组。
支持批量处理多个对象类型，无需循环调用。
相关函数包括 get_attachment_taxonomies() 和 get_taxonomies()，用于特定场景。

📄 原文内容

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'.

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

Uses	Description
get_attachment_taxonomies()`wp-includes/media.php`	Retrieves taxonomies attached to given the attachment.

Used by	Description
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.
wxr_post_taxonomy()`wp-admin/includes/export.php`	Outputs list of taxonomy terms, in XML tag format, associated with a post.
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.
get_attachment_taxonomies()`wp-includes/media.php`	Retrieves taxonomies attached to given the attachment.
_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 33 more Show less

Changelog

Version	Description
2.3.0	Introduced.

User Contributed Notes

Skip to note 5 content

Codex

11 years ago

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

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
        (
            ....
        )
)

Skip to note 6 content

Codex

11 years ago

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 type
will typically output:
```
Array
(
	[0] => category
	[1] => post_tag
	[2] => post_format
)
```
Log in to add feedback
Skip to note 7 content

Codex

11 years ago

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.
will output
```
Array
(
    [0] => category
    [1] => post_tag
    [2] => post_format
)
```
Log in to add feedback
Skip to note 8 content

etom2012

5 years ago

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.
or for just a array with taxonomies names
Log in to add feedback

云策 WordPress 开发者社区

函数文档

get_object_taxonomies()

概述

关键要点

代码示例

注意事项

Description

Parameters

Return

Source

Changelog

User Contributed Notes

函数文档

概述

关键要点

代码示例

注意事项

Description

Parameters

Return

Source

Related

Changelog

User Contributed Notes