get_the_title()

Définition : get_the_title() récupère le titre d’une publication WordPress, courante ou désignée par son identifiant. Contrairement à une fonction d’affichage direct, elle retourne une chaîne exploitable dans un template.

Comprendre et utiliser

À quoi sert ce terme ?

Elle permet de choisir le balisage entourant un titre : carte, lien, attribut ou texte alternatif. Le développeur peut ainsi décider du bon échappement et éviter les sorties HTML implicites.

Fonctionnement technique

La fonction accepte un ID ou un objet de publication et applique le filtre the_title. Le titre retourné n’est pas automatiquement préparé pour tous les contextes HTML, notamment les attributs.

Dans quels contextes l’utiliser ?

Employer la fonction pour construire des listes ou des composants. Dans l’attribut title d’un lien, utiliser esc_attr() ; à l’intérieur d’un élément de texte, utiliser esc_html().

Cas concret : ATOOLPHA

Pour une liste des dernières publications ATOOLPHA, créer un lien dont le libellé correspond exactement au titre de l’article plutôt qu’à son identifiant.

Exemple de code commenté

Extrait PHP destiné à un plugin ou à un template WordPress, dans le contexte indiqué ; pas au contenu HTML de l’article.

<?php
$post = get_post( 123 ); // ID fictif sur un site de test.
if ( $post instanceof WP_Post ) {
    $title = get_the_title( $post );
    echo '<h2>' . esc_html( $title ) . '</h2>';
}

Décryptage de l’exemple

get_post() confirme l’existence du contenu. Le titre est ensuite récupéré et échappé au moment de la sortie dans le h2, ce qui empêche le texte du titre d’être interprété comme du HTML.

Résultat attendu

Un titre propre à l’article 123 s’affiche si ce contenu est accessible à ce code ; en cas d’absence, aucun h2 n’est produit.

Exercice pratique et vérification

Créer deux brouillons avec des titres différents, appeler la fonction sur leurs ID respectifs puis contrôler le balisage HTML rendu. Modifier les titres et répéter.

Précautions et limites

Ne pas confondre titre lisible et titre SEO ; des extensions peuvent modifier le titre du document. L’échappement doit tenir compte de la destination finale.

À ne pas confondre

get_the_title() renvoie un titre ; the_title() affiche le titre dans le flux de sortie du modèle.

Diagnostic avancé

Si le titre est vide, examiner le contenu réel, les filtres the_title et la possibilité que l’article soit sans titre plutôt que d’ajouter une valeur arbitraire.

Choix d’architecture et déploiement

Pour des contenus internationaux, comparer la chaîne visible, le titre du document et le titre canonique : les filtres de thème et de SEO peuvent agir à différents niveaux. Définir l’usage exact du titre avant de choisir la fonction et l’échappement de sortie.