Source View: wp_mail_failed

To save our bandwidth, we show only a snippet of code around each occurence of the hook. View complete file in SVN (without highlighting).

Understanding Source Code

The best way to understand what a hook does is to look at where it occurs in the source code.

  • Action hooks look like this: do_action( "hook_name" )
  • Filter hooks look like this: apply_filters( "hook_name", "what_to_filter" ).

Remember, this hook may occur in more than one file. Moreover, the hook's context may change from version to version.

Source View

This hook occurs 2 times in this file.

Line Code
354      $from_name = apply_filters( 'wp_mail_from_name', $from_name );
355
356      try {
357           $phpmailer->setFrom( $from_email, $from_name, false );
358      } catch ( phpmailerException $e ) {
359           $mail_error_data = compact( 'to', 'subject', 'message', 'headers', 'attachments' );
360           $mail_error_data['phpmailer_exception_code'] = $e->getCode();
361
362           /** This filter is documented in wp-includes/pluggable.php */
363           do_action( 'wp_mail_failed', new WP_Error( 'wp_mail_failed', $e->getMessage(), $mail_error_data ) );
364
365           return false;
366      }
367
368      // Set mail's subject and body
369      $phpmailer->Subject = $subject;
370      $phpmailer->Body    = $message;
371
372      // Set destination addresses, using appropriate methods for handling addresses
 
Line Code
486
487           /**
488            * Fires after a phpmailerException is caught.
489            *
490            * @since 4.4.0
491            *
492            * @param WP_Error $error A WP_Error object with the phpmailerException message, and an array
493            *                        containing the mail recipient, subject, message, headers, and attachments.
494            */
495           do_action( 'wp_mail_failed', new WP_Error( 'wp_mail_failed', $e->getMessage(), $mail_error_data ) );
496
497           return false;
498      }
499 }
500 endif;
501
502 if ( !function_exists('wp_authenticate') ) :
503 /**
504  * Authenticate a user, confirming the login credentials are valid.