TukuToi Send Email If

FAQ

This Plugin has no settings!

That’s right, in order to keep this lightweight, no settings or options pages where added in the backend.
Instead, a set of Filters will allow you to control the Plugin behaviour fully.
Read more about this in the below FAQ entries.

This Plugin does not work after activating!

The plugin will not activate its features unless you tell it to do so, using the Filters documented below.
Mandatory filters you must use are tkt_sei_metabox_location and tkt_sei_notify_on_role_visit.
Read more in the below FAQs.

How to modify the email “About”?

You can use the filter tkt_sei_email_subject in order to customize the “About” of the Email sent.
You just need to return a valid Email “About” (string) in the callback function:

add_filter('tkt_sei_email_subject', 'my_custom_email_subject');
function my_custom_email_subject(){

    $subject ='My Custom About';

    return $subject;

}

How to modify the email “Body”?

You can use the filter tkt_sei_notification_content in order to customize the “Body” of the Email sent.
You just need to return a valid Email “Body” (string or html with inline CSS) in the callback function:
The Filter passes 3 additional arguments for your convenience.

add_filter('tkt_sei_notification_content', 'my_custom_notification_content', 10, 4);
function my_custom_notification_content($default_message, $post, $current_user, $receiver_email){

    //$post is the Post Object of the post which was visited.
    //$current_user is the User Object of the user who visited the post. Might be empty, if guest user.
    //$receiver_email is the email stored to the post visited (the email that will get the notification).

    $default_message = 'My new Custom Notification Content with <strong>valid HTML</strong>';

    return $default_message;

}

How to modify the email “To” (Receiver)?

You can use the filter tkt_sei_receiver_email in order to customize the “To” (Receiver) of the Email sent.
You just need to return a valid Email address in the callback function:

add_filter('tkt_sei_receiver_email', 'my_custom_receiver_email');
function my_custom_receiver_email(){

    $email = 'custom@receiver.com';

    return $email;

}

How can I control where the Metabox appears, and which posts should be observed/triggering the email?

You can use the filter tkt_sei_metabox_location in order to customize the “Location” where the metabox will appear.
In other words, with this filter you can decide on what Post Types you will want the plugin functionality active.
You just need to return an array of valid Post Types in the callback function:

add_filter('tkt_sei_metabox_location', 'my_custom_metabox_location');
function my_custom_metabox_location(){

    $posts = array('post', 'page');//Array of post Types where the functionality shoud be active.

    return $posts;

}

How can I control what users (visitors) trigger the email?

You can use the filter tkt_sei_notify_on_role_visit in order to customize the “Visitor” Role that should trigger the email.
In other words, this allows you to determine what User Roles will actually trigger the emails, when an user of such role visits a post which is observed.
The filter expects an array of valid User Roles.
Pass 0 (int) if you want guests to trigger emails.
Empty array (default) triggers no email at all.

add_filter('tkt_sei_notify_on_role_visit', 'my_custom_notify_on_role_visit');
function my_custom_notify_on_role_visit(){

    $role = array( 'administrator', 0, 'subscriber' );// it sends the email if a user with role administrator, or subscriber, or even a guest is visiting.

    return $role;

}