Küldési hibák, összefoglaló gyakoriság, SparkPost és Twilio hookjai

Ezek a hookok a sikertelen küldésre, az összefoglaló e-mail beállítására, a SparkPost-küldésre és az SMS-riasztásokra vonatkoznak. A kódot az aktív téma functions.php fájljába, egy saját funkcióbővítő bővítménybe, egyedi kiegészítőbe vagy kódrészlet-kezelő bővítménybe teheted.

gravitysmtp_on_send_failure (action)

Lefut, ha egy e-mail elküldése nem sikerül a Gravity SMTP-n keresztül. Saját kódot futtathatsz vele, például értesítést küldhetsz egy másik csatornán.

add_action( 'gravitysmtp_on_send_failure', 'fuggveny_neve', 10, 1 );

Paraméter	Típus	Leírás
$email_id	egész szám	A sikertelen e-mail-esemény azonosítója.

add_action( 'gravitysmtp_on_send_failure', function( $email_id ) {
    // Ide jön a saját kód, ha egy levél nem ment el.
} );

gravitysmtp_on_primary_failure (action)

Lefut, ha a levél elküldése az elsődleges integráción nem sikerül. Ez korábbi pont, mint a végleges küldési hiba: itt még dönthetsz arról, mi történjen az elsődleges integráció hibájakor.

add_action( 'gravitysmtp_on_primary_failure', 'fuggveny_neve', 10, 1 );

Paraméter	Típus	Leírás
$failed_id	egész szám	A sikertelen e-mail-esemény azonosítója.

add_action( 'gravitysmtp_on_primary_failure', function( $failed_id ) {
    // Ide jön a saját kód, ha az elsődleges küldés nem sikerült.
} );

A hook a Gravity SMTP 2.2-es verziójától érhető el.

gravitysmtp_notifications_email_digest_frequency_options (filter)

Az SMTP → Beállítások oldal E-mailes történések összefoglalója részén az Összefoglaló küldése listában választható gyakoriságokat módosíthatod vele. Alapból három van: Napi (1 nap), Hetente (ajánlott) (7 nap) és Havi (30 nap). Az összefoglaló e-mail működését a Riasztások és összefoglaló e-mail fejezet írja le.

add_filter( 'gravitysmtp_notifications_email_digest_frequency_options', 'fuggveny_neve', 10, 1 );

Paraméter	Típus	Leírás
$options	tömb	A gyakoriságok tömbje. Minden elem két kulcsot tartalmaz: label (a felületen megjelenő felirat, szöveg) és value (az időköz napokban, egész szám).

Az alapértelmezett érték:

array(
    array( 'label' => 'Daily', 'value' => 1 ),
    array( 'label' => 'Weekly (recommended)', 'value' => 7 ),
    array( 'label' => 'Monthly', 'value' => 30 ),
);

Példa: háromnaponkénti küldés hozzáadása.

add_filter( 'gravitysmtp_notifications_email_digest_frequency_options', function( $options ) {
    $options[] = array(
        'label' => __( 'Every 3 Days', 'gravitysmtp' ),
        'value' => 3,
    );
    return $options;
} );

A szűrő a Gravity SMTP 2.0.0 verziójától érhető el.

gravitysmtp_sparkpost_send_as_transactional (filter)

Azt szabályozza, hogy a SparkPoston át küldött leveleket tranzakciósként jelölje-e meg a Gravity SMTP. Alapértéke true. A SparkPost integráció beállítását a SparkPost fejezet tartalmazza.

add_filter( 'gravitysmtp_sparkpost_send_as_transactional', 'fuggveny_neve', 10, 1 );

Paraméter	Típus	Leírás
$send_as_transactional	logikai	Tranzakciósként menjen-e a levél. Alapérték: true.

Példa: a tranzakciós jelölés kikapcsolása.

add_filter( 'gravitysmtp_sparkpost_send_as_transactional', '__return_false' );

gravitysmtp_twilio_alert_request_body (filter)

A Twilio API-nak küldött kérés törzsét módosíthatod vele, amikor a Gravity SMTP SMS-ben küld riasztást. Az SMS-riasztásokról a Riasztások és összefoglaló e-mail fejezet szól.

add_filter( 'gravitysmtp_twilio_alert_request_body', 'fuggveny_neve', 10, 2 );

Paraméter	Típus	Leírás
$request_body	tömb	A Twilionak küldendő kéréstörzs. Alapból az ApplicationSid, Body, To és From mezőket tartalmazza.
$send_args	tömb	Az eredeti küldési paraméterek: account_id, auth_token, to, from és message.

Példa: egyedi Twilio-paraméterek hozzáadása.

add_filter( 'gravitysmtp_twilio_alert_request_body', 'twilio_uzenet_testreszabasa', 10, 2 );

function twilio_uzenet_testreszabasa( $request_body, $send_args ) {
    $request_body['StatusCallback'] = 'https://pelda.example/twilio-webhook';
    $request_body['ValidityPeriod'] = 1440; // 24 óra, percben megadva

    return $request_body;
}