Funkciókapcsolók és kezelt e-mail-típusok

gravitysmtp_feature_flag (filter)

Fejlesztőként letilthatsz egyes Gravity SMTP funkciókat. Alapból minden funkció be van kapcsolva.

add_filter( 'gravitysmtp_feature_flag', 'fuggveny_neve', 10 );

Paraméter	Típus	Leírás
$enabled	logikai	true vagy false: a funkció be- vagy kikapcsolt.
$flag_name	szöveg	A funkció neve.

A $flag_name lehetséges értékei:

Név	Elérhető
mailchimp_integration	1.5.0-tól
gravitysmtp_dashboard_app	1.4.0-tól
amazon_ses_integration	1.4.0-tól
gravityforms_entry_note	1.4.0-tól
wp_email_management	1.3.0-tól

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

Példák

Minden funkció bekapcsolása:

add_filter( 'gravitysmtp_feature_flag', '__return_true' );

Minden funkció kikapcsolása:

add_action( 'plugins_loaded', function () {
    add_filter( 'gravitysmtp_feature_flag', '__return_false', PHP_INT_MAX );
}, 99 );

Egy adott funkció bekapcsolása:

add_filter( 'gravitysmtp_feature_flag', function( $enabled, $flag_name ) {
    return $flag_name === 'funkcio_neve' ? true : $enabled;
}, 10, 2 );

Egy adott funkció kikapcsolása:

add_action( 'plugins_loaded', function () {
    add_filter( 'gravitysmtp_feature_flag', function ( $enabled, $flag_name ) {
        return $flag_name === 'funkcio_neve' ? false : $enabled;
    }, PHP_INT_MAX, 2 );
}, 99 );

Funkció kikapcsolásához a plugins_loaded hookot és a PHP_INT_MAX prioritást kell használnod, mert a bővítmény belül ugyanígy kapcsolja be a funkciókat.

gravitysmtp_managed_email_types (filter)

Módosíthatod vagy bővítheted a kezelt e-mail-típusok listáját, vagyis saját típusokat vehetsz fel az E-mail-kezelés képernyőre. Így a saját levelek is ki- és bekapcsolhatók ott.

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

A paraméter ($email_types) a kezelt e-mail-típusok tömbje. Egy típus elemei:

Elem	Leírás
key	Egyedi azonosító. Nincs formai követelmény, de a regisztrált típusok között egyedinek kell lennie.
label	Rövid, leíró név, ez látszik az E-mail-kezelés képernyőn.
category	A kategória neve, amely csoportfejlécként jelenik meg a képernyőn.
description	Részletes leírás: mi a levél, kik a címzettek, és mi váltja ki. A címke alatt jelenik meg.
disable_callback	Meghívható (callable) függvény, amely akkor fut, amikor a levelet letiltják. Az a dolga, hogy ténylegesen megakadályozza a küldést. WordPress-magleveleknél ez általában egy action eltávolítása vagy egy szűrő false értékkel való visszatérése.

Példa két egyedi e-mail-típus felvételére:

add_filter( 'gravitysmtp_managed_email_types', function ( $email_types ) {
    $custom_emails = [
        [
            'key'         => 'new_user_welcome_email',
            'label'       => 'Új felhasználó üdvözlő e-mailje',
            'category'    => 'Egyedi értesítések',
            'description' => 'Sikeres regisztráció után megy az új felhasználónak.',
            'filter'      => 'wp_new_user_notification_email',
        ],
        [
            'key'         => 'comment_moderation_email',
            'label'       => 'Hozzászólás-moderálási e-mail',
            'category'    => 'Egyedi értesítések',
            'description' => 'A moderátoroknak megy, ha egy hozzászólás jóváhagyásra vár.',
            'filter'      => 'notify_moderator',
        ],
    ];

    foreach ( $custom_emails as $email ) {
        $email_types[] = new \Gravity_Forms\Gravity_SMTP\Email_Management\Managed_Email(
            key: $email['key'],
            label: $email['label'],
            category: $email['category'],
            description: $email['description'],
            disable_callback: function () use ( $email ) {
                add_filter( $email['filter'], '__return_false' );
            }
        );
    }

    return $email_types;
}, 10, 1 );

A felvett típusok az E-mail-kezelés képernyőn a megadott kategória alatt jelennek meg.

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