post_type_exists()

💡 云策文档标注

概述

post_type_exists() 函数用于检查指定的文章类型是否已在 WordPress 中注册。它基于 get_post_type_object() 实现，返回布尔值。

关键要点

函数接受一个字符串参数 $post_type，表示文章类型名称。
返回布尔值：true 表示文章类型已注册，false 表示未注册。
内部实现通过调用 get_post_type_object() 并转换为布尔值来判断。
相关函数包括 get_post_type_object()、unregister_post_type() 等，用于文章类型操作。
自 WordPress 3.0.0 版本引入。

代码示例

$exists = post_type_exists( 'post' );
// returns true
 
$exists = post_type_exists( 'page' );
// returns true
 
$exists = post_type_exists( 'book' );
// returns true if book is a registered post type
 
$exists = post_type_exists( 'xyz' );
// returns false if xyz is not a registered post type

📄 原文内容

Determines whether a post type is registered.

Description

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

Parameters

$post_typestringrequired: Post type name.

Return

bool Whether post type is registered.

Source

function post_type_exists( $post_type ) {
	return (bool) get_post_type_object( $post_type );
}

View all references View on Trac View on GitHub

Uses	Description
get_post_type_object()`wp-includes/post.php`	Retrieves a post type object by name.

Used by	Description
use_block_editor_for_post_type()`wp-includes/post.php`	Returns whether a post type is compatible with the block editor.
WP_Customize_Nav_Menus::ajax_insert_auto_draft_post()`wp-includes/class-wp-customize-nav-menus.php`	Ajax handler for adding a new auto-draft post.
unregister_post_type()`wp-includes/post.php`	Unregisters a post type.
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.
export_wp()`wp-admin/includes/export.php`	Generates the WXR export file for download.
_wp_ajax_menu_quick_search()`wp-admin/includes/nav-menu.php`	Prints the appropriate response to a menu quick search.
get_calendar()`wp-includes/general-template.php`	Displays calendar with days that have posts as links.
get_ancestors()`wp-includes/taxonomy.php`	Gets an array of ancestor IDs for a given object.
wp_count_posts()`wp-includes/post.php`	Counts number of posts of a post type and if user has permissions to view.
is_post_type_hierarchical()`wp-includes/post.php`	Determines whether the post type is hierarchical.
wp_xmlrpc_server::wp_getPostType()`wp-includes/class-wp-xmlrpc-server.php`	Retrieves a post type.

Show 7 more Show less

Changelog

Version	Description
3.0.0	Introduced.

User Contributed Notes

Skip to note 2 content

Codex

10 years ago

Basic Examples

$exists = post_type_exists( 'post' );
// returns true
 
$exists = post_type_exists( 'page' );
// returns true
 
$exists = post_type_exists( 'book' );
// returns true if book is a registered post type
 
$exists = post_type_exists( 'xyz' );
// returns false if xyz is not a registered post type

云策 WordPress 开发者社区

函数文档