wp_new_comment_notify_postauthor( int $comment_id ): bool

Sends a notification of a new comment to the post author.

Parameters

$comment_idintrequired
Comment ID.

Return

bool True on success, false on failure.

Source

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

Hooks

apply_filters( ‘notify_post_author’, bool $maybe_notify, int $comment_id )

Filters whether to send the post author new comment notification emails, overriding the site setting.

Changelog

VersionDescription
4.4.0Introduced.

User Contributed Notes

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