wp_is_comment_flood
Filters whether a comment is part of a comment flood.
The default check is wp_check_comment_flood(). See check_comment_flood_db().
Использование
add_filter( 'wp_is_comment_flood', 'wp_kama_is_comment_flood_filter', 10, 5 );
/**
* Function for `wp_is_comment_flood` filter-hook.
*
* @param bool $is_flood Is a comment flooding occurring? Default false.
* @param string $comment_author_ip Comment author's IP address.
* @param string $comment_author_email Comment author's email.
* @param string $comment_date_gmt GMT date the comment was posted.
* @param bool $wp_error Whether to return a WP_Error object instead of executing wp_die() or die() if a comment flood is occurring.
*
* @return bool
*/
function wp_kama_is_comment_flood_filter( $is_flood, $comment_author_ip, $comment_author_email, $comment_date_gmt, $wp_error ){
// filter...
return $is_flood;
}
- $is_flood(true|false)
- Is a comment flooding occurring? Default false.
- $comment_author_ip(строка)
- Comment author's IP address.
- $comment_author_email(строка)
- Comment author's email.
- $comment_date_gmt(строка)
- GMT date the comment was posted.
- $wp_error(true|false)
- Whether to return a WP_Error object instead of executing wp_die() or die() if a comment flood is occurring.
Список изменений
| С версии 4.7.0 | Введена. |
| С версии 5.5.0 | The $avoid_die parameter was renamed to $wp_error. |
Где вызывается хук
wp_is_comment_flood
wp-includes/comment.php 797-804
$is_flood = apply_filters( 'wp_is_comment_flood', false, $commentdata['comment_author_IP'], $commentdata['comment_author_email'], $commentdata['comment_date_gmt'], $wp_error );
Где используется хук в WordPress
wp-includes/comment.php 827
add_filter( 'wp_is_comment_flood', 'wp_check_comment_flood', 10, 5 );