WP_Query 的 meta_query 参数允许根据元数据来搜索WordPress文章/页面/自定义文章类型,并对结果进行排序。
例如想获得一个包含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> = 5)–如果特定meta键的meta值存在或为空/ null。
$args = array(
'meta_query' => array(
array(
'key' => 'misha_key',
'compare' => 'EXISTS'
)
)
);
实际上它会检查是否存在meta键,甚至不必通过此参数传递任何值。
- NOT EXISTS (WordPress> = 5)–如果给定的meta键根本不存在
- REGEXP (WordPress> = 7)–它允许将meta值与正则表达式进行比较,例如:
$args = array(
'meta_query' => array(
array(
'key' => 'misha_key',
'value' => '^[0-9]*$', // "misha_key" 必须只是数字
'compare' => 'REGEXP'
)
)
);
- NOT REGEXP(WordPress> = 7)–与REGEXP 相似,但元值必须不匹配给定的正则表达式
- RLIKE (WordPress> = 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 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降序对文章进行排序。