Dans ce tutoriel, je vais aborder La Boucle, et comment WordPress l'utilise pour afficher vos articles et pages. Gardez à l'esprit que c'est légèrement plus avancé que nos tutoriels précédents. J'espère que vous trouverez ce guide ultime plus facile à comprendre que ce qui est disponible dans la documentation WordPress. Voici ce que nous allons aborder :
- Une définition de La Boucle.
- Flux de base de La Boucle.
- Balises de modèle utilisées dans La Boucle
- Que faire après La Boucle
- Hiérarchie des fichiers de modèle
Si vous voulez mieux comprendre comment un thème WordPress fonctionne réellement en coulisses, continuez à lire.
Remarque : Ce tutoriel suppose que vous utilisez un thème WordPress standard, tel que le thème par défaut Kubrick. Pas de contenu multiple avancé... pour l'instant.
Qu'est-ce que La Boucle ?
Vous vous demandez probablement encore ce qu'est La Boucle. En gros, c'est ce qui affiche le contenu que vous voyez sur votre page d'accueil, vos articles uniques, vos pages, les archives, les résultats de recherche, et plus encore.
Si un utilisateur accède à votre page d'accueil, à vos archives ou à vos résultats de recherche – par défaut, la Boucle affichera un certain nombre d'articles tel que défini dans vos Options de lecture.
Pour le moment, ma page d'accueil affiche 10 articles par page, ce qui correspond à ce que j'ai défini dans Afficher au maximum * articles. Sur les articles et pages individuels – le même code de Boucle de base affichera simplement uniquement cette page spécifique.
Flux de base de la boucle
Décomposons La Boucle en 3 parties.
1. Ce que vous voulez afficher dans La Boucle
<?php endwhile;?>
2. Ce qui est affiché lorsque La Boucle est terminée
<?php else : ?>
3. S'il n'y a rien à afficher
Si des articles sont disponibles dans la requête, elle commencera à les afficher dans une boucle while, ce qui est défini dans la partie 1. Lorsque la boucle while est terminée, elle affichera ce qui se trouve dans la partie 2. S'il n'y a pas d'articles trouvés, ou s'il y a une autre erreur 404, la partie 3 est affichée.
Balises de modèle utilisées dans la boucle
À moins que vous ne vouliez que 1. Ce que vous voulez afficher dans la boucle soit répété 10 fois sur la page d'accueil de votre blog WordPress, vous devriez probablement apprendre quelques-unes des balises de modèle de base. Examinons le code de index.php dans le modèle WordPress par défaut.
Comme vous pouvez le voir, il y a pas mal de balises de modèle dans la Boucle qui afficheront des choses comme le titre de l'article, le permalien, le contenu, etc. Je vais détailler chacune des balises de modèle dans le thème par défaut de WordPress.
- <?php the_permalink() ?> – Ceci affichera le permalien de l'article, c'est-à-dire http://www.themelab.com/?p=1
- <?php the_title(); ?> – Ceci affiche le titre de l'article, c'est-à-dire Bonjour le monde !
- <?php the_time(‘F jS, Y’) ?> – Ceci affichera la date, c'est-à-dire le 4 avril 2008. Une liste complète des façons de formater la date se trouve sur php.net
- <?php the_author() ?> – Ceci affichera le nom de l'auteur, c'est-à-dire Leland. Ceci est commenté dans le thème par défaut.
- <?php the_tags(‘Tags: ‘, ‘, ‘, ‘<br />’); ?> – Ceci affichera les étiquettes attribuées à l'article, séparées par des virgules, suivies d'un saut de ligne.
- <?php the_category(‘, ‘) ?> – Ceci affichera les catégories de manière similaire aux étiquettes ci-dessus.
- <?php edit_post_link(‘Edit’, ”, ‘ | ‘); ?> – Le lien d'édition de l'article ne sera visible que par ceux qui en ont la permission.
- <?php comments_popup_link(‘No Comments »’, ‘1 Comment »’, ‘% Comments »’); ?> – Affichera le lien vers les commentaires. Ceci ne sera pas affiché sur les articles ou pages uniques.
Il y en a beaucoup d'autres listées sur la page Balises de modèle sur WordPress.org. Certaines d'entre elles peuvent fonctionner dans la Boucle, d'autres non.
Après la boucle
Jetons un coup d'œil au code après l'arrêt de la boucle dans le thème par défaut.
Comme vous l'avez peut-être deviné, cela affichera la pagination que vous voyez sur la page d'accueil, les archives et les résultats de recherche. Celles-ci ne seront pas affichées sur les articles et pages individuels. Bien sûr, vous pourriez remplacer cela par quelque chose comme PageNavi, mais c'est à vous de décider.
S'il n'y a pas d'articles à afficher (peut-être en raison d'une erreur 404), ce qui suit sera affiché après le else
Désolé, mais vous cherchez quelque chose qui n'est pas ici.Page introuvable
Cela affichera le message Non trouvé ainsi que le formulaire de recherche. Dans ce cas, il devrait y avoir un code de formulaire de recherche situé dans un fichier appelé searchform.php dans le répertoire du modèle, ce qui est le cas dans le thème par défaut.
Hiérarchie des modèles
Certains fichiers de modèle auront la priorité sur index.php pour certains types de pages s'ils sont présents dans le répertoire du modèle. Vous trouverez ci-dessous quelques exemples de hiérarchie de modèles, classés par ordre de priorité.
Page d'accueil
- home.php
- index.php
Article unique
- single.php
- index.php
Résultats de recherche
- search.php
- index.php
Page 404
- 404.php
- index.php
Il y a quelques techniques plus avancées listées sur la page Hiérarchie des modèles sur WordPress.org.
Quel est donc l'intérêt de la hiérarchie des modèles ? Fondamentalement, vous pouvez l'utiliser pour créer de nouvelles mises en page pour différents types de pages WordPress sans trop modifier votre fichier index.php.
Conclusion
Vous avez donc maintenant (espérons-le) une meilleure compréhension de ce qu'est la Boucle WordPress. N'hésitez pas à laisser un commentaire si vous l'avez aimé, détesté, n'avez pas compris, peu importe – j'accueille tous les commentaires. Abonnez-vous à la newsletter pour toutes les dernières mises à jour sur les sorties de thèmes Theme Lab et les nouveaux tutoriels. Merci de votre lecture.
[…] abonnez-vous à notre flux ! Vous pouvez également recevoir les mises à jour de ce blog par e-mail. Nous savons tous ce qu'est la boucle WordPress, n'est-ce pas ? Sinon, il existe de nombreux excellents tutoriels sur le web qui expliquent la boucle WordPress […]
Guide vraiment utile, je vais essayer tout de suite.
@Fernando : Merci de me l'avoir fait savoir…
C'est un très bon guide et je l'ai traduit en espagnol ici afin de le partager avec des personnes ne parlant pas anglais 🙂
Merci 😉
[…] Le guide ultime de la boucle Wordpress : La boucle s'avère très difficile. Ce lien vous aidera à la traverser. […]
[…] Un excellent domaine pour commencer est d'apprendre comment fonctionne la boucle WordPress. C'est une fonction de base du blogging utilisée pour afficher le nombre X de publications les plus récentes sur la page d'accueil de votre blog (pour les blogs traditionnels). Plutôt que d'entrer dans trop de détails ici, j'aimerais vous orienter vers un nouvel article de Themelab qui est conçu pour être le guide ultime de la boucle WordPress. […]
[…] deux articles récents que j'ai trouvés utiles sont : Le guide ultime de la boucle WordPress et un autre appelé Variables globales et le WordPress […]
@Filtre RSS : C'est possible… mais je garde ça pour un futur tutoriel.
[…] vous apprendra tout ce que vous devez savoir sur la boucle WordPress. Ce qu'elle est, comment l'utiliser, et plus encore. lire la suite | digg story Partagez et profitez : Ces icônes renvoient vers des sites de bookmarking social où les lecteurs peuvent […]
Alors, comment diriez-vous à la boucle d'afficher uniquement le dernier article sur une page d'accueil statique ou un fichier d'index ?
Excellent guide sur un aspect important du développement de thèmes Wordpress. Merci !
[…] Le guide ultime de la boucle WordPress […]
[…] Le guide ultime de la boucle WordPress (tags: wordpress) […]
[…] propaganda press le 6 avril 2008 ok, un peu comme combolombo, nous venons de découvrir un nouveau site avec un article génial sur la boucle wordpress. vous voulez absolument lire et mettre en favoris celui-ci. Tagué avec : wordpress « African […]
[…] Guide ultime de la boucle WordPress… Obtenez les détails sur tous les globals et ce […]
[…] Le guide ultime de la boucle WordPress | Theme Lab (tags: wordpress howto php guide programming theme blog) […]
[…] Guide de la boucle WordPress […]
[…] Le guide ultime de la boucle Wordpress – Theme Lab […]
[…] Le guide ultime de la boucle WordPress (tags: loop wordpress) […]
Oh, c'est un gardien. J'aurais sérieusement pu utiliser ça en essayant de comprendre quelques ajustements de plugins.
Ils n'arrêtaient pas de dire : « placez ce code en dehors de la boucle »
Et maintenant je sais ce que c'est que cette foutue boucle 🙂
[…] est un guide de la boucle Wordpress. Particulièrement utile pour les créateurs de thèmes Wordpress débutants et les développeurs Wordpress. Partagez et […]
Salut Leland, HS, mais félicitations pour ton augmentation d'abonnés !
– Sean Pollock
guide très utile.. merci !
[…] Le guide ultime de la boucle WordPress – Ce site explique vraiment la boucle pour que vous puissiez la comprendre. […]
[…] Wordpress. Allez-y, abonnez-vous à notre flux ! Vous pouvez également recevoir les mises à jour de ce blog par e-mail. Le guide ultime de la boucle WordPress : Ah, la fameuse boucle WordPress qui fait tout fonctionner. Ronald a fait un très bon travail pour identifier […]