Dans cette leçon du didacticiel sur le thème WordPress pour les débutants, nous aborderons en détail la "boucle de publication" dans WordPress ; qu’est-ce que c’est, à quoi elle ressemble, pourquoi nous l’utilisons et comment accéder aux publications. Nous passerons ensuite à la mise en œuvre de la boucle dans notre thème.
La boucle de poste
Si vous connaissez PHP, vous reconnaîtrez peut-être qu’une "boucle" est une technique consistant à parcourir chaque élément d’un tableau ou d’un objet avec for, foreachou while. La boucle dans WordPress fonctionne exactement comme ça. Mais nous utiliserons les propres fonctions de WordPress pour boucler afin d’obtenir des avantages et des simplifications supplémentaires.
À tout moment, WordPress a déjà interrogé les publications pour vous, en fonction de la page sur laquelle vous vous trouvez. Si vous êtes sur une page de catégorie, WordPress a déjà interrogé tous les articles associés à cette catégorie, et si vous êtes sur une seule page d’article, WordPress a déjà récupéré cet article pour vous.
Lorsque nous voulons accéder aux articles que WordPress a interrogés dans nos modèles, nous ajoutons la boucle. À l’intérieur de la boucle, nous avons accès à chaque poste. Et pour chaque publication, nous décidons quoi montrer ou faire.
Remarque : même dans les modèles de publication unique ou de page unique, vous ajouterez une boucle, même si nous savons qu’elle ne contient qu’une seule publication ! La boucle ne s’exécute qu’une seule fois.
Voici la boucle WordPress dans toute sa splendeur :
while (have_posts()): the_post();
// Access to each post here
endwhile;Ce morceau de code fait deux choses. La whilepartie (y compris le endwhile) est la partie en boucle qui bouclera aussi longtemps qu’il reste des messages. La deuxième partie est la the_post()qui met en place un accès simplifié et intuitif à l’objet post à l’intérieur de la boucle. Nous en apprendrons plus à ce sujet plus tard.
C’est une bonne pratique d’envelopper la boucle dans une ifvérification qui vérifie s’il y a réellement des publications à parcourir. Ensuite, nous pouvons également éventuellement afficher un message s’il n’y en avait pas. La requête de publication peut être vide si vous accédez à une archive de catégorie vide ou essayez de rechercher quelque chose qui n’a pas de résultats. Ceci est une meilleure version de la boucle :
Familiarisez-vous avec ce morceau de code car vous le répéterez chaque fois que vous voudrez accéder aux publications ! Implémentons la boucle dans notre thème.
Implémentation de la boucle dans notre thème
Ajoutons la boucle dans notre index.php, en remplaçant le texte factice.
J’ai ajouté une fonction appelée the_title()à l’intérieur de la boucle qui fait écho au titre du message. C’est juste pour que nous puissions voir la boucle dans la pratique. Ne vous inquiétez pas, à l’étape suivante, nous apprendrons tout sur l’accès à toutes les informations de publication réelles.
Voyons maintenant ce qui se passe dans WordPress. Rafraîchir la première page. En fonction de vos paramètres et de votre contenu, vous devriez voir apparaître certains titres. Dans mon WordPress, j’ai le post par défaut "Hello world!" et un autre message que j’ai créé intitulé "Ceci est un autre message". Voici ce que j’obtiens sur la page d’accueil :
Si vous essayez de visiter une seule page de publication, vous ne devriez voir qu’un seul titre, le titre de la publication que vous consultez. Agréable!
Pour les curieux…
Si vous êtes curieux de savoir ce que la boucle parcourt et quels paramètres WordPress a utilisé pour cette requête, vous pouvez le vérifier. La variable globale à laquelle la boucle fait référence est appelée $wp_query. Vous devez le définir globalement pour y accéder. Essayez d’utiliser var_dump()pour imprimer son contenu complet. La boucle parcourt la $wp_query->postspropriété.
global $wp_query;
var_dump($wp_query);Ajoutons un détail important à notre boucle dans index.php; un moyen pour l’utilisateur de naviguer vers la page suivante et précédente des publications.
Gardez à l’esprit que la boucle récupèrera le nombre de publications défini dans vos paramètres WordPress> Lecture, chaque fois que vous vous trouvez sur une page qui affiche plusieurs publications. S’il y a plus de messages disponibles dans la boucle que le nombre défini ici, nous avons besoin d’un moyen de naviguer entre les pages. Pour cela, nous pouvons utiliser la fonction the_posts_pagination().
Cette fonction accepte certains paramètres pour personnaliser sa sortie. Vous pouvez définir le nombre de pages entre les points de suspension (lorsqu’il y a beaucoup de pages). Vous pouvez également définir ce que doivent être les textes des liens des pages "Précédent" et "Suivant". Je vais l’ajouter sans aucun paramètre afin de faire les valeurs par défaut, mais vous pouvez l’ajuster si vous le souhaitez.
...
while (have_posts()): the_post();
the_title();
endwhile;
the_posts_pagination();
} else {
...Cette fonction ne produit absolument rien s’il y a moins ou autant de publications que le nombre de publications par paramètre de page. Donc ne vous inquiétez pas si vous pensez que vous vous êtes trompé parce que vous ne voyez aucune sortie. Une fois qu’il y a plus de messages que de messages par page, cette fonction génère un div, un titre pour les lecteurs d’écran (que vous masquez généralement avec CSS) et un certain nombre de liens de pagination.
Maintenant que nous savons comment accéder à n’importe quel article que WordPress a trouvé pour nous, l’étape suivante consiste à apprendre à montrer ce que nous voulons de chaque article ; à l’intérieur de la boucle.