Thème pour Wordpress : La page d'article

Le code d'une page d'article est la combinaison du code d'une page HTML et de plusieurs composants fournis nativement par le logiciel Wordpress.

Structure de la page

Nous allons la détailler en deux parties. En premier lieu, la structure globale de la page d'un article, que l'on mettra dans le fichier single.php.

Page globale

<html>
<head></head>
<body>

<?php get_header(); ?>

<?php the_post() ?>
<div class="singlepost">
         <h1 class="postitle"><?php the_title(); ?></h1>
         <div class="content">
                <?php the_content(); ?>
          </div>
</div>

<?php get_sidebar() ?>

<?php get_footer(); ?>

</body>
</html>

L'appel de la fonction the_post() récupère le contenu du dernier billet, mais c'est the_content() qui affiche le texte et the_tile() le titre, qui figurent dans des champs différents de la base de donnée.

Dans la même page on insére aussi les autres fichiers qui correspondent à l'en-tête, le pied-de-page, les panneaux latéraux.

Dans la pratique, les codes de page tels que <html>, <head>, <body>, sont placés plutôt dans le fichier header.php de façon à les réutiliser dans la page d'accueil (sauf si on veut qu'ils soient différents). Donc get_header() suffit à les intégrer.
De même </body> et </html> sont placés dans le fichier footer.php.

Détail du corps de l'article

Maintenant, on voit les différents composants fournissant des informations sur l'article jugées utiles aux lecteurs.

<?php the_post() ?>
<h1 class="postitle"><?php the_title(); ?></h1>
<?php
  the_category(', ') ;
  the_content();
  edit_post_link();
  wp_link_pages(); 
  if (comments_open())  comments_template();
?>

L'ordre des éléments est à la discrétion de l'auteur du thème, et quand à la présentation, elle dépend entièrement de la feuille de style.
Les composants sont le bouton d'édition: edit_post_link(), les liens sur les pages suivante et précédente: link_pages(), et le bloc de commentaires.
En fait il faut aussi attribuer des classes à chaque élément pour modifier son apparence avec la feuille de style:

<?php the_post() ?>
<h1 class="postitle"><?php the_title(); ?></h1>
<div class="cat"> <?php  the_category(', ') ; ?></div>
<div class="content"><?php  the_content();  ?></div>
<div class="edit"><?php  edit_post_link(); ?> </div>
<div class="links"><?php  wp_link_pages(); ?> </div>
<div class="comments">
  if (comments_open())  comments_template();
</div>
?>

Notre page d'article est prête à être mise en ligne, reste à définir aussi une page statique (qui peut être similaire à celle-ci, et la page d'accueil qui affiche plusieurs billets ou les résumés des derniers articles.

Autres composants

Il est possible d'afficher après l'article la liste des derniers articles plutôt que sur le panneau.

wp_get_archives('type=postbypost&limit=10'); 

Cette liste est inutile sur la page d'accueil, donc la page d'un article est le meilleur endroit pour l'afficher.

Documentation utile

La page peut utiliser les composants d'articles et des widgets d'accès à la base.