研究 register_taxonomy 如何影响查询构建与层级结构

register_taxonomy 如何影响查询构建与层级结构：一次深入剖析

大家好，今天我们来深入探讨 WordPress 中 register_taxonomy 函数对查询构建和层级结构的影响。register_taxonomy 是 WordPress 定义自定义分类法的核心函数，理解它对构建高效且可维护的 WordPress 站点至关重要。我们将从基础概念开始，逐步深入到更高级的用法，并结合实际代码示例进行分析。

1. 分类法基础：理解 Taxonomy 的本质

在 WordPress 中，分类法（Taxonomy）是一种对文章进行分组和组织的方式。它允许你根据特定的属性或特征对文章进行分类，从而方便用户浏览和搜索。WordPress 内置了两种主要的分类法：

• 分类（Category）： 用于对文章进行广泛的分类，通常具有层级结构。
• 标签（Tag）： 用于对文章进行更细粒度的标记，通常没有层级结构。

除了内置分类法，WordPress 还允许你使用 register_taxonomy 函数创建自定义分类法，以满足特定的需求。例如，你可以创建一个名为 "书本类型" 的分类法，用于对书本类型的文章进行分类，或者创建一个名为 "颜色" 的分类法，用于对产品进行颜色分类。

分类法的本质是 元数据，它附加到文章上，帮助我们组织和检索内容。

2. register_taxonomy 函数：定义分类法的蓝图

register_taxonomy 函数用于注册一个新的分类法。它的基本语法如下：

register_taxonomy(
    string   $taxonomy,
    string|string[] $object_type,
    array    $args = array()
);

• $taxonomy (string, required)：分类法的名称。必须是小写字母，可以包含数字和下划线，但不超过 32 个字符。这是分类法的唯一标识符。
• $object_type (string|string[], required)：与分类法关联的对象类型。可以是文章类型（例如 ‘post’、’page’），也可以是自定义文章类型。可以是一个字符串或一个字符串数组。
• $args (array, optional)：一个包含分类法配置选项的数组。这个数组允许你定制分类法的行为和外观。

$args 数组包含大量的配置选项，控制分类法的各个方面。以下是一些常用的选项：

参数	类型	描述	默认值
labels	array	用于自定义分类法 UI 标签的数组。允许你更改分类法在 WordPress 后台的显示名称，例如 "分类目录" 变为 "书本类型"。
public	bool	控制分类法是否对公众可见。如果设置为 true，则分类法将出现在 URL 中，并且可以通过查询参数进行查询。	true
hierarchical	bool	控制分类法是否具有层级结构。如果设置为 true，则分类法类似于分类目录，可以有父级和子级术语。如果设置为 false，则分类法类似于标签，没有层级结构。	false
rewrite	array	控制分类法的 URL 重写规则。允许你自定义分类法术语的 URL 结构。	true
show_ui	bool	控制分类法是否在 WordPress 后台显示。如果设置为 true，则分类法将出现在文章编辑页面的侧边栏中，并且可以在 "分类" 菜单下管理。	true
query_var	string/bool	控制分类法是否可以使用查询变量进行查询。如果设置为一个字符串，则该字符串将用作查询变量的名称。如果设置为 false，则无法使用查询变量进行查询。	$taxonomy
show_admin_column	bool	控制分类法是否在文章列表页面显示为列。如果设置为 true，则分类法将出现在文章列表页面的列中，允许你快速查看和编辑文章的分类法术语。	false
capabilities	array	用于自定义分类法权限的数组。允许你控制用户对分类法术语的创建、编辑和删除权限。

3. register_taxonomy 对查询构建的影响

register_taxonomy 的配置选项直接影响着 WordPress 如何构建查询来检索与特定分类法术语相关的文章。

3.1. query_var 参数的影响

query_var 参数控制着分类法是否可以使用查询变量进行查询。如果 query_var 设置为一个字符串，则该字符串将用作查询变量的名称。例如，如果你的分类法名为 "genre"，并且 query_var 设置为 "book_genre"，那么你可以使用以下 URL 来查询所有属于 "科幻" 类型的小说：

http://example.com/?book_genre=science-fiction

WordPress 将解析这个 URL，并使用 WP_Query 对象构建一个查询，以检索所有具有 "genre" 分类法，且术语为 "science-fiction" 的文章。

如果 query_var 设置为 false，则无法使用查询变量进行查询。这意味着你不能直接使用 URL 来过滤文章。

3.2. rewrite 参数的影响

rewrite 参数控制着分类法的 URL 重写规则。它是一个数组，包含以下选项：

• slug (string)：分类法术语的 URL slug。
• with_front (bool)：是否在 URL slug 前面加上前缀。
• hierarchical (bool)：是否使用层级 URL 结构。

例如，假设你有一个名为 "location" 的分类法，并且 rewrite 参数设置为：

'rewrite' => array(
    'slug'       => 'locations',
    'with_front' => false,
    'hierarchical' => true,
)

这意味着，所有 "location" 分类法的术语的 URL 将以 /locations/ 开头。例如，如果你的 "location" 分类法有一个名为 "巴黎" 的术语，那么它的 URL 将是 /locations/巴黎/。

rewrite 参数还会影响 WordPress 如何解析 URL 并构建查询。当 WordPress 遇到一个以 /locations/ 开头的 URL 时，它会知道这是一个 "location" 分类法的术语，并使用 WP_Query 对象构建一个查询，以检索所有具有 "location" 分类法，且术语为 "巴黎" 的文章。

3.3. hierarchical 参数的影响

hierarchical 参数控制分类法是否具有层级结构。如果设置为 true，则分类法类似于分类目录，可以有父级和子级术语。如果设置为 false，则分类法类似于标签，没有层级结构。

hierarchical 参数对查询构建的影响体现在以下几个方面：

• 术语之间的关系： 如果 hierarchical 设置为 true，则你可以查询所有属于某个术语及其所有子术语的文章。例如，你可以查询所有属于 "欧洲" 及其所有子地区（例如 "法国"、"德国"、"意大利"）的文章。
• URL 结构： 如果 hierarchical 设置为 true，并且 rewrite 参数也设置为 hierarchical 为 true，则 URL 结构将反映术语的层级结构。例如，如果 "巴黎" 是 "法国" 的子术语，那么 "巴黎" 的 URL 将是 /locations/法国/巴黎/。

3.4 使用 WP_Query 直接查询

即使没有通过 URL 直接查询，我们也可以通过 WP_Query 类来指定分类法和术语进行查询，例如：

$args = array(
    'post_type' => 'post', // 或者你的自定义文章类型
    'tax_query' => array(
        array(
            'taxonomy' => 'genre', //你的分类法名称
            'field'    => 'slug', // 可以是 'term_id', 'name', 'slug'
            'terms'    => array( 'science-fiction', 'fantasy' ), // 术语的 slug
            'operator' => 'IN', // 可以是 'IN', 'NOT IN', 'AND', 'EXISTS', 'NOT EXISTS'
        ),
    ),
);

$query = new WP_Query( $args );

if ( $query->have_posts() ) {
    while ( $query->have_posts() ) {
        $query->the_post();
        // 输出文章内容
    }
    wp_reset_postdata();
} else {
    // 没有文章
}

在这个例子中，tax_query 是一个关键参数，它允许我们指定一个或多个分类法查询条件。taxonomy 指定分类法的名称，field 指定用于匹配术语的字段（可以是术语 ID、名称或 slug），terms 指定要匹配的术语数组，operator 指定匹配操作符。

4. register_taxonomy 对层级结构的影响

register_taxonomy 函数的 hierarchical 参数直接决定了分类法是否具有层级结构。如果 hierarchical 设置为 true，则分类法将具有层级结构，这意味着你可以创建父级和子级术语。如果 hierarchical 设置为 false，则分类法将没有层级结构，这意味着你只能创建独立的术语。

4.1. 层级分类法的优势

层级分类法提供了一种更灵活和强大的方式来组织和管理内容。它们允许你创建更细粒度的分类，并反映内容之间的关系。例如，你可以使用层级分类法来创建一个产品目录，其中包含产品类别、子类别和子子类别。

4.2. 层级分类法的实现

要创建一个层级分类法，你需要将 hierarchical 参数设置为 true。例如：

register_taxonomy(
    'location',
    'post',
    array(
        'hierarchical' => true,
        'labels'       => array(
            'name'          => '地点',
            'singular_name' => '地点',
        ),
        'rewrite'      => array(
            'slug'       => 'locations',
            'with_front' => false,
            'hierarchical' => true,
        ),
    )
);

在这个例子中，我们将 hierarchical 参数设置为 true，这意味着 "location" 分类法将具有层级结构。我们还设置了 rewrite 参数的 hierarchical 选项为 true，这意味着 URL 结构将反映术语的层级结构。

4.3. 层级分类法的管理

一旦你创建了一个层级分类法，你就可以在 WordPress 后台管理它的术语。你可以创建新的术语，并将它们分配给父级术语。你还可以编辑现有术语，并更改它们的父级术语。

在文章编辑页面，你将看到一个类似于分类目录的界面，允许你选择文章所属的分类法术语。你可以选择多个术语，并且可以创建新的术语。

4.4. 层级分类法的展示

你可以使用 wp_list_categories 函数来展示层级分类法的术语列表。这个函数允许你自定义术语的显示方式，包括显示术语的层级结构、显示术语的文章数量等等。

例如：

wp_list_categories( array(
    'taxonomy' => 'location',
    'title_li' => '',
    'hierarchical' => true,
) );

这段代码将显示 "location" 分类法的术语列表，并显示术语的层级结构。

5. 代码示例：一个完整的自定义分类法

让我们创建一个名为 "book_genre" 的自定义分类法，用于对书本类型的文章进行分类。我们将使用 register_taxonomy 函数来注册这个分类法，并配置它的各种选项。

add_action( 'init', 'register_book_genre_taxonomy' );

function register_book_genre_taxonomy() {
    $labels = array(
        'name'                       => _x( '图书类型', 'Taxonomy General Name', 'text_domain' ),
        'singular_name'              => _x( '图书类型', 'Taxonomy Singular Name', 'text_domain' ),
        'menu_name'                  => __( '图书类型', 'text_domain' ),
        'all_items'                  => __( '所有图书类型', 'text_domain' ),
        'parent_item'                => __( '父级图书类型', 'text_domain' ),
        'parent_item_colon'          => __( '父级图书类型:', 'text_domain' ),
        'new_item_name'              => __( '新图书类型名称', 'text_domain' ),
        'add_new_item'               => __( '添加新图书类型', 'text_domain' ),
        'edit_item'                  => __( '编辑图书类型', 'text_domain' ),
        'update_item'                => __( '更新图书类型', 'text_domain' ),
        'view_item'                  => __( '查看图书类型', 'text_domain' ),
        'separate_items_with_commas' => __( '用逗号分隔图书类型', 'text_domain' ),
        'add_or_remove_items'        => __( '添加或移除图书类型', 'text_domain' ),
        'choose_from_most_used'      => __( '从最常用的图书类型中选择', 'text_domain' ),
        'popular_items'              => __( '热门图书类型', 'text_domain' ),
        'search_items'               => __( '搜索图书类型', 'text_domain' ),
        'not_found'                  => __( '未找到', 'text_domain' ),
        'no_terms'                   => __( '没有图书类型', 'text_domain' ),
        'items_list'                 => __( '图书类型列表', 'text_domain' ),
        'items_list_navigation'      => __( '图书类型列表导航', 'text_domain' ),
    );
    $args = array(
        'hierarchical'          => true,
        'labels'                => $labels,
        'public'                => true,
        'show_ui'               => true,
        'show_admin_column'     => true,
        'show_in_nav_menus'     => true,
        'show_tagcloud'         => true,
        'query_var'             => 'book_genre',
        'rewrite'               => array( 'slug' => 'book-genre', 'hierarchical' => true ),
    );
    register_taxonomy( 'book_genre', 'post', $args );
}

在这个例子中，我们首先定义了一个 $labels 数组，用于自定义分类法 UI 标签。然后，我们定义了一个 $args 数组，用于配置分类法的各种选项。

• hierarchical 设置为 true，这意味着 "book_genre" 分类法将具有层级结构。
• public 设置为 true，这意味着分类法将对公众可见。
• show_ui 设置为 true，这意味着分类法将在 WordPress 后台显示。
• show_admin_column 设置为 true，这意味着分类法将在文章列表页面显示为列。
• query_var 设置为 book_genre，这意味着可以使用 book_genre 查询变量来查询属于特定 "book_genre" 术语的文章。
• rewrite 设置为 array( 'slug' => 'book-genre', 'hierarchical' => true )，这意味着分类法术语的 URL 将以 /book-genre/ 开头，并且 URL 结构将反映术语的层级结构。

最后，我们使用 register_taxonomy 函数来注册 "book_genre" 分类法，并将它与 "post" 文章类型关联。

6. 最佳实践与注意事项

• 选择合适的分类法类型： 在创建自定义分类法之前，请仔细考虑你需要哪种类型的分类法。如果你的分类法需要具有层级结构，则应将 hierarchical 设置为 true。如果你的分类法不需要具有层级结构，则应将 hierarchical 设置为 false。
• 自定义 UI 标签： 使用 $labels 数组自定义分类法 UI 标签，以使其更易于理解和使用。
• 配置 URL 重写规则： 使用 rewrite 参数配置分类法的 URL 重写规则，以使其更易于访问和 SEO 友好。
• 谨慎使用 query_var： 虽然 query_var 允许你使用查询变量来查询属于特定分类法术语的文章，但过度使用查询变量可能会导致 URL 变得复杂和难以理解。
• 考虑性能： 复杂的分类法结构和大量的分类法术语可能会影响网站的性能。请优化你的分类法结构，并使用缓存技术来提高性能。
• 避免命名冲突： 确保你的分类法名称与其他 WordPress 函数和插件的名称不冲突。

7. 调试与排错

当分类法没有按预期工作时，可以采取以下步骤进行调试：

1. 检查代码错误： 检查 register_taxonomy 函数的语法和参数是否正确。
2. 刷新重写规则： 在 WordPress 后台，进入 "设置" -> "固定链接"，点击 "保存更改" 按钮，以刷新重写规则。
3. 检查分类法是否已注册： 使用 taxonomy_exists( 'your_taxonomy_name' ) 函数检查分类法是否已成功注册。
4. 检查文章是否已分配给分类法术语： 确保你已将文章分配给分类法术语。
5. 使用 WP_Query 的 pre_get_posts 钩子调试查询： 你可以使用 pre_get_posts 钩子来检查和修改 WP_Query 对象。这可以帮助你了解 WordPress 如何构建查询，并识别任何问题。

例如：

add_action( 'pre_get_posts', 'debug_taxonomy_query' );

function debug_taxonomy_query( $query ) {
    if ( $query->is_main_query() && ! is_admin() && $query->is_tax( 'book_genre' ) ) {
        echo '<pre>';
        print_r( $query );
        echo '</pre>';
    }
}

这段代码将在前端显示所有 "book_genre" 分类法查询的 WP_Query 对象。你可以使用它来检查查询参数，并确保它们是正确的。

8. 总结一下register_taxonomy

register_taxonomy 是 WordPress 中定义自定义分类法的关键函数，它通过各种参数影响查询构建和层级结构。理解这些参数及其相互作用对于构建高效且可维护的 WordPress 站点至关重要。通过合理地使用 register_taxonomy，我们可以更好地组织和管理网站的内容，并为用户提供更好的浏览体验。