Parameter WP_Query untuk medan tersuai

Jika anda telah mengikuti siri ini, anda akan memahami struktur WP_Query dan cara menggunakannya untuk menulis pertanyaan tersuai. Untuk dapat mentakrifkan apa yang WP_Query dapat daripada pangkalan data, anda perlu mengetahui parameter yang boleh anda gunakan untuk menanyakan data. WP_Query 的结构以及如何使用它来编写自定义查询。为了能够定义 WP_Query 从数据库中获取的内容，您需要知道可以使用哪些参数来查询数据。

WP_Query 有大量可能的参数，这使得它非常灵活。由于您可以使用它来查询 wp_posts 表中保存的任何内容，因此它具有您可能想要在内容上运行的每个查询排列的参数。

在本教程中，我将了解自定义字段的参数。但首先，快速回顾一下如何在 WP_Query 中编写参数。

回顾 WP_Query 中参数的工作原理 在开始之前，让我们快速回顾一下参数在 WP_Query 中的工作原理。当您在主题或插件中编写 WP_Query 时，您需要包含四个主要元素：

查询的参数，使用本教程将介绍的参数 查询本身 循环 结束：关闭 if 和 while 标签并重置帖子数据 实际上，这将类似于以下内容：

<?php

$args = array( // Arguments for your query. );

// Custom query. $query = new WP_Query( $args );

// Check that we have query results. if ( $query->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

WP_Query mempunyai sejumlah besar kemungkinan parameter, yang menjadikannya sangat fleksibel. Memandangkan anda boleh menggunakannya untuk menanyakan sebarang kandungan yang disimpan dalam jadual wp_posts , ia mempunyai parameter untuk setiap pilih atur pertanyaan yang anda mungkin mahu jalankan pada kandungan tersebut. 🎜 🎜Dalam tutorial ini, saya akan belajar tentang parameter medan tersuai. Tetapi pertama sekali, penyegaran pantas tentang cara menulis parameter dalam WP_Query . 🎜 Semak cara parameter dalam WP_Query berfungsi 🎜Sebelum kita bermula, mari semak dengan pantas cara parameter berfungsi dalam WP_Query . Apabila anda menulis WP_Query dalam tema atau pemalam anda, anda perlu memasukkan empat elemen utama: 🎜 Parameter pertanyaan, gunakan parameter yang akan diperkenalkan dalam tutorial ini Pertanyaan itu sendiri Gelung Tamat: Tutup teg if dan semasa dan tetapkan semula data siaran 🎜Dalam amalan, ini akan kelihatan seperti berikut: 🎜 $args = array( 'meta_value' => 'value1' ); 🎜Parameter ini memberitahu WordPress data apa yang perlu diperoleh daripada pangkalan data, yang akan saya bincangkan di sini. Jadi perkara yang kami fokuskan di sini ialah bahagian pertama kod: 🎜 $args = array( 'meta_key' => 'key1', 'meta_compare' => '!=' ); 🎜Seperti yang anda lihat, parameter terkandung dalam tatasusunan. Semasa anda mengikuti tutorial ini, anda akan belajar cara mengekodnya. 🎜 Tulis parameter anda 🎜Parameter dalam tatasusunan mempunyai kaedah pengekodan khusus, seperti berikut: 🎜 $args = array( 'meta_key' => 'key1, key2', 'meta_compare' => 'NOT IN' ); 🎜Anda mesti menyertakan parameter dan nilainya dalam petikan tunggal, gunakan => di antaranya dan pisahkan dengan koma. Jika anda membuat kesilapan ini, WordPress mungkin tidak menambah semua parameter pada pertanyaan, jika tidak, anda mungkin melihat skrin putih. 🎜 Parameter medan tersuai 🎜Medan tersuai, juga dikenali sebagai metadata pos, boleh menggunakan kelas berasingan bernama WP_Meta_Query . Ini bermakna jika anda hanya mahu menjalankan pertanyaan pada metadata siaran, anda boleh menggunakan WP_Meta_Query atau WP_Query (lawati WP_Meta_Query ), dan jika anda ingin menanyakan metadata siaran dan item lain (seperti jenis siaran), gunakan WP_Query . 🎜 🎜 Kelas WP_Meta_Query telah dibincangkan secara terperinci di tempat lain dalam siri ini, jadi saya tidak akan menjelaskannya secara terperinci di sini, tetapi gunakan kelas ini dengan WP_Query Perbezaan utama antara ialah WP_Query membolehkan anda mencipta beberapa parameter mudah tanpa menggunakan tatasusunan bersarang. 🎜 Parameter pertanyaan medan tersuai ringkas 🎜Parameter utama menggunakan WP_Query untuk menanyakan medan tersuai adalah seperti berikut: 🎜 meta_key ( rentetan ): Kunci medan tersuai. meta_value ( String ): Nilai medan tersuai. meta_value_num ( nombor ): Nilai medan tersuai. meta_compare ( string ): Operator digunakan untuk menguji 'meta_value' . Nilai yang mungkin adalah '=' , '!=' , ''>' , '>= ' , ', ', 'Like' , 'Dislike' , 'In' kod> kod>, 'Not between' , 'Antara' , 'Not between' , 'Tidak wujud' , 'REGEXP' , 'REGEXP tidak wujud' atau 'RLIKE ' Nilai lalai ialah '=' . 🎜Gunakan parameter ini untuk pertanyaan medan tersuai yang mudah. Jadi sebagai contoh untuk mengeluarkan siaran dengan medan tersuai dengan kunci key1 (tanpa mengira nilainya), anda boleh menggunakan parameter berikut: 🎜 $args = array( 'meta_key' => 'numkey', 'meta_value' => '100', 'meta_compare' => '>' ); 🎜Ini akan mengembalikan semua siaran dengan medan tersuai dengan kekunci key1 , tidak kira apa nilainya. 🎜 🎜Jika anda ingin menentukan nilai, anda boleh menambah parameter tambahan pada ini: 🎜 $args = array( 'meta_key' => 'numkey', 'meta_value' => array ( '100', '200' ), 'meta_compare' => 'BETWEEN' ); 🎜Ini akan mengembalikan semua siaran dengan medan tersuai yang mengandungi kunci key1 dan nilai value1 . 🎜 🎜Sebagai alternatif, anda boleh menggunakan medan tersuai dengan nilai value1 untuk mendapatkan semua siaran, tidak kira apa kuncinya. Ini boleh berguna apabila anda mempunyai berbilang kunci medan tersuai dengan nilai pendua: 🎜 $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 类，稍后将介绍该类在这个系列中。

Parameter WP_Query untuk medan tersuai

Artikel berkaitan