このシリーズを読んでいると、WP_Query の構造と、それを使用してカスタム クエリを作成する方法が理解できるでしょう。 WP_Query がデータベースから何を取得するかを定義できるようにするには、データのクエリに使用できるパラメーターを知る必要があります。 WP_Query 使用可能なパラメータが多数あるため、非常に柔軟です。これを使用して wp_posts テーブルに保持されているコンテンツをクエリすることができるため、コンテンツに対して実行する可能性のあるクエリのすべての順列に対するパラメーターが含まれています。 このチュートリアルでは、カスタム フィールドのパラメーターについて学習します。その前に、WP_Query でパラメーターを記述する方法について簡単に復習してください。 WP_Query のパラメーターがどのように機能するかを確認する 始める前に、WP_Query でパラメーターがどのように機能するかを簡単に確認しましょう。テーマまたはプラグインで WP_Query を記述するときは、次の 4 つの主要な要素を含める必要があります。 クエリ パラメーター。このチュートリアルで紹介するパラメーターを使用します。 クエリ自体 ###サイクル### 終了: if タグと while タグを閉じて、投稿データをリセットします 実際には、これは次のようになります: リーリー これらのパラメータは、データベースからどのデータを取得するかを WordPress に指示します。これについては、ここで説明します。ここで注目するのは、コードの最初の部分です: リーリー ご覧のとおり、パラメータは配列に含まれています。このチュートリアルに従うにつれて、それらをコーディングする方法を学びます。 パラメータを記述します 配列内のパラメータには、次のような特定のエンコード方法があります: リーリー パラメータとその値は一重引用符で囲み、それらの間に => を使用し、カンマで区切る必要があります。この間違いを犯すと、WordPress がクエリにすべてのパラメーターを追加しない可能性があり、追加しないと白い画面が表示されることがあります。 カスタムフィールドパラメータ カスタム フィールド (ポスト メタデータとも呼ばれます) は、WP_Meta_Query という名前の別のクラスを使用できます。つまり、投稿メタデータに対してクエリを実行したいだけの場合は、WP_Meta_Query または WP_Query (WP_Meta_Query を参照) を使用できますが、クエリを実行したい場合は、WP_Meta_Query または WP_Query を使用できます。投稿のメタデータとその他の項目 (投稿タイプなど) では、WP_Query を使用します。 WP_Meta_Query クラスについては、このシリーズの他の場所で詳しく説明されているため、ここでは詳しく説明しませんが、このクラスの使用と WP_Query の主な違いは次のとおりです。 is WP_Query ネストされた配列を使用せずに、いくつかの単純なパラメータを作成できます。 単純なカスタムフィールドクエリパラメータ WP_Query を使用するカスタム フィールドをクエリするための主なパラメータは次のとおりです: meta_key (string): カスタム フィールド キー。 meta_value (String): カスタムフィールド値。 meta_value_num (number): カスタム フィールドの値。 meta_compare (string): 'meta_value' のテストに使用される演算子。可能な値は、'='、'!='、''>'、'>= '、##です。 # ', ', '好き', '嫌い', 'in', '間にありません', '', '間にありません', '存在しません', 'REGEXP'、'REGEXP' または 'RLIKE ' は存在しません。デフォルト値は '=' です。 これらのパラメータは、単純なカスタム フィールド クエリに使用します。たとえば、キー key1 (値に関係なく) を持つカスタム フィールドを含む投稿を出力するには、次のパラメーターを使用します: リーリー これにより、値が何であっても、キー key1 を持つカスタム フィールドを持つすべての投稿が返されます。 値を指定する場合は、これに追加のパラメーターを追加できます: リーリー これにより、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 类,稍后将介绍该类在这个系列中。