WP_Query多分类交集查询与文章统计教程

本教程详细讲解如何在WordPress中使用WP_Query的tax_query参数，通过设置relation为'AND'来精确查询同时属于多个自定义分类法的文章。文章将提供清晰的代码示例，演示如何构建高效的查询逻辑，并获取符合特定多分类条件的文章数量，帮助开发者解决复杂的文章筛选需求。

在WordPress开发中，经常需要根据文章所属的分类法（Taxonomy）来筛选文章。当需求是查询同时属于两个或更多特定分类法中的文章时，就需要巧妙地利用WP_Query的tax_query参数。本文将深入探讨如何正确配置tax_query以实现这种“交集”查询，并提供实际的代码示例。

理解 WP_Query 的 tax_query 参数

WP_Query是WordPress中用于从数据库中检索文章、页面、自定义文章类型等内容的核心函数。其tax_query参数专门用于构建基于分类法的复杂查询。

tax_query是一个数组，其中每个元素代表一个分类法查询条件。更重要的是，tax_query可以包含一个relation键，用于指定其内部子查询之间的逻辑关系。

• relation:
  • 'AND'：表示所有子查询条件都必须满足。
  • 'OR'：表示只要满足任一子查询条件即可。
  • 这个relation键可以应用于tax_query的顶层，也可以应用于嵌套的子查询数组。

每个子查询数组通常包含以下键：

• taxonomy: 要查询的分类法名称（slug）。
• field: 用于指定terms数组中值的类型，可以是'id'（分类ID）、'slug'（分类别名）或'name'（分类名称）。
• terms: 一个数组，包含要匹配的分类项ID、别名或名称。
• operator: 比较操作符，如'IN'（默认，匹配terms中的任意一个）、'NOT IN'、'AND'（匹配terms中的所有）。
• include_children: 布尔值，是否包含子分类的文章（默认为true）。

实现多分类交集查询

要查询同时属于两个不同分类法的文章，关键在于将tax_query的顶层relation设置为'AND'，并为每个分类法定义一个独立的查询数组。

假设我们有一个自定义文章类型'property'，以及两个自定义分类法'location'（地点）和'set'（类型，如出售/出租）。我们希望查询某个特定地点下，同时是“出售”或“出租”的房产数量。

以下是一个实现此功能的通用函数：

/**
 * 获取同时属于指定两个分类法的文章数量。
 *
 * @param string $post_type             文章类型。
 * @param string $primary_taxonomy_slug   主分类法的别名。
 * @param mixed  $primary_term_value      主分类项的值（ID或slug）。
 * @param string $primary_field_type      主分类项的字段类型（'id'或'slug'）。
 * @param string $secondary_taxonomy_slug 次要分类法的别名。
 * @param mixed  $secondary_term_value    次要分类项的值（ID或slug）。
 * @param string $secondary_field_type    次要分类项的字段类型（'id'或'slug'）。
 * @return int                          符合条件的文章数量。
 */
function get_posts_count_by_two_taxonomies(
    $post_type,
    $primary_taxonomy_slug,
    $primary_term_value,
    $primary_field_type,
    $secondary_taxonomy_slug,
    $secondary_term_value,
    $secondary_field_type
) {
    $args = array(
        'post_type'      => $post_type,
        'post_status'    => 'publish',
        'posts_per_page' => -1, // 获取所有匹配的文章，不分页
        'fields'         => 'ids', // 仅获取文章ID，提高性能
        'tax_query'      => array(
            'relation' => 'AND', // 关键：两个分类条件必须同时满足
            array(
                'taxonomy' => $primary_taxonomy_slug,
                'field'    => $primary_field_type,
                'terms'    => (array) $primary_term_value, // 确保terms是数组
            ),
            array(
                'taxonomy' => $secondary_taxonomy_slug,
                'field'    => $secondary_field_type,
                'terms'    => (array) $secondary_term_value, // 确保terms是数组
            ),
        ),
    );

    $query = new WP_Query($args);
    return $query->found_posts; // 使用found_posts获取总数，更准确
}

代码解析：

1. 'posts_per_page' => -1: 确保WP_Query返回所有匹配的文章，而不是默认的分页数量。
2. 'fields' => 'ids': 这是一个性能优化技巧。当只需要文章数量而不需要文章的完整数据时，设置此参数可以显著减少数据库查询的开销。
3. 'tax_query' => array('relation' => 'AND', ...): 这是实现交集查询的核心。它告诉WordPress，后续的两个分类法条件必须同时满足。
4. 两个独立的分类法数组: 分别定义了主分类和次分类的查询条件，包括分类法名称、字段类型和要匹配的分类项值。
5. return $query->found_posts;: WP_Query对象的found_posts属性会返回查询到的总文章数，即使posts_per_page限制了返回的文章数量，它依然能给出准确的总数。这比post_count在分页场景下更可靠。

动态上下文中的应用

在某些场景下，例如在某个location分类归档页面中，我们可能需要动态获取当前的location分类信息。get_queried_object()函数可以帮助我们实现这一点。

/**
 * 在特定分类归档页获取文章数量，结合另一个指定分类。
 *
 * @param string $post_type        文章类型。
 * @param string $secondary_taxonomy_slug 次要分类法的别名（例如 'set'）。
 * @param mixed  $secondary_term_value    次要分类项的值（ID或slug）。
 * @param string $secondary_field_type    次要分类项的字段类型（'id'或'slug'）。
 * @return int|string              符合条件的文章数量，或错误信息。
 */
function get_post_count_in_current_taxonomy(
    $post_type,
    $secondary_taxonomy_slug,
    $secondary_term_value,
    $secondary_field_type
) {
    // 检查当前是否在分类归档页面
    if (!is_tax() && !is_category() && !is_tag()) {
        return 'Not on a taxonomy archive page.';
    }

    $current_obj = get_queried_object(); // 获取当前查询的对象（例如当前分类对象）

    // 确保获取到的是一个分类对象
    if (!($current_obj instanceof WP_Term)) {
        return 'Invalid queried object.';
    }

    $args = array(
        'post_type'      => $post_type,
        'post_status'    => 'publish',
        'posts_per_page' => -1,
        'fields'         => 'ids',
        'tax_query'      => array(
            'relation' => 'AND',
            array(
                'taxonomy' => $current_obj->taxonomy, // 当前页面的分类法