WordPress : astuces pour afficher une page « autonome » avec wp_list_pages()

Tandis que fran6 s’interrogeait sur la création d’une page statique comme page d’accueil d’un blog WordPress, je me demandais comment créer une page prestations.php (teasing inside) affichant certaines catégories de billets dans une maquette spécifique. Je parle d’une page utilisant les boucles WordPress se suffisant donc à elle-même, et pas d’un Modèle de Page à remplir ultérieurement. Tout en sachant que j’ai besoin que cette page soit considérée comme une Page afin d’apparaître avec le marqueur wp_list_pages()

Avant d’arriver à définir ce besoin, j’ai commencé bille en tête par faire la page prestations.php que j’ai tenté d’afficher directement avec…

<?php include (TEMPLATEPATH . '/prestations.php'); ?>

…avant de me rendre compte que si le fichier en question n’était pas parsé par le moteur de WordPress via l’URL, il n’y avait aucune chance pour que les billets en question s’affichent ^_^

Création de la Page autonome

Cette notion fondamentale étant rappelée, comment faire ? J’ai simplement procédé par étapes : dans le panel d’administration de WordPress, j’ai créé une nouvelle page avec Prestations comme titre, j’ai sélectionné ensuite le modèle de page Prestations qui apparait lorsqu’on ajoute le marqueur qui va bien en haut de la page :

<?php /* Template Name: Prestations */ ?>

Et là, comme je n’avais rien à saisir de plus (le contenu étant censé s’afficher avec les boucles WP), je l’ai enregistré sans rien ajouter d’autre (le billet doit rester vide). Je me suis dit que sur un malentendu, ça pouvait marcher 😉

Et ça marche ! La page prestations.php, qui contient deux boucles pour afficher deux catégories de billet l’une en dessous de l’autre, apparaît avec les autres Pages et son contenu s’affiche parfaitement. WordPress a simplement besoin d’un nom de Page dans sa base de données pour la parser lorsqu’elle apparaît dans l’URL.

Rappels pour afficher deux catégories de billets dans deux boucles sur la même page

Pendant que j’y suis, voici quelques lignes présentes dans prestations.php pour afficher les 3 derniers billets de la catégorie « blog-pro », par exemple :

<div class="content primary-content">
    <?php query_posts('category_name=blog-pro&showposts=3'); ?>
        <?php while ( have_posts() ) : the_post() ?>
            [Le reste de la boucle ici]
        <?php endwhile ?>
</div><!-- end .content .primary-content -->

Voici maintenant les 3 derniers billets de la catégorie « prestations » :

<div class="content secondary-content">
    <?php query_posts('category_name=prestations&showposts=3'); ?>
         <?php while ( have_posts() ) : the_post() ?>
            [Le reste de la boucle ici]
        <?php endwhile ?>
</div><!-- end .content .secondary-content -->

Voilà, tout est dans la fonction query_posts() qui permet de faire une requête à la base de donnée en remettant les compteurs à zéro, ce qui permet une souplesse inégalable dans l’élaboration des templates.