# wp_login_failed

URL: https://chugunov.pro/api-wordpress/actions/wp_login_failed/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: хук-действие.
Появился в версии: 2.5.0.

## Сигнатура

```php
do_action( 'wp_login_failed', string $username, WP_Error $error )
```

## Описание

Срабатывает после неудачной попытки входа пользователя.

## Параметры

- `$username` `string` — обязательный. Имя пользователя или email-адрес.
- `$error` `WP_Error` — обязательный. Объект WP_Error с подробностями об ошибке аутентификации.

## Исходный код

Файл: `wp-includes/pluggable.php:731`

```php
do_action( 'wp_login_failed', $username, $error );
```

## История изменений

- 5.4.0 — The $error parameter was added.
- 4.5.0 — The value of $username can now be an email address.
- 2.5.0 — Introduced.

## Связанные

Используется в: [`wp_authenticate`](https://chugunov.pro/api-wordpress/functions/wp_authenticate/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/hooks/wp_login_failed/