Ticket #33717: 33717.diff

src/wp-includes/comment-functions.php

@@ -2391 +2391 @@
 
         return $open;
 }
+
+/**
+ * Notify a comment author when his comment gets approved.
+ *
+ * @since 4.4.0
+ *
+ * @param string     $new_status New comment status.
+ * @param string     $old_status Previous comment status.
+ * @param WP_Comment $comment    Comment object.
+ * @return bool Whether the email was sent successfully.
+ */
+function wp_notify_commenter( $new_status, $old_status, $comment ) {
+        /**
+         * Filter whether to notify comment authors when their comment gets approved.
+         *
+         * @since 4.4.0
+         *
+         * @param bool       $notify  Whether to notify the comment author. Default true.
+         * @param WP_Comment $comment Comment object.
+         */
+        $notify_commenter = apply_filters( 'comment_notification_notify_commenter', true, $comment );
+
+        if ( ! $notify_commenter ) {
+                return false;
+        }
+
+        $post = get_post( $comment->comment_post_ID );
+
+        if ( ! $post ) {
+                return false;
+        }
+
+        // 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 );
+
+        /* translators: 1: blog name, 2: post title */
+        $subject = sprintf( __( '[%1$s] Your comment on "%2$s" got approved' ), $blogname, $post->post_title );
+
+        $notify_message = sprintf( __( 'Howdy %s,' ), $comment->comment_author ) . "\r\n\r\n";
+        $notify_message .= sprintf( __( 'Your comment on the post "%1$s" got approved.' ), $post->post_title ) . "\r\n\r\n";
+        /* translators: 1: comment author, 2: author IP, 3: author domain */
+        $notify_message .= sprintf( __( 'View comment: %s' ), get_comment_link( $comment ) ) . "\r\n";
+
+        /**
+         * Filter the comment approval notification email text.
+         *
+         * @since 4.4.0
+         *
+         * @param string     $notify_message The comment notification email text.
+         * @param WP_Comment $comment        Comment object.
+         */
+        $notify_message = apply_filters( 'comment_approval_notification_text', $notify_message, $comment );
+
+        /**
+         * Filter the comment approval notification email subject.
+         *
+         * @since 4.4.0
+         *
+         * @param string     $subject The comment notification email subject.
+         * @param WP_Comment $comment Comment object.
+         */
+        $subject = apply_filters( 'comment_approval_notification_subject', $subject, $comment );
+
+        return wp_mail( $comment->comment_author_email, wp_specialchars_decode( $subject ), $notify_message );
+}

src/wp-includes/comment-template.php

@@ -1928 +1928 @@
                         <?php printf( __( '<cite class="fn">%s</cite> <span class="says">says:</span>' ), get_comment_author_link() ); ?>
                 </div>
                 <?php if ( '0' == $comment->comment_approved ) : ?>
-                <em class="comment-awaiting-moderation"><?php _e( 'Your comment is awaiting moderation.' ) ?></em>
+                <em class="comment-awaiting-moderation"><?php _e( 'Your comment is awaiting moderation. You will receive an email when it gets approved.' ) ?></em>
                 <br />
                 <?php endif; ?>
 
@@ -1993 +1993 @@
                                         </div><!-- .comment-metadata -->
 
                                         <?php if ( '0' == $comment->comment_approved ) : ?>
-                                        <p class="comment-awaiting-moderation"><?php _e( 'Your comment is awaiting moderation.' ); ?></p>
+                                        <p class="comment-awaiting-moderation"><?php _e( 'Your comment is awaiting moderation. You will receive an email when it gets approved.' ); ?></p>
                                         <?php endif; ?>
                                 </footer><!-- .comment-meta -->
 

src/wp-includes/default-filters.php

@@ -334 +334 @@
 add_action( 'split_shared_term', '_wp_check_split_nav_menu_terms', 10, 4 );
 add_action( 'wp_split_shared_term_batch', '_wp_batch_split_terms' );
 
+// Comments.
+add_action( 'transition_comment_status', 'wp_notify_commenter', 10, 3 );
+
 /**
  * Filters formerly mixed into wp-includes
  */