do_action( “save_post_{$post->post_type}”, int $post_id, WP_Post $post, bool $update )

User Contributed Notes

1. Skip to note 4 content

   Andrew Dixon 7 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 18You must log in to vote on the helpfulness of this note

   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_post function as well.

   • 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.

     Benjamin Intal 7 years ago
2. Skip to note 5 content

   squarecandy 5 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 10You must log in to vote on the helpfulness of this note

   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
   }
3. Skip to note 6 content

   Nazmul Ahsan 5 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note

   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 );
   }