do_action( 'post_updated', int $post_ID, WP_Post $post_after, WP_Post $post_before )

Fires once an existing post has been updated.

Contents

Parameters Parameters

$post_ID

(int) Post ID.

$post_after

(WP_Post) Post object following the update.

$post_before

(WP_Post) Post object before the update.

Top ↑

More Information More Information

Use this hook whenever you need to compare values before and after the post update.

This hook runs after the database update.

This hook pass up to 3 arguments, as follows:

  • $post_ID;
  • $post_after (post object after the update);
  • $post_before (post object before the update);

Top ↑

Source Source

File: wp-includes/post.php

View on Trac

Top ↑

Top ↑

Changelog Changelog

Changelog
Version Description
3.0.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
    Contributed by stevenlinx —

    Example migrated from Codex:

    Suppose we have a post named Original Title and we edit it to Edited Title. Let’s hook to post_updated to check what has changed:

    Let’s hook to post_updated to check what has changed:

    <?php
function check_values($post_ID, $post_after, $post_before){
    echo '<b>Post ID:</b><br />';
    var_dump($post_ID);

    echo '<b>Post Object AFTER update:</b><br />';
    var_dump($post_after);

    echo '<b>Post Object BEFORE update:</b><br />';
    var_dump($post_before);
}

add_action( 'post_updated', 'check_values', 10, 3 ); //don't forget the last argument to allow all three arguments of the function
?>

    Expand full source codeCollapse full source code

    The Result then would be this:

    Post ID:
    int 1403
    Post Object AFTER update:
    object(WP_Post)[7722]
    public 'ID' => int 1403
    public 'post_author' => string '1' (length=1)
    public 'post_date' => string '2014-08-10 18:19:43' (length=19)
    public 'post_date_gmt' => string '2014-08-10 18:19:43' (length=19)
    public 'post_content' => string (length=0)
    public 'post_title' => string 'Edited Title' (length=12)
    public 'post_excerpt' => string (length=0)
    public 'post_status' => string 'publish' (length=7)
    public 'comment_status' => string 'closed' (length=6)
    public 'ping_status' => string 'closed' (length=6)
    public 'post_password' => string (length=0)
    public 'post_name' => string 'edited-title' (length=12)
    public 'to_ping' => string (length=0)
    public 'pinged' => string (length=0)
    public 'post_modified' => string '2014-08-10 19:41:46' (length=19)
    public 'post_modified_gmt' => string '2014-08-10 19:41:46' (length=19)
    public 'post_content_filtered' => string (length=0)
    public 'post_parent' => int 0
    public 'guid' => string 'http://localhost:8888/mysite/?post_type=test_post&p=1403' (length=67)
    public 'menu_order' => int 0
    public 'post_type' => string 'procedimentos' (length=13)
    public 'post_mime_type' => string (length=0)
    public 'comment_count' => string '0' (length=1)
    public 'filter' => string 'raw' (length=3)
    Post Object BEFORE update:
    object(WP_Post)[7724]
    public 'ID' => int 1403
    public 'post_author' => string '1' (length=1)
    public 'post_date' => string '2014-08-10 18:19:43' (length=19)
    public 'post_date_gmt' => string '2014-08-10 18:19:43' (length=19)
    public 'post_content' => string (length=0)
    public 'post_title' => string 'Original Title' (length=14)
    public 'post_excerpt' => string (length=0)
    public 'post_status' => string 'publish' (length=7)
    public 'comment_status' => string 'closed' (length=6)
    public 'ping_status' => string 'closed' (length=6)
    public 'post_password' => string (length=0)
    public 'post_name' => string 'original-title' (length=14)
    public 'to_ping' => string (length=0)
    public 'pinged' => string (length=0)
    public 'post_modified' => string '2014-08-10 19:41:14' (length=19)
    public 'post_modified_gmt' => string '2014-08-10 19:41:14' (length=19)
    public 'post_content_filtered' => string (length=0)
    public 'post_parent' => int 0
    public 'guid' => string 'http://localhost:8888/mysite/?post_type=test_post&p=1403' (length=67)
    public 'menu_order' => int 0
    public 'post_type' => string 'procedimentos' (length=13)
    public 'post_mime_type' => string (length=0)
    public 'comment_count' => string '0' (length=1)
    public 'filter' => string 'raw' (length=3)

You must log in before being able to contribute a note or feedback.