WP_Query 的 meta_query 参数允许您根据元数据来搜索WordPress文章/页面/自定义文章类型,并对结果进行排序。
在本文中,我假设您已经具备如何在WordPress中使用 WP_Query 类的基本知识。建议先阅读《掌握 WP_Query》系列教程。
在开始之前,我想向您展示一些非常简单的示例。您也可以在WordPress Codex中找到类似的示例。
众所周知,所有文章都有元数据( metadata ),您可以在“自定义字段”元框中填充元数据(顺便说一下,该元框可以隐藏)。因此,例如,如果您想获得一个包含meta键show_on_homepage
和meta值的帖子on
,可以通过以下方式进行操作:
$rd_args = array(
'meta_key' => 'show_on_homepage',
'meta_value' => 'on'
);
$rd_query = new WP_Query( $rd_args );
或者,如果您需要查询除带有此对元键和值的所有文章外的其他文章,可以使用以下参数:
$rd_args = array(
'meta_key' => 'show_on_homepage',
'meta_value' => 'on',
'meta_compare' => '!='
);
$rd_query = new WP_Query( $rd_args );
需要注意的是,本文中的所有示例都经过简化,因此缺少一些WP_Query参数,例如
posts_per_page
或post_type
。
如果您对其他meta_compare
参数值比较感兴趣,请查看下面的 “ compare”参数说明,因为它们都接受相同的值。
这是一个非常简单的示例,只是作为介绍。但是这篇文章是关于meta_query
参数的。这个参数允许我们创建一个非常酷的文章过滤器和搜索脚本。
通过一个Meta值获取文章
下面的示例使您可以获取具有特定自定义字段值的所有文章。让我们获取所有具有自定义字段名称“ color”和自定义字段值white
的文章。
// the meta_key 'color' with the meta_value 'white'
$rd_args = array(
'meta_query' => array(
array(
'key' => 'color',
'value' => 'white'
)
)
);
$rd_query = new WP_Query( $rd_args );
如果您在与查询匹配的任何文章中查看文章的编辑页面(在后台中),您将在“自定义字段”部分中看到以下内容:
让我们做相反的事情–获取除带有meta键“ color”和meta 值white
以外的所有文章 :
$rd_args = array(
'meta_query' => array(
array(
'key' => 'color',
'value' => 'white',
'compare' => '!='
)
)
);
$rd_query = new WP_Query( $rd_args );
通过多个Meta值获取文章
现在,让我们获取所有自定义字段“color”包含white
或green
字段值的文章:
// 自定义字段名为 color ,值为 'white' 或 'green'
$rd_args = array(
'meta_query' => array(
array(
'key' => 'color',
'value' => array('white','green'),
'compare' => 'IN'
)
)
);
$rd_query = new WP_Query( $rd_args );
获取除白色产品和绿色产品以外的所有产品(例如,在线商店中的产品):
$rd_args = array(
'meta_query' => array(
array(
'key' => 'color',
'value' => array('white','green'),
'compare' => 'NOT IN'
)
)
);
$rd_query = new WP_Query( $rd_args );
如何使用meta_query中的 compare
正如您本文的示例中看到的那样,每个示例中都有一个 compare
参数。现在,我想展示它可以接受的值以及它们的含义。
-
=
等于(默认) !=
不等于<
小于<=
小于或等于>
大于>=
大于或等于,例如
// 此示例中的产品价格为2000或2000以上:
$args = array(
'meta_query' => array(
array(
'key' => 'price',
'value' => 2000,
'type' => 'numeric', //将其指定为数值
'compare' => '>='
)
)
);
LIKE
-允许在meta值来搜索特定字符串,在查询下面的示例中,我们查询“first_name”字段中,包含有John
( 也可以是Johnny
,Johnathan
,somethingJohnsomething
)的所有文章:
$args = array(
'meta_query' => array(
array(
'key' => 'first_name',
'value' => 'John',
'compare' => 'LIKE'
)
)
);
还有,它不区分大小写,也不需要通配符 @
。
NOT LIKE
–类似于LIKE
相反的工作方式–meta值不能包含给定的字符串。IN
– 文章meta值必须包含给定数组的值之一,您可以参见【通过多个Meta值获取文章】的示例NOT IN
–meta值不能包含给定数组中的任何值。BETWEEN
–文章meta值应在给定的值范围之间,例如:
//产品价格超过2000和小于4000
$args = array(
'meta_query' => array(
array(
'key' => 'price',
'value' => array( 2000, 4000 ),
'type' => 'numeric',
'compare' => 'BETWEEN'
)
)
);
它也可以用于日期,也可以查看下面的示例。
NOT BETWEEN
–不在给定范围内。EXISTS
(WordPress> = 3.5)–如果特定meta键的meta值存在或为空/ null。
$args = array(
'meta_query' => array(
array(
'key' => 'misha_key',
'compare' => 'EXISTS'
)
)
);
实际上它会检查是否存在meta键,您甚至不必通过此参数传递任何值。
NOT EXISTS
(WordPress> = 3.5)–如果给定的meta键根本不存在REGEXP
(WordPress> = 3.7)–它允许您将meta值与正则表达式进行比较,例如:
$args = array(
'meta_query' => array(
array(
'key' => 'misha_key',
'value' => '^[0-9]*$', // "misha_key" 必须只是数字
'compare' => 'REGEXP'
)
)
);
NOT REGEXP
(WordPress> = 3.7)–与REGEXP
相似,但元值必须不匹配给定的正则表达式RLIKE
(WordPress> = 3.7)–它是REGEXP
的同义词
在日期中使用 "compare => between"
您还可以meta_query
用来检查自定义字段是否在两个日期之间。
您必须牢记的最重要的一点是,日期格式应为YYYY-MM-DD
或YYYY/MM/DD
或类似的格式(如果需要,年份会排在第一位,然后是月份,然后是日期,然后是时间)。检查它在数据库中的存储方式–如果以其他格式存储,例如首先使用“天”,那么在您更改数据库中的日期之前,过滤对您不起作用。
array(
'key' => 'sale_day',
'value' => array( '2018-01-01', '2018-01-09' ),
'compare' => 'BETWEEN'
)
如果日期以UNIX时间存储,例如:1543391233
,那么一切将变得非常简单:
array(
'key' => 'sale_day',
'value' => array( strtotime('2018-01-01'), strtotime('2018-01-09') ),
'type' => 'numeric',
'compare' => 'BETWEEN'
)
通过多对meta字段查询文章
现在,我将向您展示如何通过几个(两个或多个)自定义字段值来组合文章。首先,让我为您介绍relation
可以接受两个值的参数- OR
或AND
(默认值)。
// 'color'是'white'并且'price'大于2000且小于4000
$rd_query = new WP_Query( array(
'meta_query' => array(
'relation' => 'AND', // 以下条件两者都必须匹配
array(
'key' => 'show_on_homepage',
'value' => 'on'
),
array(
'relation' => 'OR', // 仅'color'或'price'必须匹配
array(
'key' => 'color',
'value' => 'white'
),
array(
'key' => 'price',
'value' => array( 2000, 4000 ),
'type' => 'numeric',
'compare' => 'BETWEEN'
)
)
)
) );
如您所见,在上面的meta_query
查询中,我们使用了多个 relation
。
根据meta值排序文章("orderby"
和 "order"
参数 )
我将向您展示如何通过meta值对文章进行排序的不同示例。首先,看一下这个简单的代码示例,其中我们甚至不使用 meta_query
:
$args = array(
'meta_key' => 'misha_key',
'orderby' => 'meta_value'
);
现在,假设misha_key
只包含数字值,我们可以针对这种情况稍微更改一下代码。
$args = array(
'meta_key' => 'misha_key',
'orderby' => 'meta_value_num'
);
但是如何与 meta_query
一起使用呢?简单,只需按以下方式更改我们的代码即可:
$args = array(
'meta_query' => array(
'misha_clause' => array(
'key' => 'misha_key',
'compare' => 'EXIST'
)
),
'orderby' => 'misha_clause'
);
根据多个meta值排序文章
从 WordPress 4.2 开始,就允许通过多个meta值排序文章
$args = array(
'meta_query' => array(
'relation' => 'AND',
'price_clause' => array(
'key' => 'price',
'value' => array( 2000, 4000 ),
'type' => 'numeric',
'compare' => 'BETWEEN'
),
'misha_clause' => array(
'key' => 'misha_key',
'compare' => 'EXISTS'
),
),
'orderby' => array(
'price_clause' => 'ASC',
'misha_clause' => 'DESC'
),
);
上面示例中,我们通过price_clause
升序对文章进行排序,然后通过misha_clause
降序对文章进行排序。
声明:本文出自 https://rudrastyh.com/wordpress/meta_query.html ,由WordPress大学翻译整理。