wp_spam_comment

The timeline below displays how wordpress function wp_spam_comment has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 6.1

/**
 * Marks a comment as Spam.
 *
 * @since 2.9.0
 *
 * @param int|WP_Comment $comment_id Comment ID or WP_Comment object.
 * @return bool True on success, false on failure.
 */
function wp_spam_comment($comment_id)
{
    $comment = get_comment($comment_id);
    if (!$comment) {
        return false;
    }
    /**
     * Fires immediately before a comment is marked as Spam.
     *
     * @since 2.9.0
     * @since 4.9.0 Added the `$comment` parameter.
     *
     * @param int        $comment_id The comment ID.
     * @param WP_Comment $comment    The comment to be marked as spam.
     */
    do_action('spam_comment', $comment->comment_ID, $comment);
    if (wp_set_comment_status($comment, 'spam')) {
        delete_comment_meta($comment->comment_ID, '_wp_trash_meta_status');
        delete_comment_meta($comment->comment_ID, '_wp_trash_meta_time');
        add_comment_meta($comment->comment_ID, '_wp_trash_meta_status', $comment->comment_approved);
        add_comment_meta($comment->comment_ID, '_wp_trash_meta_time', time());
        /**
         * Fires immediately after a comment is marked as Spam.
         *
         * @since 2.9.0
         * @since 4.9.0 Added the `$comment` parameter.
         *
         * @param int        $comment_id The comment ID.
         * @param WP_Comment $comment    The comment marked as spam.
         */
        do_action('spammed_comment', $comment->comment_ID, $comment);
        return true;
    }
    return false;
}

WordPress Version: 4.9

/**
 * Marks a comment as Spam
 *
 * @since 2.9.0
 *
 * @param int|WP_Comment $comment_id Comment ID or WP_Comment object.
 * @return bool True on success, false on failure.
 */
function wp_spam_comment($comment_id)
{
    $comment = get_comment($comment_id);
    if (!$comment) {
        return false;
    }
    /**
     * Fires immediately before a comment is marked as Spam.
     *
     * @since 2.9.0
     * @since 4.9.0 Added the `$comment` parameter.
     *
     * @param int        $comment_id The comment ID.
     * @param WP_Comment $comment    The comment to be marked as spam.
     */
    do_action('spam_comment', $comment->comment_ID, $comment);
    if (wp_set_comment_status($comment, 'spam')) {
        delete_comment_meta($comment->comment_ID, '_wp_trash_meta_status');
        delete_comment_meta($comment->comment_ID, '_wp_trash_meta_time');
        add_comment_meta($comment->comment_ID, '_wp_trash_meta_status', $comment->comment_approved);
        add_comment_meta($comment->comment_ID, '_wp_trash_meta_time', time());
        /**
         * Fires immediately after a comment is marked as Spam.
         *
         * @since 2.9.0
         * @since 4.9.0 Added the `$comment` parameter.
         *
         * @param int        $comment_id The comment ID.
         * @param WP_Comment $comment    The comment marked as spam.
         */
        do_action('spammed_comment', $comment->comment_ID, $comment);
        return true;
    }
    return false;
}

WordPress Version: 4.4

/**
 * Marks a comment as Spam
 *
 * @since 2.9.0
 *
 * @param int|WP_Comment $comment_id Comment ID or WP_Comment object.
 * @return bool True on success, false on failure.
 */
function wp_spam_comment($comment_id)
{
    $comment = get_comment($comment_id);
    if (!$comment) {
        return false;
    }
    /**
     * Fires immediately before a comment is marked as Spam.
     *
     * @since 2.9.0
     *
     * @param int $comment_id The comment ID.
     */
    do_action('spam_comment', $comment->comment_ID);
    if (wp_set_comment_status($comment, 'spam')) {
        delete_comment_meta($comment->comment_ID, '_wp_trash_meta_status');
        delete_comment_meta($comment->comment_ID, '_wp_trash_meta_time');
        add_comment_meta($comment->comment_ID, '_wp_trash_meta_status', $comment->comment_approved);
        add_comment_meta($comment->comment_ID, '_wp_trash_meta_time', time());
        /**
         * Fires immediately after a comment is marked as Spam.
         *
         * @since 2.9.0
         *
         * @param int $comment_id The comment ID.
         */
        do_action('spammed_comment', $comment->comment_ID);
        return true;
    }
    return false;
}

WordPress Version: 3.9

/**
 * Marks a comment as Spam
 *
 * @since 2.9.0
 *
 * @param int $comment_id Comment ID.
 * @return bool True on success, false on failure.
 */
function wp_spam_comment($comment_id)
{
    if (!$comment = get_comment($comment_id)) {
        return false;
    }
    /**
     * Fires immediately before a comment is marked as Spam.
     *
     * @since 2.9.0
     *
     * @param int $comment_id The comment ID.
     */
    do_action('spam_comment', $comment_id);
    if (wp_set_comment_status($comment_id, 'spam')) {
        add_comment_meta($comment_id, '_wp_trash_meta_status', $comment->comment_approved);
        /**
         * Fires immediately after a comment is marked as Spam.
         *
         * @since 2.9.0
         *
         * @param int $comment_id The comment ID.
         */
        do_action('spammed_comment', $comment_id);
        return true;
    }
    return false;
}

WordPress Version: 3.8

/**
 * Marks a comment as Spam
 *
 * @since 2.9.0
 * @uses do_action() on 'spam_comment' before spamming
 * @uses do_action() on 'spammed_comment' after spamming
 *
 * @param int $comment_id Comment ID.
 * @return bool True on success, false on failure.
 */
function wp_spam_comment($comment_id)
{
    if (!$comment = get_comment($comment_id)) {
        return false;
    }
    /**
     * Fires immediately before a comment is marked as Spam.
     *
     * @since 2.9.0
     *
     * @param int $comment_id The comment ID.
     */
    do_action('spam_comment', $comment_id);
    if (wp_set_comment_status($comment_id, 'spam')) {
        add_comment_meta($comment_id, '_wp_trash_meta_status', $comment->comment_approved);
        /**
         * Fires immediately after a comment is marked as Spam.
         *
         * @since 2.9.0
         *
         * @param int $comment_id The comment ID.
         */
        do_action('spammed_comment', $comment_id);
        return true;
    }
    return false;
}

WordPress Version: 3.7

/**
 * Marks a comment as Spam
 *
 * @since 2.9.0
 * @uses do_action() on 'spam_comment' before spamming
 * @uses do_action() on 'spammed_comment' after spamming
 *
 * @param int $comment_id Comment ID.
 * @return bool True on success, false on failure.
 */
function wp_spam_comment($comment_id)
{
    if (!$comment = get_comment($comment_id)) {
        return false;
    }
    do_action('spam_comment', $comment_id);
    if (wp_set_comment_status($comment_id, 'spam')) {
        add_comment_meta($comment_id, '_wp_trash_meta_status', $comment->comment_approved);
        do_action('spammed_comment', $comment_id);
        return true;
    }
    return false;
}