boolean_smtp_skip_fallback_retry
Filters whether the fallback retry should be skipped for a failed send.
filter Tier A Since 1.0.0
Return true to skip the fallback retry and the retries on other connections, and notify of the final failure immediately.
Signature
add_filter( 'boolean_smtp_skip_fallback_retry', $callback, 10, 2 );Parameters
| Parameter | Type | Description |
|---|---|---|
$skip | bool | Whether to skip the fallback retry; false by default. |
$error | \WP_Error | WordPress error describing the failed send. |
Returns bool — The filtered value.
Fires in
app/Services/Mailer/MailFailureHandler.php:107—BooleanSmtp\Services\Mailer\MailFailureHandler::handle()
Example
add_filter( 'boolean_smtp_skip_fallback_retry', function ( bool $skip, \WP_Error $error ) { return $skip;}, 10, 2 );Next steps
- Mail pipeline — every hook in this area, in firing order where that applies.
- Hook Explorer — filter and search every hook.