do_action( “{$new_status}_{$post->post_type}”, int $post_id, WP_Post $post, string $old_status )

User Contributed Notes

1. Skip to note 5 content

   Steven Lin 5 years ago

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

   Example Migrated from Codex:

   The example below will send an email via wp_mail() to the post author when their article is published.

   function post_published_notification( $post_id, $post ) {
       $author = $post->post_author; /* Post author ID. */
       $name = get_the_author_meta( 'display_name', $author );
       $email = get_the_author_meta( 'user_email', $author );
       $title = $post->post_title;
       $permalink = get_permalink( $post_id );
       $edit = get_edit_post_link( $post_id, '' );
       $to[] = sprintf( '%s <%s>', $name, $email );
       $subject = sprintf( 'Published: %s', $title );
       $message = sprintf ('Congratulations, %s! Your article "%s" has been published.' . "\n\n", $name, $title );
       $message .= sprintf( 'View: %s', $permalink );
       $headers[] = '';
       wp_mail( $to, $subject, $message, $headers );
   }
   add_action( 'publish_post', 'post_published_notification', 10, 2 );
2. Skip to note 6 content

   tdatu 9 years ago

   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

   add_action('publish_post', 'send_notification');
   
   function send_notification($id, $post_obj){
   	
   	//Assemble the message
   	$msg = 'Hi, a new post has been published. Here is the content:';
   	$msg .= $post_obj->post_content;
   	
   	//Send the notification
   	wp_mail('recipient@example.com', $post_obj->post_title, $msg);
   }
3. Skip to note 7 content

   Chigozie Orunta 4 years ago

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

   This WP hook helps you receive a slack notification every time a user saves a new post on your site. It uses your Slack webhook, username, and channel. It makes use of the PHP Slack library which can be downloaded via Composer to your themes directory.

   function wpdocs_notify_my_slack( $post_id, $post ) {
   	require_once __DIR__ . '/vendor/autoload.php';
   
   	$slack_hook = 'https://hooks.slack.com/services/xxxxxx';
   	$slack_message = 'New Post alert | %3$s: %2$s - %1$s';
   	$slack_message = sprintf( $slack_message, get_permalink( $post_id ), $post->post_title, $post->post_date );
   	$settings = [
   		'username' => 'Chigozie Orunta',
   		'channel'  => '#blog',
   	];
   	$client = new MaknzSlackClient( $slack_hook, $settings );
   	$client->send( $slack_message );
   }
   add_action( 'publish_post', 'wpdocs_notify_my_slack', 10, 2 );

   • This will fire both when a user saves a new post and on updates. See the “Please note” section above.

     Tunn 3 years ago
4. Skip to note 8 content

   Chigozie Orunta 2 years ago

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

   This example helps you log a published post to a text file in your (child) theme.

   add_action( 'publish_post', 'wpdocs_log_published_post' );
   
   function wpdocs_log_published_post( $post_id ) {
       $log_file = trailingslashit( get_stylesheet_directory() ) . apply_filters( 'wpdocs_published_log_file', 'log.txt' );
   
       if ( ! file_exists( $log_file ) ) {
           return;
       }
   
       $file = fopen( $log_file, 'a' );
   
       if ( false === $file ) {
           return;
       }
   
       $message = sprintf( '%s (%d) was just saved.', get_the_title( $post_id ), $post_id );
       fwrite( $log_file, $message . PHP_EOL );
   }