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 760-767
$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 790
add_filter( 'wp_is_comment_flood', 'wp_check_comment_flood', 10, 5 );