云策 WordPress 开发者社区

函数文档

taxonomy_exists()

查看官方原文 ↗
💡 云策文档标注

概述

taxonomy_exists() 函数用于检查指定的分类法名称是否存在。它替代了已弃用的 is_taxonomy() 函数，自 WordPress 2.3.0 版本引入。

关键要点

  • 函数接受一个字符串参数 $taxonomy，表示分类法对象的名称。
  • 返回布尔值，如果分类法存在则返回 true，否则返回 false。
  • 内部实现通过检查全局变量 $wp_taxonomies 中是否存在对应键值来判断。
  • 相关函数包括 unregister_taxonomy()、get_taxonomy() 等，用于分类法管理操作。

代码示例

$taxonomy_exist = taxonomy_exists( 'category' );
// 返回 true

$taxonomy_exist = taxonomy_exists( 'post_tag' );
// 返回 true

$taxonomy_exist = taxonomy_exists( 'link_category' );
// 返回 true

$taxonomy_exist = taxonomy_exists( 'my_taxonomy' );
// 如果全局 $wp_taxonomies['my_taxonomy'] 未设置，则返回 false
📄 原文内容

Determines whether the taxonomy name exists.

Description

Formerly is_taxonomy() , introduced in 2.3.0.

For more information on this and similar theme functions, check out the Conditional Tags article in the Theme Developer Handbook.

Parameters

$taxonomystringrequired
Name of taxonomy object.

Return

bool Whether the taxonomy exists.

Source

function taxonomy_exists( $taxonomy ) {
	global $wp_taxonomies;

	return is_string( $taxonomy ) && isset( $wp_taxonomies[ $taxonomy ] );
}

View all references View on Trac View on GitHub

Used by Description
unregister_taxonomy()wp-includes/taxonomy.php

Unregisters a taxonomy.
WP_Term::get_instance()wp-includes/class-wp-term.php

Retrieve WP_Term instance.
WP_Customize_Nav_Menu_Item_Setting::populate_value()wp-includes/customize/class-wp-customize-nav-menu-item-setting.php

Ensure that the value is fully populated with the necessary properties.
WP_Screen::get()wp-admin/includes/class-wp-screen.php

Fetches a screen object.
WP_Terms_List_Table::__construct()wp-admin/includes/class-wp-terms-list-table.php

Constructor.
_wp_ajax_menu_quick_search()wp-admin/includes/nav-menu.php

Prints the appropriate response to a menu quick search.
wp_list_categories()wp-includes/category-template.php

Displays or retrieves the HTML list of categories.
is_taxonomy()wp-includes/deprecated.php

Checks that the taxonomy name exists.
WP_Widget_Tag_Cloud::_get_current_taxonomy()wp-includes/widgets/class-wp-widget-tag-cloud.php

Retrieves the taxonomy for the current Tag cloud widget instance.
WP_Tax_Query::clean_query()wp-includes/class-wp-tax-query.php

Validates a single query.
wp_update_term()wp-includes/taxonomy.php

Updates term based on arguments provided.
wp_get_object_terms()wp-includes/taxonomy.php

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

Adds a new term to the database.
wp_set_object_terms()wp-includes/taxonomy.php

Creates term and taxonomy relationships.
wp_remove_object_terms()wp-includes/taxonomy.php

Removes term(s) associated with a given object.
wp_count_terms()wp-includes/taxonomy.php

Counts how many terms are in taxonomy.
get_term_children()wp-includes/taxonomy.php

Merges all term children into a single array of their IDs.
get_term_by()wp-includes/taxonomy.php

Gets all term data from database by term field and data.
get_terms()wp-includes/taxonomy.php

Retrieves the terms in a given taxonomy or list of taxonomies.
get_taxonomy()wp-includes/taxonomy.php

Retrieves the taxonomy object of $taxonomy.
is_taxonomy_hierarchical()wp-includes/taxonomy.php

Determines whether the taxonomy object is hierarchical.
get_objects_in_term()wp-includes/taxonomy.php

Retrieves object IDs of valid taxonomy and term.
get_term()wp-includes/taxonomy.php

Gets all term data from database by term ID.
get_adjacent_post()wp-includes/link-template.php

Retrieves the adjacent post.
get_boundary_post()wp-includes/link-template.php

Retrieves the boundary post.
wp_get_nav_menu_items()wp-includes/nav-menu.php

Retrieves all menu items of a navigation menu.
wp_xmlrpc_server::wp_newTerm()wp-includes/class-wp-xmlrpc-server.php

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

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

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

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

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

Retrieves a taxonomy.

Show 27 moreShow less

Changelog

Version Description
3.0.0 Introduced.

User Contributed Notes

  1. Skip to note 2 content


    Codex


    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    Basic Example

    $taxonomy_exist = taxonomy_exists( 'category' );
// Returns true

$taxonomy_exist = taxonomy_exists( 'post_tag' );
// Returns true

$taxonomy_exist = taxonomy_exists( 'link_category' );
// Returns true

$taxonomy_exist = taxonomy_exists( 'my_taxonomy' );
// Returns false if global $wp_taxonomies['my_taxonomy'] is not set