boolean_smtp_should_store_smtp_transcript

Filters whether the SMTP transcript of a send is stored as a debug session file.

filter Tier B Since 1.0.0

Consulted for every SMTP send through a connection whose "SMTP Debug Level" is above 0. Off by default: the level only shapes the live diagnostics the Test Email screen shows. Return `true` to keep the transcript (credentials hidden) under `wp-content/uploads/boolean-smtp/debug-sessions/`, one file per email log entry, for seven days; read them with `GET tools/debug-logs` or the log entry's debug session.

Signature

add_filter( 'boolean_smtp_should_store_smtp_transcript', $callback, 10, 3 );

Parameters

Parameter	Type	Description
`$store`	`bool`	Whether to store the transcript. Default `false`.
`$connection`	`\BooleanSmtp\Models\Connection`	The connection the message is sent through.
`$level`	`int`	The connection's SMTP debug level (1–4).

Returns bool — Whether to store the transcript.

Fires in

app/Services/Mailer/MailerManager.php:1765 — BooleanSmtp\Services\Mailer\MailerManager::shouldStoreSmtpTranscript()

Example

add_filter( 'boolean_smtp_should_store_smtp_transcript', function ( bool $store, \BooleanSmtp\Models\Connection $connection, int $level ) {
    return $store;
}, 10, 3 );

Next steps

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