WordPress 文章类型管理：WP_Post_Type 与 $wp_post_types 的爱情故事
各位好，我是你们今天的 WordPress 文章类型爱情故事的讲述者，咳咳，不对，是源码分析师。今天咱们就来扒一扒 WordPress 中 WP_Post_Type 类和 $wp_post_types 全局变量之间那些不得不说的故事。
首先，咱们要搞清楚，WordPress 作为一个强大的内容管理系统，它必须得能管理各种各样的内容类型，比如文章、页面、自定义文章类型等等。而 WP_Post_Type 类就是用来定义这些文章类型的蓝图，$wp_post_types 全局变量呢，就是一个大仓库，专门用来存放这些蓝图的具体实例。
WP_Post_Type 类：文章类型的建筑师
WP_Post_Type 类，顾名思义，就是用来定义文章类型的。它定义了文章类型的各种属性，比如名称、标签、支持的功能、是否公开等等。
咱们先来看看 WP_Post_Type 类的一些关键属性：
| 属性名 | 数据类型 | 描述 |
|---|---|---|
$name |
string | 文章类型的名称，比如 ‘post’, ‘page’, ‘product’ 等。 |
$args |
array | 定义文章类型的各种参数，比如标签、功能、是否公开等。 |
$label |
string | 文章类型的单数形式标签，比如 ‘文章’, ‘页面’, ‘产品’ 等。 |
$labels |
object | 包含各种标签的对象，比如 ‘add_new’, ‘edit_item’, ‘search_items’ 等。 |
$description |
string | 文章类型的描述。 |
$public |
bool | 是否公开。 |
$exclude_from_search |
bool | 是否从搜索结果中排除。 |
$publicly_queryable |
bool | 是否可以通过 URL 查询。 |
$show_ui |
bool | 是否在后台显示 UI。 |
$show_in_menu |
mixed | 是否在后台菜单中显示，可以是一个布尔值，也可以是菜单位置的字符串。 |
$show_in_nav_menus |
bool | 是否在导航菜单中显示。 |
$show_in_admin_bar |
bool | 是否在管理栏中显示。 |
$menu_position |
int | 在后台菜单中的位置。 |
$menu_icon |
string | 在后台菜单中显示的图标。 |
$capability_type |
mixed | 文章类型的权限类型，可以是字符串或数组。 |
$capabilities |
array | 文章类型的权限。 |
$map_meta_cap |
bool | 是否映射默认的权限。 |
$hierarchical |
bool | 是否具有层级关系，比如页面。 |
$supports |
array | 文章类型支持的功能，比如 ‘title’, ‘editor’, ‘thumbnail’ 等。 |
$taxonomies |
array | 与文章类型关联的分类法。 |
$has_archive |
mixed | 是否有存档页面，可以是一个布尔值，也可以是存档页面的 URL。 |
$rewrite |
mixed | 重写规则，可以是一个布尔值或一个数组。 |
$query_var |
mixed | 查询变量，可以是一个布尔值或一个字符串。 |
$can_export |
bool | 是否可以导出。 |
$_builtin |
bool | 是否是内置的文章类型。 |
$_edit_link |
string | 编辑链接。 |
这些属性定义了文章类型的方方面面。你可以通过 $args 参数来设置这些属性，也可以在创建 WP_Post_Type 对象后直接修改它们。
接下来，咱们看看如何使用 WP_Post_Type 类来注册一个自定义文章类型。
add_action( 'init', 'register_book_post_type' );
function register_book_post_type() {
$args = array(
'labels' => array(
'name' => '书籍',
'singular_name' => '书籍',
),
'public' => true,
'has_archive' => true,
'supports' => array( 'title', 'editor', 'thumbnail' ),
'menu_icon' => 'dashicons-book'
);
register_post_type( 'book', $args );
}这段代码首先定义了一个 register_book_post_type 函数，这个函数会在 init 钩子被触发时执行。在函数内部，我们定义了一个 $args 数组，用来设置文章类型的各种属性。然后，我们使用 register_post_type 函数来注册文章类型。
register_post_type 函数内部会创建一个 WP_Post_Type 类的实例，并将 $args 数组传递给它。然后，这个实例会被存储到 $wp_post_types 全局变量中。
$wp_post_types：文章类型的储藏室
$wp_post_types 是一个全局变量，它是一个数组，用来存储所有已注册的文章类型的 WP_Post_Type 对象。
你可以通过 $GLOBALS['wp_post_types'] 来访问这个数组。
global $wp_post_types;
if ( isset( $wp_post_types['book'] ) ) {
$book_post_type = $wp_post_types['book'];
echo '书籍文章类型的描述：' . $book_post_type->description;
}这段代码首先声明 $wp_post_types 为全局变量。然后，它检查 $wp_post_types 数组中是否存在 ‘book’ 键。如果存在，就将对应的 WP_Post_Type 对象赋值给 $book_post_type 变量。最后，我们就可以通过 $book_post_type 变量来访问书籍文章类型的各种属性了。
register_post_type() 函数是如何使用 $wp_post_types 的？
让我们深入 register_post_type() 函数的核心部分，看看它是如何与 $wp_post_types 互动的。
function register_post_type( $post_type, $args = array() ) {
global $wp_post_types;
// 1. 检查文章类型名称是否合法
if ( ! is_string( $post_type ) || empty( $post_type ) ) {
return new WP_Error( 'invalid_post_type', __( 'Invalid post type name.' ) );
}
// 2. 检查文章类型是否已经注册
if ( isset( $wp_post_types[ $post_type ] ) ) {
return new WP_Error( 'post_type_exists', __( 'Post type already registered.' ) );
}
// 3. 解析参数
$args = wp_parse_args( $args, array(
'labels' => array(),
'description' => '',
'public' => false,
'exclude_from_search' => false,
'publicly_queryable' => null,
'show_ui' => null,
'show_in_menu' => null,
'show_in_nav_menus' => null,
'show_in_admin_bar' => null,
'menu_position' => null,
'menu_icon' => null,
'capability_type' => 'post',
'capabilities' => array(),
'map_meta_cap' => false,
'hierarchical' => false,
'supports' => array(),
'taxonomies' => array(),
'has_archive' => false,
'rewrite' => true,
'query_var' => true,
'can_export' => true,
'show_in_rest' => false, // 新增：是否在 REST API 中显示
'rest_base' => null, // 新增：REST API 的基地址
'rest_controller_class' => 'WP_REST_Posts_Controller', // 新增：REST API 控制器类
'_builtin' => false,
'_edit_link' => 'post.php?post=%d',
) );
// 4. 创建 WP_Post_Type 实例
$wp_post_types[ $post_type ] = new WP_Post_Type( $post_type, $args );
// 5. 返回文章类型对象
return $wp_post_types[ $post_type ];
}让我们逐行解读：
global $wp_post_types;: 首先，声明$wp_post_types为全局变量，以便在函数内部访问它。- 参数验证: 检查传入的文章类型名称
$post_type是否有效。如果无效，则返回一个WP_Error对象。 - 重复注册检查: 检查
$wp_post_types数组中是否已经存在同名的文章类型。如果存在，说明该文章类型已经被注册过了，返回一个WP_Error对象。避免重复注册导致冲突。 - 参数解析:
wp_parse_args()函数会将传入的$args数组与默认参数进行合并，确保所有必要的参数都已设置。这就像给你的文章类型打上各种标签，确保它符合 WordPress 的规范。 - 创建
WP_Post_Type实例: 这是最关键的一步。使用文章类型名称$post_type和合并后的参数$args创建一个WP_Post_Type类的实例。 - 存储到
$wp_post_types: 将创建的WP_Post_Type实例存储到$wp_post_types全局数组中，键名为文章类型名称$post_type。 这就像把你的文章类型放到一个大仓库里，方便以后随时取用。 - 返回文章类型对象: 返回刚刚创建并存储的
WP_Post_Type对象。
所以，register_post_type() 函数的核心作用就是：创建一个 WP_Post_Type 对象，并将其存储到 $wp_post_types 全局变量中。
如何利用 $wp_post_types 修改已注册的文章类型？
有时候，你可能需要在文章类型注册之后修改它的属性。这时，$wp_post_types 就派上用场了。
比如，你想修改 ‘book’ 文章类型的描述：
add_action( 'init', 'modify_book_post_type' );
function modify_book_post_type() {
global $wp_post_types;
if ( isset( $wp_post_types['book'] ) ) {
$wp_post_types['book']->description = '这是一个关于书籍的文章类型。';
}
}这段代码在 init 钩子被触发时执行。它首先声明 $wp_post_types 为全局变量。然后，它检查 $wp_post_types 数组中是否存在 ‘book’ 键。如果存在，就直接修改 $wp_post_types['book']->description 属性。
需要注意的是，修改 $wp_post_types 中的文章类型对象可能会影响到 WordPress 的行为。因此，在修改之前，一定要仔细考虑清楚，避免产生意外的后果。
深入分析 WP_Post_Type 类的方法
WP_Post_Type 类除了属性之外，还提供了一些有用的方法。咱们来看看其中一些重要的方法：
__construct( $post_type, $args ): 构造函数，用来初始化文章类型对象。add_support( $feature ): 添加对某个功能的支持，比如 ‘title’, ‘editor’, ‘thumbnail’ 等。remove_support( $feature ): 移除对某个功能的支持。add_taxonomy( $taxonomy ): 添加与文章类型关联的分类法。remove_taxonomy( $taxonomy ): 移除与文章类型关联的分类法。set_label( $key, $label ): 设置某个标签。get_label( $key ): 获取某个标签。get_labels(): 获取所有标签。
这些方法可以让你更灵活地操作文章类型。
举个例子：动态添加文章类型支持的功能
假设你想在文章类型注册之后，根据某些条件动态地添加对 ‘custom-fields’ 功能的支持。
add_action( 'init', 'add_custom_fields_support' );
function add_custom_fields_support() {
global $wp_post_types;
if ( isset( $wp_post_types['book'] ) && current_user_can( 'manage_options' ) ) {
$wp_post_types['book']->add_support( 'custom-fields' );
}
}这段代码首先检查 ‘book’ 文章类型是否存在，并且当前用户是否具有 manage_options 权限（通常是管理员）。如果条件满足，就调用 add_support 方法来添加对 ‘custom-fields’ 功能的支持。
$wp_post_types 与 WordPress 的其他组件
$wp_post_types 全局变量不仅仅是一个存储文章类型对象的仓库，它还与 WordPress 的其他组件密切相关。
WP_Query:WP_Query类在查询文章时，会根据$wp_post_types中的信息来确定应该查询哪些文章类型。WP_Rewrite:WP_Rewrite类在生成 URL 重写规则时，会根据$wp_post_types中的信息来生成相应的规则。- 后台 UI: WordPress 后台的 UI 会根据
$wp_post_types中的信息来显示文章类型的管理界面。
因此，$wp_post_types 是 WordPress 核心功能的重要组成部分。
总结
WP_Post_Type 类和 $wp_post_types 全局变量是 WordPress 文章类型管理的核心。WP_Post_Type 类定义了文章类型的蓝图，$wp_post_types 全局变量则存储了这些蓝图的具体实例。通过理解它们的工作原理，你可以更好地管理和定制 WordPress 的文章类型，从而构建更强大的网站。
希望今天的讲座能帮助你更好地理解 WordPress 的文章类型管理机制。记住，源码的世界充满了乐趣，只要你肯深入探索，就会发现更多意想不到的惊喜。
好了，今天的分享就到这里，下次有机会再和大家一起探索 WordPress 源码的奥秘！