La boucle Wordpress

Par CRM le 19/3/2024 à 06:30

Cet article détaille le fonctionnement de la boucle Wordpress.

La boucle WordPress, également appelée “The Loop” en anglais, est un élément central du système de gestion de contenu WordPress. C’est un mécanisme permettant d’afficher dynamiquement du contenu, comme des articles, des pages ou des produits, en fonction de critères spécifiques.

La boucle Wordpress : Documentation officielle

Fonctionnement

La boucle WordPress fonctionne en parcourant des articles ou des pages, et en exécutant un code spécifique pour chaque élément de la séquence. Ce code peut inclure l’affichage du titre, du contenu, de l’auteur, de la date de publication, etc…

Structure de la boucle:

La boucle WordPress est généralement délimitée par deux balises spécifiques :

<?php if ( have_posts() ) : ?>: Cette balise ouvre une condition et vérifie s’il y a des articles à afficher.

<?php endif; ?>: Cette balise ferme la condition.

A l’intérieur de la condition:

<?php while ( have_posts() ) : ?>: Cette balise ouvre la boucle et le code à l’intérieur est répété tant qu’il y a du contenu à afficher.

<?php endwhile; ?>: Cette balise ferme la boucle.

A l’intérieur de la boucle:

Entre ces deux balises, on peut utiliser divers éléments pour contrôler le comportement de la boucle et l’affichage du contenu :

<?php the_post(); ?>: Cette balise prépare l’article ou la page en cours pour l’affichage. <?php the_title(); ?>: Affiche le titre de l’article ou de la page en cours. <?php the_content(); ?>: Affiche le contenu de l’article ou de la page en cours. <?php the_author(); ?>: Affiche l’auteur de l’article ou de la page en cours. <?php the_date(); ?>: Affiche la date de publication de l’article ou de la page en cours.

Exemple simple:

<?php
if ( have_posts() ) : 
  while ( have_posts() ) : 
    the_post(); 
?>
  <h2><?php the_title(); ?></h2>
  <p><?php the_content(); ?></p>
<?php 
  endwhile; 
else: 
?>
  <p>Aucun article à afficher.</p>
<?php 
endif; 
?>

Cet exemple affiche la liste des articles disponibles, avec le titre et le contenu de chaque article.

Voici un 2nd exemple avec une structure HTML plus complète :

<?php
if ( have_posts() ) : 
  while ( have_posts() ) : 
    the_post(); 
?>
<article>
  <header>
    <h2><?php the_title(); ?></h2>
    <aside><?php the_author_link(); ?>, le <?=get_the_date() ?> à <?php the_time() ?></aside>
    <aside>Catégories: <?php the_category(','); ?></aside>
  </header>
  <div>
    <?php the_content(); ?>
  </div>
  <footer>
    <a href="<?php the_permalink(); ?>">Lire la suite</a>
  </footer>
</article>
<?php 
  endwhile; 
else: 
?>
  <p>Aucun article à afficher.</p>
<?php 
endif; 
?>

Points importants

La boucle WordPress est un outil puissant pour afficher dynamiquement du contenu sur un site WordPress. La structure de la boucle est simple et flexible, permettant une grande variété d’utilisations. De nombreux éléments et fonctions permettent de contrôler le comportement de la boucle et l’affichage du contenu.

Ressources supplémentaires