Hook add_action per post completamente nuovi?

Ho letto approfonditamente il core di WordPress e ho provato tutto. wp_transition_post_status(), new_to_publish(), new_{post_type}(), wp_insert_post().

Tutti questi, alla fine, sono inaffidabili.

wp_transition_post_status() non è affidabile perché il nuovo stato "publish" è lo stato predefinito sia per la creazione di nuovi post che per l'aggiornamento di quelli esistenti. Lo stato precedente non è affidabile per definire cosa è un nuovo post e cosa non lo è perché può essere draft, auto-draft, publish, ecc.

new_to_publish() non funziona per i custom post type.

new_{post_type} passa solo $post come parametro, e non puoi sapere se è nuovo o un aggiornamento di uno esistente

wp_insert_post() ha un parametro $update che dovrebbe essere TRUE se si stanno aggiornando post esistenti e FALSE se si stanno creando nuovi post, ma è inaffidabile perché restituisce TRUE per i nuovi post a causa di auto-draft.

Soluzione: Utilizzo di un post meta

Alla fine ho utilizzato un post meta personalizzato che ho chiamato check_if_run_once che eseguirà una certa logica solo una volta:

/**
*   Fai qualcosa quando viene creato un nuovo libro
*/
function new_book($post_id, $post, $update) {
    if ( $post->post_type == 'book' && $post->post_status == 'publish' && empty(get_post_meta($post_id, 'check_if_run_once')) ) {
        # Nuovo Post

        # Fai qualcosa qui...

        # E aggiorna il meta così non verrà eseguito di nuovo
        update_post_meta( $post_id, 'check_if_run_once', true );
    }
}
add_action( 'wp_insert_post', 'new_book', 10, 3 );

Opzionalmente, se hai bisogno di aggiornare i tuoi post esistenti con il meta "check_if_run_once", in modo che non esegua il codice sopra per i post esistenti creati prima di aver aggiunto quella funzione, potresti fare:

/**
*   Questa è una funzione temporanea per aggiornare i post esistenti con il post meta "check_if_run_once"
*   Accedi al tuo sito loggato come admin e aggiungi ?debug all'URL.
*/
function temporary_function() {
    if (current_user_can('manage_options')) {
        $posts = get_posts(array(
            'post_type' => 'book',
            'posts_per_page' => -1, // Potresti dover paginare questo in base a quanti post hai
            'fields' => 'ids'
        ));
        foreach($posts as $post_id) {
            update_post_meta($post_id, 'check_if_run_once', true);
        }
    }
}
if (isset($_GET['debug'])) {
    add_action('init', 'temporary_function');
}

Precisamente individuare la creazione di un nuovo articolo è in realtà più complicato di quanto sembri. Tecnicamente ci sono diversi modi in cui un articolo può essere creato o aggiornato e ci sono molte cose non così ovvie che tecnicamente sono anche articoli (le revisioni, ad esempio).

WordPress fornisce hook dinamici che tracciano non solo la creazione dell'articolo, ma anche cosa era e cosa è diventato. Vedi Transizioni di Stato degli Articoli nel Codex.

Più che seguire la documentazione, ho sperimentato e questo funziona per me (WP 3.3). Ricevo una chiamata all'hook transition_post_status con $new_status impostato su "auto-draft" quando creo un nuovo articolo.

function my_post_new($new_status, $old_status=null, $post=null){
    if ($new_status == "auto-draft"){
        // fai qualcosa qui
    }
}
add_action('transition_post_status', 'my_post_new');

Ho scoperto che l'opzione migliore è verificare lo stato del post quando viene chiamato wp_insert_post.

Quando un nuovo post viene creato, lo stato iniziale è auto-draft.

if (!function_exists('benyonsFunction')) {
    function benyonsFunction($postId, $post) {
        if ($post->post_status == "auto-draft") {
            error_log('NUOVO POST!!!');
        }
    }
}

add_action('wp_insert_post', 'benyonsFunction', 10, 2);

Questo error_log verrà attivato solo una volta.

Il modo più pulito e affidabile per gestire questo per un tipo di post conosciuto è utilizzare l'hook {$new_status}_{$post->post_type} che fornisce lo stato precedente e confrontarlo con "publish".

Ad esempio, se vuoi attivare un'azione quando una nuova "pagina" viene creata, useresti:

add_action( 'publish_page', function( int $post_id, \WP_Post $post, string $old_status ) {
    if ( 'publish' === $old_status ) {
        // Niente da fare qui.
        return;
    }
    // La logica di business va qui.
}, 10, 3 );