Consolidate the API hooks comment

[momo360modena]

Many functions of API comments have hooks unusable because they do not provide parameters that provides the function.

In general, these functions provides a $comment_ID argument, but it's not present in the hook...

Sample

function comment_author( $comment_ID = 0 ) {
	$author = apply_filters('comment_author', get_comment_author( $comment_ID ) );
	echo $author;
}

Fixed sample :

function comment_author( $comment_ID = 0 ) {
	$author = apply_filters('comment_author', get_comment_author( $comment_ID ), $comment_ID  );
	echo $author;
}

[jorbin]

Thanks for the suggestion momo360modena. Sorry you never got a response.

I like adding additional context to many of these filters. It definitely makes these filters more flexible and opens up a number of possibilities.

Perhaps though it make sense to be consistent with all of them and only include $comment_ID for all of them rather then sometimes including both $comment_ID and $comment.

When refreshing, some of these now have hook docs (which didn't exist when this patch was originally written), so please make sure to add the new @param value.

[jorbin]

related: #19849

[boonebgorges]

These go in as soon as we get a refresh and the docs that jorbin refers to above <3

[westi]

In 30092:

Comment Template Tags: Improve the availability of context information in comment template tag filters.

Fixes #22380 props momo360modena, tareq1988.

[DrewAPicture]

The hook doc changelogs need to be updated to reflect the newly-added parameters.

[DrewAPicture]

In 30111:

Update the changelogs for the comment hook parameters added in [30092].

Parameters were added to the get_comment_author, comment_author, get_comment_author_email, author_email, comment_email, get_comment_author_link, get_comment_author_IP, get_comment_author_url, comment_url, get_comment_excerpt, comment_excerpt, get_comment_ID, and get_comment_type filters.

Fixes #22380.