WordPress.org

Function Reference/wp new comment

Description

Adds a new comment to the database.

Filters new comment to ensure that the fields are sanitized and valid before inserting comment into database. Calls 'comment_post' action with comment ID and whether comment is approved by WordPress. Also has 'preprocess_comment' filter for processing the comment data before the function handles it.

Usage

<?php wp_new_comment( $commentdata ) ?>

Parameters

$commentdata

(array) (required) Contains information on the comment.

Default: None

Return Values

(integer): The ID of the comment after adding.

Examples

Notes

Uses: apply_filters() Calls 'preprocess_comment' hook on $commentdata parameter array before processing
Uses: do_action() Calls 'comment_post' hook on $comment_ID returned from adding the comment and if the comment was approved.
Uses: wp_filter_comment() Used to filter comment before adding comment.
Uses: wp_allow_comment() checks to see if comment is approved.
Uses: wp_insert_comment() Does the actual comment insertion to the database.
Uses: wp_notify_moderator()
Uses: wp_notify_postauthor()
Uses: wp_get_comment_status()

Change Log

Since: 1.5.0

Source File

wp_new_comment() is located in wp-includes/comment.php.

WordPress.org

Codex

Function Reference/wp new comment

Contents