wp_handle_comment_submission()

wp_handle_comment_submission() — Handles the submission of a comment, usually posted to wp-comments-post.php via a comment form. This function expects unslashed data, as opposed to functions such as wp_new_comment() which expect slashed data.

Inputs: $comment_data (array): Comment data. Field $comment_post_ID (string|int): The ID of the post that relates to the comment. Field $author (string): The name of the comment author. Field $email (string): The comment author email address. Field $url (string): The comment author URL. Field $comment (string): The content of the comment. Field $comment_parent (string|int): The ID of this comment’s parent, if any. Default 0. Field $_wp_unfiltered_html_comment (string): The nonce value for allowing unfiltered HTML.

Returns WP_Comment|WP_Error: A WP_Comment object on success, a WP_Error object on failure.