Le fichier single.php

Dans la logique des thèmes WordPress, vous serez vous amené à visiter le code source de votre fichier single.php. Mais qui est-il ? Que fait-il ? A quoi sert-il ? Découverte de ce fichier single.php

Répondons immédiatement à la question « A quoi sert ce single.php ? » Il affiche vos articles sur votre site. Rien de moins que cela. Ce qui le rend quelque peu important. Si vous faites n’importe quoi, n’importe comment dans le code de ce fichier, ce sont l’intégralité de vos articles qui vont partir en sucette. Sensible n’est-ce pas ?

Un base de données et un fichier php on cela de merveilleux. Avec un seul fichier, vous allez pouvoir afficher des milliers d’articles. Le revers de la médaille, comme indiqué précédemment,c’est qu’une seule coquille dans ce fichier, et c’est tout votre contenu qui est vrillé.

En soit, le fichier single n’est pas un monstre de complication. Il serait même assez « rudimentaire » dans sa version de base. En effet, pour afficher votre article, il suffit « simplement » de faire un appel à la boucle WordPress, et le tour est joué.

La boucle va récupérer ce qu’elle doit, là où elle le doit et renvoyer l’article qui va bien à votre visiteur.

Là où cela devient un tantinet plus compliqué pour le novice, c’est la mise en forme de la page. Comme toujours, si le CSS et l’HTML sont pour vous aussi clair que du chinois, autant vous dire que vous allez passer un mauvais moment. D’un autre côté, ce n’est pas en prenant la fuite que vous allez apprendre…
Les marqueurs utiles

Pour votre single.php, vous allez devoir faire appel à certains marqueurs WordPress, regardons les quels

the_title : affiche le titre de l’article
the_excerpt : affiche l’extrait de l’article
the_content : l’article lui même

Vous devrez également utiliser deux fonctions obligatoires, qui vont ouvrir et fermer votre fichier.

get_header : appel le header de wordpress et ses fonctions liées
get_footer : idem que précédemment, mais pour le pied de page

En résumé, j’ouvre mon fichier avec la fonction get_header, puis, je place mes marqueurs, enfin, je ferme mon fichier avec get_footer.

En suivant cela, votre page affichera l’en-tête du site, le titre de l’article, son extrait, l’article, et enfin le pied de page.

Il vous « restera » à vous occuper de la mise en page.

Un exemple de fichier single commenté:

single