Écrire à la main les requêtes SQL et le HTML nécessaires pour afficher un titre d’article serait fastidieux et risqué ; WordPress fournit à la place des fonctions prêtes à l’emploi, pensées pour être appelées directement dans les fichiers de thème.
Fonctionnement dans WordPress
Ces fonctions, comme the_title(), the_content(), the_permalink() ou bloginfo(), s’appuient généralement sur les données de l’article courant, disponibles à l’intérieur de la Boucle. Beaucoup existent en deux versions : celle qui affiche directement (the_title()) et celle qui retourne une chaîne pour un usage programmatique (get_the_title()).
Exemple
<h1><?php the_title(); ?></h1>
<p>Publié le <?php echo get_the_date(); ?></p>Bon à savoir
La plupart des fonctions de gabarit doivent être appelées à l’intérieur de la Boucle ou après the_post() ; utilisées en dehors, sans article courant défini, elles peuvent produire des résultats vides ou incorrects. C’est pour cette raison qu’elles se distinguent des balises conditionnelles, qui s’appuient sur l’état de la requête plutôt que sur l’article en cours.
Nombre d’entre elles acceptent des arguments pour personnaliser leur rendu sans écrire de HTML supplémentaire : the_excerpt() ne prend rien en paramètre, tandis que the_content() accepte un texte de lien « Lire la suite » personnalisé, affiché uniquement quand l’article dépasse la balise .
Un bon réflexe pour identifier une fonction de gabarit consiste à repérer son verbe d’action initial : les fonctions préfixées the_ affichent directement à l’écran, tandis que celles préfixées get_ renvoient une valeur à traiter avant affichage, une convention de nommage cohérente dans l’ensemble du cœur de WordPress.