do_action( "save_post_{$post->post_type}", int $post_ID , WP_Post $post , bool $update )
Fires once a post has been saved.
Description Description
The dynamic portion of the hook name, $post->post_type, refers to the post type slug.
Parameters Parameters
- $post_ID
-
(int) Post ID.
- $post
-
(WP_Post) Post object.
- $update
-
(bool) Whether this is an existing post being updated.
Source Source
File: wp-includes/post.php
Changelog Changelog
| Version | Description |
|---|---|
| 3.7.0 | Introduced. |
User Contributed Notes User Contributed Notes
You must log in before being able to contribute a note or feedback.
The hook also fires when clicking on the “Add New” option for the custom post type, as it creates the draft in the DB, and when calling the
wp_update_postfunction as well.Feedback
You can know whether the hook fired from the “Add New” option by checking the post status:
if ( $post->post_status == "auto-draft" ) { return; }It’s also good to note that this hook is also called when trashing a post or restoring it from trash. — By Benjamin Intal —
Notify your newsletter subscribers when a new book (custom post) is added-
add_action( 'save_post_book', 'wpdocs_notify_subscribers', 10, 3 ); function wpdocs_notify_subscribers( $post_id, $post, $update ) { // If an old book is being updated, exit if ( $update ) { return; } $subscribers = array( 'john@doe.com', 'jane@doe.com', 'someone@else.com' ); // list of your subscribers $subject = 'A new book has beed added!'; $message = sprintf( 'We\'ve added a new book, %s. Click <a href="%s">here</a> to see the book', get_the_title( $post ), get_permalink( $post ) ); wp_mail( $subscribers, $subject, $message ); }Expand full source codeCollapse full source code
It’s kind of sad that this more explicit action fires before the less explicit ‘save_post’ action.
This means if a 3rd party plugin does something using ‘save_post’ you need to use ‘save_post’ to override it too.
// someone else's code... add_action( 'save_post', 'wpdocs_do_something_custom', 15 ); // try to override with CPT action - DOES NOT WORK add_action( 'save_post_third_party_cpt', 'wpdocs_override_something_custom', 20, 2 ); // you must do this to override add_action( 'save_post', 'wpdocs_override_something_custom', 20, 2 ); function override_something_custom( $post_id, $post ) { // bail out if this is an autosave if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) { return; } // bail out if this is not an event item if ( 'third_party_cpt' !== $post->post_type ) { return; } // ... do override stuff }Expand full source codeCollapse full source code