如果您一直在關注本系列,您將了解 WP_Query 的結構以及如何使用它來編寫自訂查詢。為了能夠定義 WP_Query 從資料庫中取得的內容,您需要知道可以使用哪些參數來查詢資料。 WP_Query 有大量可能的參數,這使得它非常靈活。由於您可以使用它來查詢 wp_posts 表中保存的任何內容,因此它具有您可能想要在內容上執行的每個查詢排列的參數。 在本教程中,我將了解自訂欄位的參數。但首先,快速回顧一下如何在 WP_Query 中編寫參數。 回顧 WP_Query 中參數的工作原理 在開始之前,讓我們快速回顧一下參數在 WP_Query 中的工作原理。當您在主題或外掛程式中編寫 WP_Query 時,您需要包含四個主要元素: 查詢的參數,使用本教學將介紹的參數 查詢本身 循環 結束:關閉 if 和 while 標籤並重置帖子資料 實際上,這將類似於以下內容: 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 可能不會將所有參數新增到查詢中,否則您可能會看到白螢幕。 自訂欄位參數 自訂字段,也稱為帖子元數據,可以使用名為 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 类,稍后将介绍该类在这个系列中。