自定义字段的WP_Query参数

2023年 8月 30日 88.5k 0

自定义字段的WP_Query参数

如果您一直在关注本系列,您将了解 WP_Query 的结构以及如何使用它来编写自定义查询。为了能够定义 WP_Query 从数据库中获取的内容,您需要知道可以使用哪些参数来查询数据。

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

在本教程中,我将了解自定义字段的参数。但首先,快速回顾一下如何在 WP_Query 中编写参数。

回顾 WP_Query 中参数的工作原理

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

  • 查询的参数,使用本教程将介绍的参数
  • 查询本身
  • 循环
  • 结束:关闭 ifwhile 标签并重置帖子数据

实际上,这将类似于以下内容:

登录后复制

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

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

登录后复制

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

编写你的参数

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

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

登录后复制

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

自定义字段参数

自定义字段,也称为帖子元数据,可以使用名为 WP_Meta_Query 的单独类。这意味着,如果您只想对帖子元数据运行查询,则可以使用 WP_Meta_QueryWP_Query(访问 WP_Meta_Query),而如果您想查询帖子元数据和其他项目(例如帖子类型),请使用 WP_Query

WP_Meta_Query 类已在本系列的其他部分详细介绍,因此我不会在这里详细介绍该类,但使用该类与 WP_Query 之间的主要区别是WP_Query 允许您创建一些简单的参数,而无需使用嵌套数组。

简单自定义字段查询的参数

使用WP_Query查询自定义字段的主要参数如下:

  • meta_key (string):自定义字段键。
  • meta_value (字符串):自定义字段值。
  • meta_value_num (number):自定义字段值。
  • meta_compare (string):用于测试 'meta_value' 的运算符。可能的值为 '=''!='''>''>= ', ', ', '喜欢', '不喜欢', '在', '不在', '之间', '不在之间', '不存在', 'REGEXP', '不存在 REGEXP''RLIKE '.默认值为 '='

使用这些参数进行简单的自定义字段查询。因此,例如要输出具有键 key1 (无论其值如何)的自定义字段的帖子,您可以使用以下参数:

$args = array(
'meta_key' => 'key1'
);

登录后复制

这将返回带有 key1 键的自定义字段的所有帖子,无论值是什么。

如果您想指定一个值,您可以为此添加一个额外的参数:

$args = array(
'meta_key' => 'key1',
'meta_value' => 'value1'
);

登录后复制

这将返回带有自定义字段的所有帖子,其中包含 key1 键和 value1 值。

或者,您可以使用值为 value1 的自定义字段获取所有帖子,无论键是什么。当您有多个具有重复值的自定义字段键时,这可能很有用:

$args = array(
'meta_value' => 'value1'
);

登录后复制

正如您所看到的,您可以只查询自定义字段的键或值,而不必总是指定两者。

使用meta_compare参数

您可能已经注意到上面的 meta_compare 参数有很多潜在参数,并且它们的使用可能并不总是立即显而易见。让我们看一下您可能最常使用的那些:

  • =:等于。这是默认设置,因此如果您不包含 meta_compare 参数,则 WP_Query 将使用此参数。
  • !+: 不等于。
  • >: 大于。
  • >=: 大于或等于。
  • : 小于。
  • : 小于或等于。
  • LIKE:这将忽略您使用的值的大小写,您还可以将其与通配符一起使用来查找与您要查找的值类似的值。
  • NOT LIKE:工作方式与 LIKE 类似,但查询相反!
  • IN:将其与“value”参数中的数组一起使用,以查找具有数组中一个或多个值的帖子。
  • BETWEEN:与两个数值的数组(在 meta_value 参数中指定)一起使用,以查找自定义字段值在这些值之间(但不等于它们)的帖子。
  • NOT BETWEEN:查询带有由 meta_value 参数指定的两个数值数组之外的自定义字段值的帖子。

让我们看一下该参数的一些示例用法。

首先,您可以使用 meta_compare 参数排除自定义字段键或值。因此,要获取除带有 key1 键的自定义字段之外的所有帖子,您可以使用以下命令:

$args = array(
'meta_key' => 'key1',
'meta_compare' => '!='
);

登录后复制

您还可以使用 'NOT IN' 值作为 meta_compare 参数,该参数也可以与多个值的字符串一起使用:

$args = array(
'meta_key' => 'key1, key2',
'meta_compare' => 'NOT IN'
);

登录后复制

这将查询没有带有 key1key2 值的自定义字段的帖子。如果您想要更具体,也许查询具有一个自定义字段而不是另一个自定义字段的帖子,您可以使用嵌套数组,我们很快就会介绍这一点。

上面的示例使用非数字值。您可以将 WP_Query 与具有数值的自定义字段一起使用,不仅可以获取具有该值的自定义字段的帖子,还可以获取具有更高或更低值的自定义字段的帖子。例如,如果您要查找高于或低于给定价格的商品,您可以在商店中使用此功能。

要查找自定义字段值高于给定数字的帖子,请使用如下内容:

$args = array(
'meta_key' => 'numkey',
'meta_value' => '100',
'meta_compare' => '>'
);

登录后复制

这将返回带有 numkey 键且值超过 100 的自定义字段的所有帖子。如果您想查询 100 或以上的值,您可以使用 'meta_compare' => '>='

您还可以查找自定义字段的值介于您使用 BETWEEN 参数和数组指定的两个数字之间的帖子:

$args = array(
'meta_key' => 'numkey',
'meta_value' => array (
'100',
'200'
),
'meta_compare' => 'BETWEEN'
);

登录后复制

这将找到 numkey 自定义字段中的值在 100 到 200 之间的所有帖子。

嵌套自定义字段查询

如果要查询多个自定义字段或使用多个运算符,可以使用嵌套数组。

它们采用以下结构:

$args = array(
'meta_query' => array(
'relation' => '', // Optional argument.
array(
// `meta_query` arguments go here.
)
)
);

登录后复制

WP_Query 中构建 'meta_query' 参数的方式与使用 WP_Meta_Query 类的方式完全相同,这将在本系列的后续教程中介绍,因此我不会在这里重复。

自 WordPress 4.1 版起,您还可以使用多层嵌套数组来创建更加复杂和精确的查询。这些看起来像这样:

$args = array(
'meta_query' => array(
'relation' => '', // Optional argument.
array(
'relation' => '',
array (
// First set of `meta_query` arguments go here.
),
array (
// Second set of `meta_query` arguments go here.
)
)
)
);

登录后复制

这使您可以在查询中的不同级别使用不同的关系,例如查询在一个自定义字段键中包含某个值的帖子,或在另一个自定义字段键中查询两个值同时存在的帖子。 WP_Meta_Query 类教程(本系列的一部分)对此进行了更详细的介绍,并附有示例。

摘要

使用 WP_Query 类来查询帖子的元数据(或自定义字段)为您提供了很大的灵活性,多个潜在参数与多个运算符相结合,可以帮助您准确地查询数据库按照您想要的方式进行。

如果您只想在查询中使用帖子元数据参数(而不是将其与其他参数结合使用,例如对于帖子类型),您还可以使用 WP_Meta_Query 类,稍后将介绍该类在这个系列中。

以上就是自定义字段的WP_Query参数的详细内容,更多请关注每日运维网(www.mryunwei.com)其它相关文章!

相关文章

JavaScript2024新功能:Object.groupBy、正则表达式v标志
PHP trim 函数对多字节字符的使用和限制
新函数 json_validate() 、randomizer 类扩展…20 个PHP 8.3 新特性全面解析
使用HTMX为WordPress增效:如何在不使用复杂框架的情况下增强平台功能
为React 19做准备:WordPress 6.6用户指南
如何删除WordPress中的所有评论

发布评论