Introduction to Comments Management

Comments are a powerful feature for building community and engagement on your WordPress site. Effective comment management involves balancing open discussion with spam prevention and maintaining a positive environment for your audience.

The Comments Interface

Discussion Settings Configuration

Programmatic Settings Management

<?php
// Update discussion settings programmatically
update_option('default_comment_status', 'open');
update_option('default_ping_status', 'open');
update_option('require_name_email', 1);
update_option('comment_registration', 0);
update_option('close_comments_for_old_posts', 1);
update_option('close_comments_days_old', 14);
update_option('thread_comments', 1);
update_option('thread_comments_depth', 5);
update_option('page_comments', 1);
update_option('comments_per_page', 50);
update_option('comment_order', 'asc');
update_option('comment_moderation', 1);
update_option('moderation_notify', 1);
update_option('comments_notify', 1);

// Check if comments are open for a post
if (comments_open($post_id)) {
    // Comments are open
}

// Enable/disable comments for specific post
wp_update_post(array(
    'ID' => $post_id,
    'comment_status' => 'open', // or 'closed'
    'ping_status' => 'open' // or 'closed'
));

// Bulk enable/disable comments
$posts = get_posts(array(
    'posts_per_page' => -1,
    'post_type' => 'post'
));

foreach ($posts as $post) {
    wp_update_post(array(
        'ID' => $post->ID,
        'comment_status' => 'closed'
    ));
}
?>

Comment Moderation Workflow

Moderation Functions

<?php
// Get comments awaiting moderation
$pending_comments = get_comments(array(
    'status' => 'hold',
    'number' => 20
));

// Approve a comment
wp_set_comment_status($comment_id, 'approve');

// Mark as spam
wp_spam_comment($comment_id);

// Trash a comment
wp_trash_comment($comment_id);

// Untrash a comment
wp_untrash_comment($comment_id);

// Delete permanently
wp_delete_comment($comment_id, true);

// Bulk moderation
$comment_ids = array(123, 124, 125);
foreach ($comment_ids as $id) {
    wp_set_comment_status($id, 'approve');
}

// Custom moderation rules
add_filter('pre_comment_approved', function($approved, $commentdata) {
    // Check for specific keywords
    $blocked_words = array('casino', 'viagra', 'lottery');
    $comment_content = strtolower($commentdata['comment_content']);
    
    foreach ($blocked_words as $word) {
        if (strpos($comment_content, $word) !== false) {
            return 'spam'; // Mark as spam
        }
    }
    
    // Check comment length
    if (strlen($commentdata['comment_content']) < 10) {
        return 0; // Hold for moderation
    }
    
    // Check for excessive links
    $link_count = substr_count($comment_content, 'http');
    if ($link_count > 3) {
        return 0; // Hold for moderation
    }
    
    return $approved;
}, 10, 2);

// Add moderation notification
add_action('comment_post', function($comment_id, $comment_approved) {
    if ($comment_approved === 0) {
        $comment = get_comment($comment_id);
        
        // Send notification to admin
        wp_mail(
            get_option('admin_email'),
            'Comment Awaiting Moderation',
            sprintf(
                'A new comment by %s requires moderation: %s',
                $comment->comment_author,
                admin_url('comment.php?action=editcomment&c=' . $comment_id)
            )
        );
    }
}, 10, 2);
?>

Spam Prevention

Comment Blacklist

Anti-Spam Implementation

<?php
// Add honeypot field to comment form
add_action('comment_form', function() {
    echo '<p class="comment-form-url" style="display: none;">';
    echo '<label for="url">URL</label>';
    echo '<input id="url" name="url" type="text" value="" />';
    echo '</p>';
});

// Check honeypot on submission
add_filter('preprocess_comment', function($commentdata) {
    if (!empty($_POST['url'])) {
        wp_die('Spam detected!');
    }
    return $commentdata;
});

// Implement reCAPTCHA
function add_recaptcha_to_comment_form() {
    ?>
    <div class="g-recaptcha" data-sitekey="your-site-key"></div>
    <script src="https://www.google.com/recaptcha/api.js"></script>
    <?php
}
add_action('comment_form_after_fields', 'add_recaptcha_to_comment_form');

// Verify reCAPTCHA
add_filter('preprocess_comment', function($commentdata) {
    if (isset($_POST['g-recaptcha-response'])) {
        $response = wp_remote_get(
            'https://www.google.com/recaptcha/api/siteverify?secret=' . 
            'your-secret-key&response=' . $_POST['g-recaptcha-response']
        );
        
        $response_body = wp_remote_retrieve_body($response);
        $result = json_decode($response_body);
        
        if (!$result->success) {
            wp_die('reCAPTCHA verification failed. Please try again.');
        }
    }
    
    return $commentdata;
});

// Custom spam detection
function is_comment_spam($comment_data) {
    $spam_indicators = 0;
    
    // Check for excessive links
    if (substr_count($comment_data['comment_content'], 'http') > 3) {
        $spam_indicators++;
    }
    
    // Check for all caps
    if (strtoupper($comment_data['comment_content']) === $comment_data['comment_content']) {
        $spam_indicators++;
    }
    
    // Check for repeated characters
    if (preg_match('/(.)\1{5,}/', $comment_data['comment_content'])) {
        $spam_indicators++;
    }
    
    // Check comment velocity (too many comments too quickly)
    $recent_comments = get_comments(array(
        'author_email' => $comment_data['comment_author_email'],
        'date_query' => array(
            array('after' => '5 minutes ago')
        )
    ));
    
    if (count($recent_comments) > 3) {
        $spam_indicators++;
    }
    
    return $spam_indicators >= 2;
}
?>

Comment Forms and Display

Customizing Comment Display

<?php
// Custom comment template
function custom_comment_template($comment, $args, $depth) {
    ?>
    <li id="comment-<?php comment_ID(); ?>" <?php comment_class(); ?>>
        <article class="comment-body">
            <header class="comment-header">
                <?php echo get_avatar($comment, 60); ?>
                <div class="comment-meta">
                    <cite class="comment-author">
                        <?php comment_author_link(); ?>
                    </cite>
                    <time datetime="<?php comment_time('c'); ?>">
                        <?php comment_date(); ?> at <?php comment_time(); ?>
                    </time>
                    <?php if ($comment->comment_approved == '0') : ?>
                        <p class="comment-awaiting-moderation">
                            Your comment is awaiting moderation.
                        </p>
                    <?php endif; ?>
                </div>
            </header>
            
            <div class="comment-content">
                <?php comment_text(); ?>
            </div>
            
            <footer class="comment-footer">
                <?php 
                comment_reply_link(array_merge($args, array(
                    'depth' => $depth,
                    'max_depth' => $args['max_depth'],
                    'reply_text' => 'Reply',
                    'reply_to_text' => 'Reply to %s'
                ))); 
                ?>
                <?php edit_comment_link('Edit', ' | '); ?>
            </footer>
        </article>
    <?php
}

// Display comments
if (comments_open() || get_comments_number()) {
    comments_template();
}

// Custom comment form
$comment_args = array(
    'title_reply' => 'Join the Discussion',
    'title_reply_to' => 'Reply to %s',
    'cancel_reply_link' => 'Cancel Reply',
    'label_submit' => 'Post Comment',
    'comment_field' => '<p class="comment-form-comment">
        <label for="comment">Your Message</label>
        <textarea id="comment" name="comment" rows="8" required></textarea>
    </p>',
    'fields' => array(
        'author' => '<p class="comment-form-author">
            <label for="author">Name <span class="required">*</span></label>
            <input id="author" name="author" type="text" required />
        </p>',
        'email' => '<p class="comment-form-email">
            <label for="email">Email <span class="required">*</span></label>
            <input id="email" name="email" type="email" required />
        </p>',
        'url' => '<p class="comment-form-url">
            <label for="url">Website</label>
            <input id="url" name="url" type="url" />
        </p>'
    ),
    'comment_notes_before' => '<p class="comment-notes">
        Your email address will not be published. Required fields are marked *
    </p>',
    'comment_notes_after' => '',
    'submit_button' => '<button type="submit" class="submit-comment">%4$s</button>',
    'submit_field' => '<p class="form-submit">%1$s %2$s</p>',
    'format' => 'html5'
);

comment_form($comment_args);
?>

Pingbacks and Trackbacks

Managing Pingbacks/Trackbacks

<?php
// Disable pingbacks globally
add_filter('xmlrpc_methods', function($methods) {
    unset($methods['pingback.ping']);
    unset($methods['pingback.extensions.getPingbacks']);
    return $methods;
});

// Remove pingback header
add_filter('wp_headers', function($headers) {
    unset($headers['X-Pingback']);
    return $headers;
});

// Disable self-pingbacks
add_action('pre_ping', function(&$links) {
    $home = get_option('home');
    foreach ($links as $l => $link) {
        if (strpos($link, $home) === 0) {
            unset($links[$l]);
        }
    }
});

// Display pingbacks separately
function list_pingbacks() {
    $pingbacks = get_comments(array(
        'type' => 'pingback',
        'status' => 'approve'
    ));
    
    if ($pingbacks) {
        echo '<h3>Pingbacks & Trackbacks</h3>';
        echo '<ul class="pingback-list">';
        
        foreach ($pingbacks as $pingback) {
            echo '<li>';
            echo get_comment_author_link($pingback);
            echo ' on ';
            echo get_comment_date('', $pingback);
            echo '</li>';
        }
        
        echo '</ul>';
    }
}
?>

Comment Notifications

Custom Notification System

<?php
// Custom comment notification email
add_filter('comment_notification_text', function($notify_message, $comment_id) {
    $comment = get_comment($comment_id);
    $post = get_post($comment->comment_post_ID);
    
    $notify_message = sprintf(
        'New comment on your post "%s"\n\n',
        $post->post_title
    );
    
    $notify_message .= sprintf(
        'Author: %s\n',
        $comment->comment_author
    );
    
    $notify_message .= sprintf(
        'Email: %s\n',
        $comment->comment_author_email
    );
    
    $notify_message .= sprintf(
        'Comment:\n%s\n\n',
        $comment->comment_content
    );
    
    $notify_message .= sprintf(
        'View comment: %s\n',
        get_comment_link($comment)
    );
    
    $notify_message .= sprintf(
        'Moderate comment: %s',
        admin_url('comment.php?action=editcomment&c=' . $comment_id)
    );
    
    return $notify_message;
}, 10, 2);

// Send notification to post author
add_action('comment_post', function($comment_id, $comment_approved) {
    if ($comment_approved === 1) {
        $comment = get_comment($comment_id);
        $post = get_post($comment->comment_post_ID);
        $author = get_userdata($post->post_author);
        
        // Don't notify if author commenting on own post
        if ($comment->user_id != $post->post_author) {
            wp_mail(
                $author->user_email,
                'New Comment on: ' . $post->post_title,
                'You have a new comment on your post. View it here: ' . 
                get_comment_link($comment)
            );
        }
    }
}, 10, 2);

// Subscribe to comment threads
function subscribe_to_comments($comment_id) {
    $comment = get_comment($comment_id);
    
    // Store subscriber email
    add_comment_meta($comment_id, '_subscribed_to_thread', true);
    
    // Send notifications to other subscribers
    $parent_id = $comment->comment_parent;
    if ($parent_id) {
        $subscribers = get_comments(array(
            'post_id' => $comment->comment_post_ID,
            'meta_key' => '_subscribed_to_thread',
            'meta_value' => true
        ));
        
        foreach ($subscribers as $subscriber) {
            if ($subscriber->comment_author_email !== $comment->comment_author_email) {
                wp_mail(
                    $subscriber->comment_author_email,
                    'New Reply in Thread',
                    'Someone replied to a thread you\'re following: ' . 
                    get_comment_link($comment)
                );
            }
        }
    }
}
add_action('comment_post', 'subscribe_to_comments');
?>

Advanced Comment Management

<?php
// Comment statistics
function get_comment_stats($post_id = null) {
    $args = array('count' => true);
    
    if ($post_id) {
        $args['post_id'] = $post_id;
    }
    
    $stats = array(
        'total' => get_comments($args),
        'approved' => get_comments(array_merge($args, array('status' => 'approve'))),
        'pending' => get_comments(array_merge($args, array('status' => 'hold'))),
        'spam' => get_comments(array_merge($args, array('status' => 'spam'))),
        'trash' => get_comments(array_merge($args, array('status' => 'trash')))
    );
    
    return $stats;
}

// Most commented posts
function get_most_commented_posts($num = 5) {
    return get_posts(array(
        'posts_per_page' => $num,
        'orderby' => 'comment_count',
        'order' => 'DESC'
    ));
}

// Recent commenters
function get_recent_commenters($num = 10) {
    global $wpdb;
    
    $commenters = $wpdb->get_results($wpdb->prepare("
        SELECT 
            comment_author,
            comment_author_email,
            comment_author_url,
            COUNT(*) as comment_count
        FROM {$wpdb->comments}
        WHERE comment_approved = '1'
            AND comment_type = 'comment'
            AND comment_author_email != ''
        GROUP BY comment_author_email
        ORDER BY MAX(comment_date_gmt) DESC
        LIMIT %d
    ", $num));
    
    return $commenters;
}

// Comment rating system
add_action('comment_form', function() {
    ?>
    <div class="comment-rating">
        <label>Rate this post:</label>
        <select name="rating">
            <option value="">Select...</option>
            <option value="5">5 Stars</option>
            <option value="4">4 Stars</option>
            <option value="3">3 Stars</option>
            <option value="2">2 Stars</option>
            <option value="1">1 Star</option>
        </select>
    </div>
    <?php
});

add_action('comment_post', function($comment_id) {
    if (isset($_POST['rating']) && $_POST['rating'] != '') {
        add_comment_meta($comment_id, 'rating', $_POST['rating']);
    }
});

// Display average rating
function get_post_average_rating($post_id) {
    $comments = get_comments(array(
        'post_id' => $post_id,
        'status' => 'approve',
        'meta_key' => 'rating'
    ));
    
    if (empty($comments)) {
        return 0;
    }
    
    $total = 0;
    $count = 0;
    
    foreach ($comments as $comment) {
        $rating = get_comment_meta($comment->comment_ID, 'rating', true);
        if ($rating) {
            $total += intval($rating);
            $count++;
        }
    }
    
    return $count > 0 ? round($total / $count, 1) : 0;
}
?>

Practice Exercise