booleanpress_auth_failure

action Tier B Since 0.2.3

Runs after the failure has been written to the PHP error log, so a plugin can forward it to its own security monitoring.

Signature

add_action( 'booleanpress_auth_failure', $callback, 10, 1 );

Parameters

Parameter	Type	Description
$data	array<string, mixed>	Failure details: `type` (`auth_failure`), `reason`, `ip`, `path`, `method`, `user_agent`, `timestamp`, `required_capability` when a capability was checked and `user_id` when a user was logged in.

Fires in

• vendor/booleanpress/core/src/Http/Middleware/AuthMiddleware.php:122 — BooleanSmtp\Core\Http\Middleware\AuthMiddleware::logAuthFailure()

Example

booleanpress_auth_failure.php

add_action( 'booleanpress_auth_failure', function ( array $data ) {
    // React to the event.
}, 10, 1 );

Next steps

• Framework — every hook in this area, in firing order where that applies.
• Hook Explorer — filter and search every hook.