wppaste
WordPress

apply_filters( 'preprocess_comment', array $commentdata )

Since
1.5.0, 5.6.0
Filters a comment's data before it is sanitized and inserted into the database.

Compatibility

WordPress
since 5.6.0
  • 6.7.7
  • 6.8.8
  • 6.9.7
  • 7.0.4
  • 7.1.0

Present in every tracked release (6.7.7 to 7.1.0).

Parameters

$commentdataarray
Comment data.

Where this hook fires · 1

  • wp-includes/comment.php:2347wp_new_comment()

Source code

	 *	 * @since 1.5.0	 * @since 5.6.0 Comment data includes the `comment_agent` and `comment_author_IP` values.	 *	 * @param array $commentdata Comment data.	 */	$commentdata = apply_filters( 'preprocess_comment', $commentdata ); 	$commentdata['comment_post_ID'] = (int) $commentdata['comment_post_ID']; 	// Normalize `user_ID` to `user_id` again, after the filter.	if ( isset( $commentdata['user_ID'] ) && $prefiltered_user_id !== (int) $commentdata['user_ID'] ) {		$commentdata['user_ID'] = (int) $commentdata['user_ID'];

Changelog

Introduced in 1.5.0. Unchanged from 6.7.7 through 7.1.0.

  1. 6.7.7
  2. 6.8.8
  3. 6.9.7
  4. 7.0.4
  5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

5.6.0
Comment data includes the comment_agent and comment_author_IP values.from the docblock
1.5.0
Introduced.from the docblock

About this page

Parsed data
Generated from the wordpress-develop 7.0.4 tag, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.
Corrections
Something wrong on this page? Report it and it gets fixed in the next regeneration.