Section courante

A propos

Section administrative du site

WP_Query

 WordPress : Requête
PHP WordPress

Description

Cette classe permet de traiter un poste d'article ou d'une page de WordPress.

Liste des méthodes

Nom Prototype Description
WP_QUERY WP_Query($query = '') Ce constructeur permet de créer l'objet et d'appeler la méthode query() si un paramètre est fournit.
GET get($query_var) Cette méthode permet de demander une variable de requête spécifié.
GET_POSTS &get_posts() Cette méthode permet de demander et retourner les postages d'articles dans la base de données.
GET_QUERIED_OBJECT get_queried_object() Cette méthode permet de fixer $queried_object si ce n'est pas déjà fait et de retourner son contenu.
GET_QUERIED_OBJECT_ID get_queried_object_id() Cette méthode permet de fixer $queried_object_id si ce n'est pas déjà fait et de retourner son contenu.
HAVE_POSTS have_posts() Cette méthode permet de vérifier s'il reste des postages d'articles à afficher.
INIT init() Cette méthode permet d'initialiser l'objet, fixer tous les propriétés à nulle, 0 ou faux.
NEXT_POST next_post() Cette méthode permet d'avancer au prochain postage d'article.
PARSE_QUERY parse_query($query) Cette méthode permet de prend une chaîne de caractères de requête définissant la requête, l'analyse et remplit toutes les propriétés à l'exception de $posts, $post_count, $post et $current_post.
PARSE_QUERY_VARS parse_query_vars() Cette méthode permet de réinitialiser la chaîne de caractères des anciennes requêtes.
QUERY &query($query) Cette méthode permet d'appeler parse_query() et get_posts().
REWIND_POSTS rewind_posts() Cette méthode permet de réinitialiser $current_post et $post.
SET set($query_var,$value) Cette méthode permet de fixer la variable de requête avec la valeur spécifié.
THE_POST the_post() Cette méthode permet d'avancer au prochain postage d'article et de fixer la variable $post global avec son contenu.

Exemples

L'exemple suivant permet d'avoir la liste des postages d'article par certains auteur :

  1. <?php
  2. require( dirname( __FILE__ ) . '/wp-blog-header.php' );
  3.  
  4. $query = new WP_Query(array(
  5.     'author' => '1,2,3,',                     //(int) - utilise l'identificateur de l'auteur [utilise moins (-) afin d'exclure les auteurs par identificateur. Exemple 'author' => '-1,-2,-3,']
  6.     'author_name' => 'smaltais',              //(string) - utilise 'user_nicename' (Ce n'est pas un nom propre)
  7.     'author__in' => array( 2, 5 ),            //(array) - utilise l'identificateur de l'auteur (disponible avec Version 3.7).
  8.     'author__not_in' => array( 2, 5 )
  9. ));
  10. var_dump($query);
  11. ?>

L'exemple suivant permet de rechercher un article de type «newsletter» avec un champ «acf_newspaper_category» ayant la valeur 700 contenu dans le plugiciels ACF :

  1. <?php
  2. require( dirname( __FILE__ ) . '/wp-blog-header.php' );
  3.  
  4. $query = new WP_Query(array(
  5.                             'post_type' => 'newspaper',
  6.                             'post_status' => 'publish',
  7.                             'meta_query'        => array(
  8.                                 'relation'        => 'AND',
  9.                                 array(
  10.                                 'key'         => 'acf_newspaper_category',
  11.                                 'value'      => 700,
  12.                                 'compare'     => '='
  13.                                 )
  14.                             )
  15.                         ));
  16. var_dump($query);
  17. ?>

Légende

    Cette couleur permet d'indiquer qu'il s'agit d'un constructeur d'objet.



Dernière mise à jour : Dimanche, le 10 Juin 2018