Acțiunea add_action pentru articole complet noi în WordPress

Am citit în detaliu nucleul WordPress și am încercat tot. wp_transition_post_status(), new_to_publish(), new_{post_type}(), wp_insert_post().

Toate acestea sunt, în final, nesigure.

wp_transition_post_status() nu este sigură deoarece noul status "publish" este statusul implicit atât pentru crearea de postări noi, cât și pentru actualizarea celor existente. Statusul vechi nu este sigur pentru a defini ce este o postare nouă și ce nu, deoarece poate fi draft, auto-draft, publish, etc.

new_to_publish() nu funcționează pentru tipuri de postări personalizate.

new_{post_type} trece doar $post ca parametru și nu poți ști dacă este nou sau actualizează unul existent

wp_insert_post() are un parametru $update care ar trebui să fie TRUE dacă actualizează postări existente și FALSE dacă creează postări noi, dar este nesigur deoarece returnează TRUE pentru postări noi din cauza auto-draft.

Soluție: Utilizarea unei meta pentru postări

Am ajuns să folosesc o meta personalizată pentru postări pe care am numit-o check_if_run_once care va executa o anumită logică doar o singură dată:

/**
*   Faceți ceva când este creată o nouă carte
*/
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')) ) {
        # Postare nouă

        # Faceți ceva aici...

        # Și actualizați meta astfel încât să nu mai ruleze din nou
        update_post_meta( $post_id, 'check_if_run_once', true );
    }
}
add_action( 'wp_insert_post', 'new_book', 10, 3 );

Opțional, dacă trebuie să vă actualizați postările existente cu meta-ul "check_if_run_once", astfel încât să nu ruleze codul de mai sus pentru postările existente create înainte de a adăuga acea funcție, puteți face:

/**
*   Aceasta este o funcție temporară pentru actualizarea postărilor existente cu meta-ul "check_if_run_once"
*   Accesați site-ul dvs. conectat ca administrator și adăugați ?debug la URL.
*/
function temporary_function() {
    if (current_user_can('manage_options')) {
        $posts = get_posts(array(
            'post_type' => 'book',
            'posts_per_page' => -1, // S-ar putea să fie nevoie să paginați acest lucru în funcție de câte postări aveți
            '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');
}

Direcționarea precisă a creării unui articol nou este de fapt mai complicată decât pare. Din punct de vedere tehnic, există multiple modalități prin care un articol poate fi creat sau actualizat și există multe aspecte care nu sunt atât de evidente, dar care sunt din punct de vedere tehnic tot articole (de exemplu, reviziile).

WordPress oferă cârlige dinamice care urmăresc nu doar crearea articolului, ci și ce a fost și ce a devenit. Consultă Tranzițiile stării articolului în Codex.

Mai mult prin experimentare decât urmărind documentația, această soluție funcționează pentru mine (WP 3.3). Primesc un apel al hook-ului transition_post_status cu $new_status setat la "auto-draft" când creezi un articol nou.

function my_post_new($new_status, $old_status=null, $post=null){
    if ($new_status == "auto-draft"){
        // faci operațiuni aici
    }
}
add_action('transition_post_status', 'my_post_new');

Am descoperit că cea mai bună opțiune este să verific starea postului atunci când este apelat wp_insert_post.

Când un post nou este creat, starea inițială este auto-draft.

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

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

Acest error_log se va executa doar o singură dată.

Cea mai curată și sigură metodă de a gestiona acest lucru pentru un tip de postare cunoscut este să folosești hook-ul {$new_status}_{$post->post_type} care oferă vechiul status și îl compară cu "publish".

De exemplu, dacă dorești să declanșezi o acțiune atunci când o nouă "pagină" este creată, ai folosi:

add_action( 'publish_page', function( int $post_id, \WP_Post $post, string $old_status ) {
    if ( 'publish' === $old_status ) {
        // Nimic de văzut aici.
        return;
    }
    // Logica de afaceri se pune aici.
}, 10, 3 );