wp_notify_postauthor() – Notify an author (and/or others) of a comment/trackback/pingback on a post.

You appear to be a bot. Output may be restricted

Description

Notify an author (and/or others) of a comment/trackback/pingback on a post.

Usage

$bool = wp_notify_postauthor( $comment_id, $deprecated );

Parameters

$comment_id
( int|WP_Comment ) required – Comment ID or WP_Comment object.
$deprecated
( string ) optional – Not used

Returns

bool True on completion. False if no email addresses were specified.

Source

File name: wordpress/wp-includes/pluggable.php
Lines:

1 to 100 of 218
  function wp_notify_postauthor( $comment_id, $deprecated = null ) {
    if ( null !== $deprecated ) {
      _deprecated_argument( wp_notify_postauthor, '3.8.0' );
    }

    $comment = get_comment( $comment_id );
    if ( empty( $comment ) || empty( $comment->comment_post_ID ) ) {
      return false;
    }

    $post   = get_post( $comment->comment_post_ID );
    $author = get_userdata( $post->post_author );

    // Who to notify? By default, just the post author, but others can be added.
    $emails = array();
    if ( $author ) {
      $emails[] = $author->user_email;
    }

    
/**
 * Filters the list of email addresses to receive a comment notification.
 *
 * By default, only post authors are notified of comments. This filter allows
 * others to be added.
 *
 * @since 3.7.0
 *
 * @param string[] $emails     An array of email addresses to receive a comment notification.
 * @param string   $comment_id The comment ID as a numeric string.
 */
    $emails = apply_filters( 'comment_notification_recipients', $emails, $comment->comment_ID );
    $emails = array_filter( $emails );

    // If there are no addresses to send the comment to, bail.
    if ( ! count( $emails ) ) {
      return false;
    }

    // Facilitate unsetting below without knowing the keys.
    $emails = array_flip( $emails );

    
/**
 * Filters whether to notify comment authors of their comments on their own posts.
 *
 * By default, comment authors aren't notified of their comments on their own
 * posts. This filter allows you to override that.
 *
 * @since 3.8.0
 *
 * @param bool   $notify     Whether to notify the post author of their own comment.
 *                           Default false.
 * @param string $comment_id The comment ID as a numeric string.
 */
    $notify_author = apply_filters( 'comment_notification_notify_author', false, $comment->comment_ID );

    // The comment was left by the author.
    if ( $author && ! $notify_author && $comment->user_id == $post->post_author ) {
      unset( $emails[ $author->user_email ] );
    }

    // The author moderated a comment on their own post.
    if ( $author && ! $notify_author && get_current_user_id() == $post->post_author ) {
      unset( $emails[ $author->user_email ] );
    }

    // The post author is no longer a member of the blog.
    if ( $author && ! $notify_author && ! user_can( $post->post_author, 'read_post', $post->ID ) ) {
      unset( $emails[ $author->user_email ] );
    }

    // If there's no email to send the comment to, bail, otherwise flip array back around for use below.
    if ( ! count( $emails ) ) {
      return false;
    } else {
      $emails = array_flip( $emails );
    }

    $switched_locale = switch_to_locale( get_locale() );

    $comment_author_domain = '';
    if ( WP_Http::WP_Http::is_ip_address( $comment->comment_author_IP ) ) {
      $comment_author_domain = gethostbyaddr( $comment->comment_author_IP );
    }

    // The blogname option is escaped with esc_html() on the way into the database in sanitize_option().
    // We want to reverse this for the plain text arena of emails.
    $blogname        = wp_specialchars_decode( get_option( 'blogname' ), ENT_QUOTES );
    $comment_content = wp_specialchars_decode( $comment->comment_content );

    switch ( $comment->comment_type ) {
      case 'trackback':
        /* translators: %s: Post title. */
        $notify_message = sprintf( __( 'New trackback on your post "%s"' ), $post->post_title ) . "\r\n";
        /* translators: 1: Trackback/pingback website name, 2: Website IP address, 3: Website hostname. */
        $notify_message .= sprintf( __( 'Website: %1$s (IP address: %2$s, %3$s)' ), $comment->comment_author, $comment->comment_author_IP, $comment_author_domain ) . "\r\n";
        /* translators: %s: Trackback/pingback/comment author URL. */
        $notify_message .= sprintf( __( 'URL: %s' ), $comment->comment_author_url ) . "\r\n";
        /* translators: %s: Comment text. */
        $notify_message .= sprintf( __( 'Comment: %s' ), "\r\n" . $comment_content ) . "\r\n\r\n";
        $notify_message .= __( 'You can see all trackbacks on this post here:' ) . "\r\n";
 

 View on GitHub View on Trac