TukuToi Contact Form

tkt_cntct_frm_email. Allows to modify the receveir email of a Contact form. Defaults to get_bloginfo( 'admin_email' ). Second argument passed is the Form ID.

add_filter( 'tkt_cntct_frm_email', 'special_receiver', 10, 2 );
function special_receiver( $email, $id ){
    if( (int)$id === 1 ){// If your Form ID is 1
        return '[email protected]';
    } else {
        return '[email protected]';
    }
}

tkt_cntct_frm_from. Allows to modify the “from” email header of a the email sent. Defaults to get_bloginfo( 'name' ). Second argument passed is the Form ID.

add_filter( 'tkt_cntct_frm_from', 'special_header_from', 10, 2 );
function special_header_from( $from, $id ){
    if( (int)$id === 1 ){// If your Form ID is 1
        return 'A prospect';
    } else {
        return $from;
    }
}

tkt_cntct_frm_subject. Allows to modify the Subject passed in the Form. This subject is appended to the Footer of the Email. Second argument are ALL the form fields (array). Form ID is part of the form fields. Third argument is the receiver Email.

add_filter( 'tkt_cntct_frm_subject', 'special_subject', 10, 3 );
function special_subject( $subject, $form_fields, $receiver ){
    if( $form_fields['id'] === 'my-contact-form' ){// If your Form ID is my-contact-form
        return 'Custom Subject';
    } else {
        return $subject;
    }
}

tkt_cntct_frm_internal_subject. Allows to modify the Subject in the sent mail Header. This subject is the one you see in the “From” of the email you will receive when this Contact Form is submitted. Second argument are ALL the form fields (array). Form ID is part of the form fields. Third argument is the receiver Email.

add_filter( 'tkt_cntct_frm_internal_subject', 'special_internal_subject', 10, 3 );
function special_internal_subject( $subject, $form_fields, $receiver ){
    if( $form_fields['id'] === 'my-contact-form' ){// If your Form ID is my-contact-form
        return 'You have new mail';
    } else {
        return $subject;
    }
}

tkt_cntct_frm_message. Allows to modify (or append to) the Message of email sent. Second argument are ALL the form Fields (array). Form ID is part of the form fields. Third argument is the receiver Email.

add_filter('tkt_cntct_frm_message', 'append_to_message', 10, 3);
function append_to_message( $message, $form_fields, $receiver ){
    if( $form_fields['id'] === 'my-contact-form' ){// If your form is ID my-contact-form
        return $message . '<p>appended string</p>';
    } elseif( $receiver === '[email protected]' ){
      return 'overwrite the entire message';
    } else{
        return $message;
    }

}

tkt_cntct_frm_redirect_uri. Allows to filter the Redirect URL. Defaults to current page with ?success=true appended on success. Second argument passed is Form ID.

add_filter('tkt_cntct_frm_redirect_uri', 'redirect_url', 10, 2);
function redirect_url( $redirect, $id ){
    if( $id === 'my-contact-form' ){// If your form is ID my-contact-form
        return 'https://custom.url/thing';
    } else{
        return $redirect;
    }

}

tkt_cntct_frm_ip. Allows to filter the IP Address appended to the email body (useful to remove it, for example). Second argument passed is Form ID.

add_filter('tkt_cntct_frm_ip', 'filter_ip', 10, 2);
function filter_ip( $ip, $id ){
    if( $id === 'my-contact-form' ){// If your form is ID my-contact-form
        return '';// remove IP alltogether.
    } else {
        return $ip;
    }
}

tkt_cntct_frm_send_confirmation. Allows to stop the Confirmation Email from being sent. Second argument passed is Form ID.

add_filter('tkt_cntct_frm_send_confirmation', 'stop_confirmation', 10, 2);
function filter_ip( $ip, $id ){
    if( $id === 'my-contact-form' ){// If your form is ID my-contact-form
        return false;// stop email.
    } else {
        return true;
    }
}

tkt_cntct_frm_confirmation_message. Allows to change the Confirmation Email Text. Defaults to We have received your message and will reply soon. For the records, this was your message: Second argument passed is Form ID.
NOTE: The Message the prospect sent in the form is always appended in a separate paragraph.
NOTE: all filters applied to From/Receiver, Subjects, and form message are applied to this email as well.

add_filter('tkt_cntct_frm_confirmation_message', 'confirmation_message', 10, 2);
function filter_ip( $message, $id ){
    if( $id === 'my-contact-form' ){// If your form is ID my-contact-form
        return 'We will reply to you. This is your message:';// stop email.
    }
    else {
        return $message;
    }
}

tkt_cntct_frm_pre_send_mail. Action fired right before the mail is sent. Second argument all form fields. Helpful to do things before the mail is sent…

add_action( 'tkt_cntct_frm_pre_send_mail', 'pre_send_mail', 10, 1 );
function pre_send_mail($form_fields){
    if($form_fields['id'] === 'my-contact-form'){
        wp_mail( '[email protected]', 'new mail', 'someone is about to send an email with your contact form' );
    }
}

tkt_cntct_frm_post_send_mail. Action fired right after the email is sent. Arguments include $receiver, $email_subject, $email_message, $headers, $form_fields. Helpful to for example send another email to another place, after the mail was sent. Or whatever, abort the script, if you like.

add_action( 'tkt_cntct_frm_post_send_mail', 'post_send_mail', 10, 5 );
function post_send_mail($receiver, $email_subject, $email_message, $headers, $form_fields){
    if($form_fields['id'] === 'my-contact-form'){
        wp_mail( '[email protected]', 'new mail', 'someone has sent an email with your contact form' );
    }
}

tkt_cntct_frm_pre_redirect. Action fired right before the wp_redirect is fired. Arguments are $redirect_url, $form_id

add_action( 'tkt_cntct_frm_pre_redirect', 'pre_redirect', 10, 2 );
function pre_redirect($redirect_url, $form_id){
    if($form_id === 'my-contact-form'){
        wp_redirect( 'https://wherever.com' );
        exit;
    }
}

tkt_cntct_frm_post_redirect. Action fired right after the wp_redirect is fired. No arguments.

add_action( 'tkt_cntct_frm_post_redirect', 'post_redirect', 10 );
function post_redirect(){
    wp_mail( '[email protected]', 'new mail', 'someone has sent an email with your contact form and everything went well, they where redirected to your target url' );
}

The Form is built with native HTML and minimal markup, so you can apply whatever styles you want in general.
The few classes and IDs passed have all a tkt- prefix.
Available classes and IDs:

• tkt-contact-form. Class for the form HTML attribute.
• Form ID is the ID you pass to the ShortCode id attribute.
• Each input has an error class set when failing validaton: tkt-missing-or-invalid
• Honeypot fields are usually not to be styled further, but who knows you might need to access them, they use class tkt-ohnohoney

Note that Plugin CSS (and JS) are enqueued only when the ShortCode is added to a page/post. For this reason scripts are added to the footer.