wp_is_post_autosave()

Définition : wp_is_post_autosave() indique si un identifiant ou objet WordPress correspond à une sauvegarde automatique de publication. Lorsqu’elle en détecte une, elle renvoie l’identifiant du contenu parent concerné.

Terminologie

Terme officiel : wp_is_post_autosave()

Autres appellations : Détection de sauvegarde automatique

À quoi cela sert

Elle permet de distinguer les sauvegardes automatiques du travail éditorial normal et d’éviter certains traitements coûteux ou inappropriés pendant ces étapes intermédiaires.

Comment cela fonctionne

La fonction recherche une révision possédant les caractéristiques d’une sauvegarde automatique. Elle renvoie l’ID parent dans ce cas, sinon false ; elle n’empêche pas WordPress d’effectuer sa sauvegarde native.

Dans quel contexte l’utiliser

À utiliser dans des callbacks de traitement de métadonnées ou de suivi qui doivent ignorer les versions automatiquement enregistrées.

Exemple concret

Une extension de documentation souhaite éviter d’envoyer une notification à chaque sauvegarde automatique de l’éditeur.

Exemple de code commenté

Extrait pédagogique PHP pour extension WordPress : adapter au contexte et tester sur un environnement de développement avant tout usage.

<?php
add_action( 'save_post', function ( $post_id ) {
    if ( wp_is_post_autosave( $post_id ) ) {
        return; // Ne pas notifier sur cette sauvegarde.
    }
    if ( wp_is_post_revision( $post_id ) ) {
        return;
    }
    // Les autres conditions de publication restent à contrôler.
} );

Explication pas à pas de l’exemple

1. Le callback reçoit un ID de publication. 2. Les sauvegardes automatiques sont exclues. 3. Les autres révisions sont également exclues. 4. La logique de notification éventuelle demeure séparée.

Résultat attendu

L’exemple ne déclenche aucune notification pendant une sauvegarde automatique ; il n’envoie d’ailleurs aucun message, car il s’agit d’un extrait de filtrage pédagogique.

Mise en pratique guidée

Ouvrir un article de test dans l’éditeur, laisser une autosave se produire, puis examiner les objets concernés dans une routine de journalisation non intrusive. Vérifier que le callback de démonstration ignore les autosaves. Comparer avec une révision manuelle : les deux fonctions de détection ne doivent pas être considérées comme identiques.

Précautions et limites

Ne pas confondre la constante DOING_AUTOSAVE avec tous les cas de révision : le contexte exact de sauvegarde peut varier. Évaluer aussi le statut de contenu et les permissions.