get_the_ID()

Définition : get_the_ID() retourne l’identifiant numérique de la publication courante dans la boucle WordPress. Cet identifiant sert à relier un article, une page ou un contenu personnalisé à ses données.

Comprendre et utiliser

À quoi sert ce terme ?

Un identifiant stable à l’intérieur d’un site simplifie les opérations de recherche et de liaison. On peut l’utiliser pour récupérer les métadonnées d’un objet ou construire un attribut de données pour un composant éditorial.

Fonctionnement technique

La fonction exploite le contexte de publication courant : elle peut retourner false lorsque ce contexte n’est pas établi. Elle ne reçoit pas de paramètre d’identifiant et ne recherche pas un contenu par son titre.

Dans quels contextes l’utiliser ?

Dans un template parcourant des publications, elle convient pour attribuer un repère à chaque carte. Hors de la boucle, mieux vaut utiliser explicitement l’ID d’un objet WP_Post déjà connu.

Cas concret : ATOOLPHA

ATOOLPHA veut indiquer la référence technique de chaque fiche d’actualité dans un conteneur HTML, sans afficher de valeur si aucune publication n’est disponible.

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
// Dans The Loop d'un modèle de thème.
$id = get_the_ID();
if ( $id ) {
    echo '<article data-post-id="' . esc_attr( (string) $id ) . '">';
    echo esc_html( get_the_title( $id ) );
    echo '</article>';
}

Décryptage de l’exemple

Le test empêche l’utilisation d’un identifiant absent. L’attribut data-post-id n’est pas une autorisation d’accès ; il expose seulement une référence publique dont la présence doit être adaptée au besoin.

Résultat attendu

Une carte affichée porte son ID de publication dans le DOM, ce qui facilite des interactions JavaScript non sensibles.

Exercice pratique et vérification

Afficher trois articles en boucle et noter leurs valeurs data-post-id. Ajouter une requête secondaire, puis contrôler le contexte avant et après wp_reset_postdata().

Précautions et limites

Ne jamais considérer l’identifiant comme un secret ou comme une preuve de permission. Toute action sur un contenu doit vérifier les capacités utilisateur côté serveur.

À ne pas confondre

get_the_ID() lit l’article courant ; get_queried_object_id() décrit l’objet de la requête principale, qui peut être une page ou une taxonomie.

Diagnostic avancé

Si tous les éléments reçoivent le même ID, vérifier que la boucle avance et qu’une boucle secondaire n’a pas laissé des données globales non restaurées.

Choix d’architecture et déploiement

Quand une extension conserve des relations entre objets, enregistrer un identifiant est plus robuste qu’enregistrer un titre susceptible de changer. En revanche, ne jamais transférer ce choix vers un contrôle d’accès : les autorisations doivent être évaluées pour l’utilisateur et le contenu réels.