Quels sont tous les paramètres disponibles pour query_posts?

20

La page de codex WordPress pour query_posts indique qu'elle ne couvre pas tous les paramètres pris par query_posts:

Paramètres

Cette liste n'est pas encore exhaustive. Il est destiné à montrer certaines des choses les plus courantes possibles avec la définition de vos propres requêtes

Je n'ai pas pu trouver une référence de tous les paramètres qui sont acceptés par query_posts, même dans un simple formulaire de liste. Existe-t-il un cheat-sheet ou quelque chose de similaire disponible avec ces données?

themes query-posts personne
la source
Vous ne devriez jamais utiliser query_posts, c'est une mauvaise pratique, utilisez WP_Queryou le pre_get_postsfiltre à la place
Tom J Nowell

Réponses:

24

Vous trouverez ci-dessous tout ce qui se trouve dans WordPress 3.0.1 dans la parse_query()fonction de /wp-includes/query.php (lines 1246-1550) .
Cependant, il est possible qu'un plugin ajoute des paramètres et donc une liste ne peut jamais être complète:

  • attachment
  • attachment_id
  • author
  • author_name
  • cat
  • category__and
  • category__in
  • category__not_in
  • category_name
  • comments_popup
  • day
  • error
  • feed
  • hour
  • m
  • minute
  • monthnum
  • name
  • order
  • orderby
  • p
  • page_id
  • page
  • paged
  • pagename
  • post__in
  • post__not_in
  • post_status
  • post_type
  • preview
  • robots
  • s
  • sentence
  • second
  • static
  • subpost
  • subpost_id
  • tag__and
  • tag__in
  • tag__not_in
  • tag_id
  • tag_slug__and
  • tag_slug__in
  • tag
  • taxonomy - (avant 3.1)
  • tb
  • term - (avant 3.1)
  • w
  • withcomments
  • withoutcomments

  • year

    Pré WP 3.1

  • meta_key

  • meta_value

    Depuis WP 3.1

  • fields
  • meta_query
  • tax_query
MikeSchinkel
la source
J'étais JUSTE à la recherche de cette liste hier!
Dan Gayle
2
Si vous pouviez rééditer votre question et en faire un wiki communautaire, nous pourrions tous la garder à jour lorsque les choses changeraient. Les types de paramètres (formats: int ou chaîne?, Plusieurs valeurs?) Seraient également intéressants.
Jan Fabry
@Mike - J'ai ajouté des variables de requête manquantes dans votre réponse et ajouté de nouvelles variables de requête 3.1.
t31os
@Mike - Pas de problème, je suis sûr qu'il en manque encore quelques-uns, mais étant donné que nous avons couvert les points importants, je n'allais pas chercher à en avoir tous les derniers (il y en a beaucoup là-dedans que personne ne pourra jamais utilisez déjà - la phrase ou la seconde sont deux que je n'ai jamais vues utilisées) ... :)
t31os
@ t31os - Pour votre information , je travaille actuellement sur un plugin qui fera en sorte de tout cela, et plus que je suis très excité à propos. C'est un plugin de routage URL de nouvelle génération. Intéressé?
MikeSchinkel
7

Si vous pouvez lire du code PHP, vous pouvez jeter un oeil à la fonction parse_query($query)dans la classe WP_Queryde fichierwp-includes\query.php

Les arguments pris en charge y sont tous répertoriés et gérés.

Canard
la source
1
+1, le code est la référence faisant autorité. (Pas le codex, ni la fonction comment / docblock.)
Annika Backstrom