Comment effectuer des requêtes dans WordPress avec WP_Query ?

Besoin d’interroger votre base de données ? 🔍 Grâce à WP_Query, vous pouvez créer des requêtes WordPress ultra-personnalisées 🛠️ pour n’afficher que les contenus qui comptent. Que vous filtriez par catégorie, date ou champ personnalisé, cette mise à jour vous guide pas à pas, tout en intégrant les bonnes pratiques de performance et de sécurité recommandées par LWS. 🚀

Objectif

Cet article a pour objectif de vous aider à effectuer des requêtes dans WordPress avec WP_Query de façon simple et efficace, dans le but d’interagir efficacement avec votre base de données.

Prérequis

Pour suivre ce tutoriel, vous devez avoir installé WordPress sur votre hébergement web. Vous devez aussi savoir comment intégrer du code dans WordPress. En plus de tout cela, vous devez maîtriser les langages HTML, CSS et le langage PHP avec une bonne partie de ses méthodes et propriétés.

Il est recommandé de disposer d’une sauvegarde récente, et de travailler sur un environnement de test (staging).

Une solution clés en main pour créer un site WordPress ?

LWS vous conseille sa formule d’hébergement WordPress en promotion à -42% (offre à partir de 3,49€ par mois au lieu de 5,99 €). Non seulement les performances sont au rendez-vous mais vous profitez en plus d’un support exceptionnel.

Découvrir l'offre

Qu’est-ce que WP_Query ?

WP_Query est une classe PHP. Pour sa base de données, WordPress utilise cette classe. Elle est conçue pour plusieurs tâches, mais WordPress l’utilise principalement pour l’extraction de ses publications des bases de données. Elle sert à faire des requêtes comme on peut le constater dans son nom. Ces requêtes s’effectuent uniquement à base des arguments que vous lui avez fournis.

Comment utiliser WP_Query avec une boucle personnalisée ?

La classe WP_Query est la meilleure pour vous si vous êtes à vos débuts avec les codes WordPress. C’est une classe que vous aurez en réalité plus de facilité à maîtriser. Vous pouvez l’utiliser avec une boucle personnalisée. C’est une notion très importante que vous devez bien cerner. Par le biais de la boucle, vous pouvez questionner la base de données, et la gérer facilement.

C’est un outil que vous pouvez personnaliser, et utiliser comme vous le voulez. C’est pour cela qu’on parle de boucle personnalisée. Les réponses que vous aurez ne seront qu’en fonction de la manière dont vous avez fait les paramétrages. Les bases de la boucle sont les suivantes :

<?php
if ( posts() ) :
while ( posts() ) : post();
// Afficher le contenu du message
endwhile;
endif;
?>

L’interprétation de ce code est simple : les messages doivent forcément être affichés. Il est possible que vous éditiez ces bases, pour en ajouter les vôtres. Ainsi, c’est le message de votre choix qui va s’afficher. Voici un exemple de personnalisation :

<?php

// La requête
$requête = new WP_Query( $args );

// La boucle
if ( $requête->have_posts() ) {
echo '<ul>';
while ( $requête->posts() ) {
$requête->post();
echo '<li>' . get_the_title() . '</li>';
}
echo '</ul>';
} else {
// pas de message trouvé
}
/* Restore original Post Data */
wp_reset_postdata();

La différence entre ce code et le précédent est la partie où il y a une instruction WP supplémentaire. Cette instruction va permettre de spécifier les messages qui seront affichés. Avec cette technique, vous avez même la possibilité d’exclure un auteur d’une publication. Voici la méthode pour le faire en utilisant WP_Query dans la boucle :

$query = new WP_Query( array( 'auteur' => -5 ) );

Avec cette requête, les messages qui seront affichés ne vont pas prendre en compte l’auteur dont le numéro est 5. Cette méthode est personnalisable. Vous avez ainsi une possibilité infinie de choses à faire avec.

Maîtriser les paramètres pour effectuer des requêtes dans WordPress avec WP_Query

Il y a plusieurs méthodes possibles pour effectuer des requêtes dans WordPres avec WP_Query : vous pouvez modifier des objets avec des méthodes et des propriétés. Il n’est pas conseillé de modifier directement les classes WP_Query.

L’utilisation des méthodes est liée aux fonctions, tandis que l’utilisation des propriétés est liée aux variables.

Le paramètre Category est le plus populaire, il permet de spécifier les catégories à afficher dans l’entête de votre site.

Plus de 100 paramètres sont proposés dans WP_Query. Il est ainsi possible de demander n’importe quelles publications triées selon certains critères comme l’auteur, le nombre de commentaires, la date de publication, le statut de publication, etc.

Besoin d’un hébergeur pour votre site ?

Découvrez l'offre exclusive de LWS : hébergement web à -63% ! Commencez dès maintenant à seulement 1,49€/mois au lieu de 3,99€. Profitez de performances optimales et d'un support exceptionnel. 🔥🚀

Découvrir l’offre

Utiliser WP_Query manuellement

Créer/activer un thème enfant

1. Apparence › Thèmes → “Ajouter un thème enfant” (WP Manager)

2. Vérifiez la présence d’un fichier functions.php vide.

Ouvrir functions.php

• Via File Manager (LWS Panel) ou FTP.

• Placez le squelette suivant (pour l’exemple, nous cherchons à lister 5 articles tutoriels) :

function lws_custom_query_example() {

  // 1. Arguments de la requête
  $args = array(
    'post_type'      => 'post',
    'posts_per_page' => 5,
    'category_name'  => 'tutoriels',
    'orderby'        => 'date',
    'order'          => 'DESC'
  );

  // 2. Exécution
  $query = new WP_Query( $args );

  // 3. Affichage
  if ( $query->have_posts() ) {
    echo '<ul class="lws-loop">';
    while ( $query->have_posts() ) {
      $query->the_post();
      echo '<li><a href="'.get_permalink().'">'.get_the_title().'</a></li>';
    }
    echo '</ul>';
  } else {
    echo '<p>Aucun article trouvé.</p>';
  }

  // 4. Nettoyage
  wp_reset_postdata();
}

Afficher la boucle

Dans le template concerné (ex. front-page.php) :

<?php lws_custom_query_example(); ?>

• Limitez posts_per_page.

• Utilisez wp_reset_postdata() pour ne pas casser la boucle principale.

Utiliser WP_Query avec un plugin (Code Snippets)

Installer Code Snippets

1. Extensions › Ajouter

2. Recherchez “Code Snippets” → Installer puis Activer.

Ajouter une requête

1. Snippets › Ajouter un nouveau

2. Choisissez votre titre

3. Collez le même code PHP que ci-dessus (sans l’appel de fonction).

4. Cochez “Exécuter partout” et Enregistrer.

5. Copiez le shortcode généré (ex. [lws_custom_query_example]) et collez-le dans votre page ou widget.

Avantages de la méthode plugin

• Aucun fichier thème modifié.

• Facile à désactiver sans risque.

• Historique et export possible des snippets.

Besoin d'un hébergement web au meilleur prix ?

Saisissez l'opportunité avec LWS : hébergement web en promo à -63% ! Commencez à seulement 1,49€/mois plutôt que 3,99€. Profitez de performances solides 🚀 et d'un support client remarquable. 🌟

Découvrir l'offre

Utiliser WP_Query via LWS

Chez LWS, vous disposez d’outils qui simplifient la gestion et le test de vos requêtes :

1. WP Manager LWS : clonez votre site en un clic vers un environnement de staging pour expérimenter de nouvelles boucles sans risquer votre site en production.

2. Gestionnaire de fichiers cPanel / File Manager LWS Panel : éditez rapidement votre fichier functions.php ou vos templates et insérez votre code new WP_Query( $args ) directement depuis le navigateur.

3. PhpMyAdmin : surveillez l’impact de vos requêtes sur la base de données et vérifiez les index pour garder des temps de réponse optimaux.

Besoin d'un hébergement cPanel au meilleur prix ?

LWS vous conseille sa formule d’hébergement cPanel en promotion à -40% (offre à partir de 2,99€ par mois au lieu de 4,99 €). Non seulement les performances sont au rendez-vous mais vous profitez en plus d’un support exceptionnel.

Découvrir l'offre

Conclusion

Vous savez maintenant utiliser WP_Query de deux manières : manuellement via functions.php ou sans code grâce à Code Snippets. Testez, optimisez vos paramètres… et profitez des outils LWS pour un déploiement sécurisé et performant.

Une question, une astuce ? Partagez-la en commentaire !