separate_comments() WordPress Function

The separate_comments() function is used to display comments differently based on their type. This function is useful for separating trackbacks and pingbacks from regular comments.

separate_comments( WP_Comment[] $comments ) #

Separates an array of comments into an array keyed by comment_type.


Parameters

$comments

(WP_Comment[])(Required)Array of comments


Top ↑

Return

(WP_Comment[]) Array of comments keyed by comment_type.


Top ↑

Source

File: wp-includes/comment.php

function separate_comments( &$comments ) {
	$comments_by_type = array(
		'comment'   => array(),
		'trackback' => array(),
		'pingback'  => array(),
		'pings'     => array(),
	);

	$count = count( $comments );

	for ( $i = 0; $i < $count; $i++ ) {
		$type = $comments[ $i ]->comment_type;

		if ( empty( $type ) ) {
			$type = 'comment';
		}

		$comments_by_type[ $type ][] = &$comments[ $i ];

		if ( 'trackback' === $type || 'pingback' === $type ) {
			$comments_by_type['pings'][] = &$comments[ $i ];
		}
	}

	return $comments_by_type;
}


Top ↑

Changelog

Changelog
VersionDescription
2.7.0Introduced.

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by theĀ Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.

Show More
Show More