使用WP_Query参数筛选分类法

到目前为止，在本系列中，您已经了解了 WP_Query 的结构及其属性和方法。现在我们正在研究可与 WP_Query 一起使用的各种参数以及如何对它们进行编码。

WP_Query 有大量可能的参数，这使得它极其灵活。由于您可以使用它来查询 wp_posts 表中保存的任何内容，因此它具有您可能想要在内容上运行的每个查询排列的参数。

在本教程中，我将了解查询分类术语的参数。

• 分类参数
• 查询一个分类术语
• 查询一个分类中的多个术语
• 从多个分类中查询术语
• 嵌套分类查询

回顾 phpcnc 中的参数如何工作phpcn>WP_Query

在开始之前，让我们快速回顾一下参数在 WP_Query 中的工作原理。当您在主题或插件中编写 WP_Query 时，您需要包含四个主要元素：

• 查询的参数，使用本教程将介绍的参数
• 查询本身
• 循环
• 结束：关闭 if 和 class="inline">while 标签并重置帖子数据

实际上，这将类似于以下内容：

<?php

$args = array(
    // Arguments for your query.
);

// Custom query.
$query = new WP_Query( $args );

// Check that we have query results.
if ( $query->have_posts() ) {

    // Start looping over the query results.
    while ( $query->have_posts() ) {

        $query->the_post();

        // Contents of the queried post results go here.

    }

}

// Restore original post data.
wp_reset_postdata();

?>

这些参数告诉 WordPress 从数据库中获取哪些数据，我将在这里介绍这些数据。所以我们在这里关注的是代码的第一部分：

$args = array(
    // Arguments for your query.
);

如您所见，参数包含在一个数组中。在学习本教程时，您将学习如何对它们进行编码。

编写你的参数

数组中的参数有一种具体的编码方式，如下：

$args = array(
    'parameter1' => 'value',
    'parameter2' => 'value',
    'parameter3' => 'value'
);

必须将参数及其值括在单引号中，在它们之间使用 =>，并用逗号分隔它们。如果您犯了这个错误，WordPress 可能不会将所有参数添加到查询中，否则您可能会看到白屏。

分类参数

由于您使用 tax_query，因此为分类术语设置参数比为类别和标签设置参数要复杂一些。在此参数中，您可以编写一个嵌套的参数数组，以使用这些参数指定分类法和术语：

• 分类法（字符串）：分类法
• field (string): 选择分类术语 ('term_id (默认), 'name' 或 'slug')
• terms (int/string/array)：分类术语
• include_children（布尔值）：是否包含分层分类法的子级。默认为 true。
• operator (string): 要测试的运算符。可能的值为 'IN' （默认）、'NOT IN'、'AND'、'EXISTS'、和 “不存在”。

您拥有 operator 参数这一事实意味着您无需从一系列可用参数中进行选择来定义是包含还是排除术语（就像对标签所做的那样）和类别），但可以使用 tax_query 来代替所有与分类相关的内容。

如果您想查询多个分类法，您还可以在所有数组（每个分类法一个）之前使用 relation 参数，其中 AND 或 OR 指定您是要查找包含所有术语还是其中任何术语的帖子。

通过一些例子可以很容易地解释这一点。

查询一个分类术语

这是最简单的场景，仅涉及使用一个嵌套数组：

$args = array(
    'tax_query' => array(
        array(
            'taxonomy' => 'category',
            'field' => 'slug',
            'terms' => 'tutorial',
        )
    )
);

上述查询是针对 category 分类中包含 tutorial 术语的帖子。请注意，您还需要使用 field 参数来标识您使用哪个字段来标识术语，除非您使用默认的术语 ID。如果您想使用术语 ID，您可以使用如下内容：

$args = array(
    'tax_query' => array(
        array(
            'taxonomy' => 'category',
            'terms' => '11'
        )
    )
);

使用 ID 会使您以后更难确定查询要查找的内容，但如果您认为用户可能会编辑术语 slugs，则可以避免任何潜在问题。

查询一个分类中的多个术语

如果您想识别具有同一分类中的一个或多个术语数组的帖子，您仍然可以编写一个嵌套数组，但添加一组术语。

例如，要查询包含分类中任何术语 ID 列表的帖子，您可以使用：

$args = array(
    'tax_query' => array(
        array(
            'taxonomy' => 'post_tag',
            'terms' => [14, 17]
        )
    )
);

但是如果您想查询包含这些术语的所有帖子怎么办？您需要在嵌套数组中使用 operator 参数：

$args = array(
    'tax_query' => array(
        array(
            'taxonomy' => 'post_tag',
            'terms' => [14, 17],
            'operator' => 'AND'
        )
    )
);

请注意，第一个示例实际上使用 IN 运算符来查找包含任何术语的帖子，但由于这是默认值，因此您不必在参数中指定它。

另一种情况是，如果您想要查询在一个分类中没有任何术语数组的帖子，您可以这样做：

$args = array(
    'tax_query' => array(
        array(
            'taxonomy' => 'post_tag',
            'terms' => [14, 17],
            'operator' => 'NOT IN'
        )
    )
);

在这里，我将 AND 运算符替换为 NOT IN，这意味着 WordPress 将查找数组中不包含任何术语的帖子。

请注意，如果您更喜欢使用 slugs 而不是术语 ID，则可以在任何这些场景中执行此操作。最后一个示例如下所示：

$args = array(
    'tax_query' => array(
        array(
            'taxonomy' => 'post_tag',
            'field' => 'slug',
            'terms' => ['php', 'strings'],
            'operator' => 'NOT IN'
        )
    )
);

从多个分类中查询术语

如果您想要使用多个分类法，则需要创建多个数组。让我们看一个最简单的示例，查询包含类别分类中的一个术语和标签分类中的一个术语的帖子：

$args = array(
    'tax_query' => array(
        'relation' => 'AND',
        array(
            'taxonomy' => 'category',
            'field' => 'slug',
            'terms' => ['tutorial']
        ),
        array(
            'taxonomy' => 'post_tag',
            'field' => 'slug',
            'terms' => ['javascript']
        )
    )
);

在这里，我编写了两个嵌套数组：每个分类法一个，使用与仅使用一种分类法的示例相同的参数。我在这些之前添加了 relation 参数。您需要包含 relation 参数来告诉 WordPress 是否正在查找每个数组输出的全部或部分帖子。其工作原理如下：

• 如果您使用 'relation' => 'AND'，WordPress 将获取第一个数组和第二个数组中指定的帖子。因此，在上面的示例中，仅发布两者 类别中的 tutorial slug 和 中的 javascript slug post_tag 将被查询。
• 如果您使用 'relation' => 'OR'，WordPress 将获取第一个数组或第二个数组输出的帖子。因此，在这种情况下，您将收到带有 tutorial slug 或 javascript slug（或两者）的帖子。

$args = array(
    'tax_query' => array(
        'relation' => 'OR',
        array(
            'taxonomy' => 'category',
            'field' => 'slug',
            'terms' => ['tutorial']
        ),
        array(
            'taxonomy' => 'post_tag',
            'field' => 'slug',
            'terms' => ['javascript']
        )
    )
);

$args = array(
    'tax_query' => array(
        'relation' => 'OR',
        array(
            'taxonomy' => 'category',
            'field' => 'slug',
            'terms' => ['guide']
        ),
        array(
            'taxonomy' => 'post_tag',
            'field' => 'slug',
            'terms' => ['php', 'strings']
        )
    )
);

$args = array(
    'orderby' => 'title',
    'tax_query' => array(
        'relation' => 'AND',
        array(
            'taxonomy' => 'category',
            'field' => 'slug',
            'terms' => ['tutorial'],
            'operator' => 'NOT IN'
        ),
        array(
            'taxonomy' => 'post_tag',
            'field' => 'slug',
            'terms' => ['php', 'math'],
            'operator' => 'AND'
        )
    )
);

$args = array(
    'tax_query' => array(
        'relation' => 'OR',
        array(
            'taxonomy' => 'category',
            'field' => 'slug',
            'terms' => ['guide'],
        ),
        array(
            'relation' => 'AND',
            array(
                'taxonomy' => 'category',
                'field' => 'slug',
                'terms' => ['tutorial'],
            ),
            array(
                'taxonomy' => 'post_tag',
                'field' => 'slug',
                'terms' => ['php', 'strings'],
                'operator' => 'AND'
            )
        )
    )
);

$args = array(
    'taxonomy1' => 'slug-one'
);