如果您一直在关注本系列,您将了解 WP_Query
的结构以及如何使用它来编写自定义查询。为了能够定义 WP_Query
从数据库中获取的内容,您需要知道可以使用哪些参数来查询数据。
WP_Query
有大量可能的参数,这使得它非常灵活。由于您可以使用它来查询 wp_posts
表中保存的任何内容,因此它具有您可能想要在内容上运行的每个查询排列的参数。
在本教程中,我将了解自定义字段的参数。但首先,快速回顾一下如何在 WP_Query
中编写参数。
回顾 WP_Query 中参数的工作原理
在开始之前,让我们快速回顾一下参数在 WP_Query
中的工作原理。当您在主题或插件中编写 WP_Query
时,您需要包含四个主要元素:
- 查询的参数,使用本教程将介绍的参数
- 查询本身
- 循环
- 结束:关闭
if
和while
标签并重置帖子数据
实际上,这将类似于以下内容:
登录后复制
这些参数告诉 WordPress 从数据库中获取哪些数据,我将在此处介绍这些数据。所以我们在这里关注的是代码的第一部分:
$args = array(
// Arguments for your query.
);
登录后复制
如您所见,参数包含在一个数组中。在学习本教程时,您将学习如何对它们进行编码。
编写你的参数
数组中的参数有一种具体的编码方式,如下:
$args = array(
'parameter1' => 'value',
'parameter2' => 'value',
'parameter3' => 'value'
);
登录后复制
您必须将参数及其值括在单引号中,在它们之间使用 =>
,并用逗号分隔它们。如果您犯了这个错误,WordPress 可能不会将所有参数添加到查询中,否则您可能会看到白屏。
自定义字段参数
自定义字段,也称为帖子元数据,可以使用名为 WP_Meta_Query
的单独类。这意味着,如果您只想对帖子元数据运行查询,则可以使用 WP_Meta_Query
或 WP_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'
);
登录后复制
这将查询没有带有 key1
或 key2
值的自定义字段的帖子。如果您想要更具体,也许查询具有一个自定义字段而不是另一个自定义字段的帖子,您可以使用嵌套数组,我们很快就会介绍这一点。
上面的示例使用非数字值。您可以将 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)其它相关文章!