wp_new_comment_notify_postauthor( int $comment_id )
Sends a notification of a new comment to the post author.
Parameters
- $comment_id
-
(Required) Comment ID.
Return
(bool) True on success, false on failure.
Source
File: wp-includes/comment.php
function wp_new_comment_notify_postauthor( $comment_ID ) {
$comment = get_comment( $comment_ID );
$maybe_notify = get_option( 'comments_notify' );
/**
* Filters whether to send the post author new comment notification emails,
* overriding the site setting.
*
* @since WP-4.4.0
*
* @param bool $maybe_notify Whether to notify the post author about the new comment.
* @param int $comment_ID The ID of the comment for the notification.
*/
$maybe_notify = apply_filters( 'notify_post_author', $maybe_notify, $comment_ID );
/*
* wp_notify_postauthor() checks if notifying the author of their own comment.
* By default, it won't, but filters can override this.
*/
if ( ! $maybe_notify ) {
return false;
}
// Only send notifications for approved comments.
if ( ! isset( $comment->comment_approved ) || '1' != $comment->comment_approved ) {
return false;
}
return wp_notify_postauthor( $comment_ID );
}
Changelog
Version | Description |
---|---|
4.4.0 | Introduced. Uses the 'notify_post_author' filter to determine whether the post author should be notified when a new comment is added, overriding site setting. |