Paramètres WP_Query pour les champs personnalisés

Si vous avez suivi cette série, vous comprendrez que WP_Query 的结构以及如何使用它来编写自定义查询。为了能够定义 WP_Query pour extraire une base de données, vous devez savoir quels paramètres vous pouvez utiliser pour interroger les données.

WP_Query 有大量可能的参数，这使得它非常灵活。由于您可以使用它来查询 wp_posts Tout ce qui est enregistré dans une table, il comporte donc des permutations de paramètres pour chaque requête que vous souhaitez exécuter sur le contenu.

Dans ce tutoriel, je vais découvrir les paramètres des champs personnalisés. Mais d’abord, un petit rappel sur la façon d’écrire des paramètres dans WP_Query .

Examinez le fonctionnement des paramètres dans WP_Query Avant de commencer, examinons rapidement le fonctionnement des paramètres dans WP_Query 中的工作原理。当您在主题或插件中编写 WP_Query . Lorsque vous écrivez

dans un thème ou un plugin, vous devez inclure quatre éléments principaux : Paramètres de requête, utilisez les paramètres qui seront introduits dans ce tutoriel La requête elle-même Boucle if 和 while Fin : Fermez le tag et réinitialisez les données de publication

En pratique, cela ressemblera à ceci : <?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();

?>

Ces paramètres indiquent à WordPress quelles données obtenir de la base de données, que je couvrirai ici. Nous nous concentrons donc ici sur la première partie du code : $args = array( // Arguments for your query. );

Comme vous pouvez le voir, les paramètres sont contenus dans un tableau. En suivant ce tutoriel, vous apprendrez à les coder. Écrivez vos paramètres

Les paramètres du tableau ont une méthode d'encodage spécifique, comme suit : $args = array( 'parameter1' => 'value', 'parameter2' => 'value', 'parameter3' => 'value' ); => Vous devez mettre les paramètres et leurs valeurs entre guillemets simples, utiliser

entre eux et les séparer par des virgules. Si vous faites cette erreur, WordPress risque de ne pas ajouter tous les paramètres à la requête, sinon vous risquez de voir un écran blanc. Paramètres de champ personnalisés WP_Meta_Query 的单独类。这意味着，如果您只想对帖子元数据运行查询，则可以使用 WP_Meta_Query 或 WP_Query （访问 WP_Meta_Query ），而如果您想查询帖子元数据和其他项目（例如帖子类型），请使用 WP_Query Les champs personnalisés, également appelés métadonnées de publication, peuvent utiliser une classe distincte nommée WP_Meta_Query . Cela signifie que si vous souhaitez simplement exécuter une requête sur les métadonnées de publication, vous pouvez utiliser WP_Meta_Query ou

(visitez WP_Meta_Query ), Et si vous souhaitez interroger les métadonnées de la publication et d'autres éléments (tels que le type de publication), utilisez . WP_Meta_Query 类已在本系列的其他部分详细介绍，因此我不会在这里详细介绍该类，但使用该类与 WP_Query 之间的主要区别是 WP_Query La classe

WP_Meta_Query a été traitée en détail ailleurs dans cette série, je n'entrerai donc pas dans les détails de la classe ici, mais la principale différence entre l'utilisation de cette classe et est cela vous permet de créer des paramètres simples sans utiliser de tableaux imbriqués. WP_Query Paramètres pour une requête de champ personnalisé simple

Les principaux paramètres d'interrogation des champs personnalisés à l'aide de sont les suivants : meta_key ( string meta_value ) : Clé de champ personnalisée. ( String meta_value_num ) : valeur du champ personnalisé. ( number meta_compare ( string )：用于测试 'meta_value' 的运算符。可能的值为 '=' 、 '!=' 、 ''>' 、 '>= ' , ', ', '喜欢' , '不喜欢' , '在' , '不在' , '之间' , '不在之间' , '不存在' , 'REGEXP' , '不存在 REGEXP' 或 'RLIKE ' .默认值为 '=' ) : Valeur du champ personnalisé. meta_compare ( string key1 ) : Opérateur utilisé pour tester 'meta_value' . Les valeurs possibles sont '=' , '!=' , ''>' , '>= ' , ', ', 'J'aime' , 'Je n'aime pas' , 'Dans' code> code>, 'Pas entre' , 'Entre' , 'Pas entre' , 'N'existe pas' , 'REGEXP' , 'REGEXP existe n'existe pas' ou 'RLIKE ' La valeur par défaut est '=' .

key1 Utilisez ces paramètres pour des requêtes de champ personnalisées simples. Ainsi par exemple pour afficher des posts avec un champ personnalisé avec la clé

(quelle que soit sa valeur) vous pouvez utiliser le paramètre suivant : $args = array( 'meta_key' => 'key1' );

Cela renverra toutes les publications avec un champ personnalisé avec la touche , quelle que soit la valeur. key1 键和 value1

Si vous souhaitez spécifier une valeur, vous pouvez ajouter un paramètre supplémentaire à celle-ci : $args = array( 'meta_key' => 'key1', 'meta_value' => 'value1' ); value1 Cela renverra toutes les publications avec un champ personnalisé contenant une clé

et une valeur 🎜. 🎜 🎜Vous pouvez également utiliser un champ personnalisé avec une valeur 🎜 pour obtenir tous les messages, quelle que soit la clé. Cela peut être utile lorsque vous disposez de plusieurs clés de champ personnalisées avec des valeurs en double : 🎜 $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 类，稍后将介绍该类在这个系列中。

Paramètres WP_Query pour les champs personnalisés

Articles Liés