chamilo-lms/main/inc/lib/mail.lib.inc.php

<?php
/* For licensing terms, see /license.txt */

require_once api_get_path(LIBRARY_PATH).'phpmailer/class.phpmailer.php';
require_once api_get_path(CONFIGURATION_PATH).'mail.conf.php';

//regular expression to test for valid email address
// this should actually be revised to use the complete RFC3696 description
// http://tools.ietf.org/html/rfc3696#section-3
$regexp_rfc3696 = "^[0-9a-z_\.+-]+@(([0-9]{1,3}\.){3}[0-9]{1,3}|([0-9a-z][0-9a-z-]*[0-9a-z]\.)+[a-z]{2,3})$";

/**
 * Sends email using the phpmailer class
 * Sender name and email can be specified, if not specified
 * name and email of the platform admin are used
 *
 * @author Bert Vanderkimpen ICT&O UGent
 *
 * @param recipient_name   	name of recipient
 * @param recipient_email  	email of recipient
 * @param message           email body
 * @param subject           email subject
 * @return                  returns true if mail was sent
 * @see                     class.phpmailer.php
 */
function api_mail($recipient_name, $recipient_email, $subject, $message, $sender_name="", $sender_email="", $extra_headers="") {

	global $regexp_rfc3696;
	global $platform_email;

	$mail = new PHPMailer();
	$mail->Mailer  = $platform_email['SMTP_MAILER'];
	$mail->Host    = $platform_email['SMTP_HOST'];
	$mail->Port    = $platform_email['SMTP_PORT'];
	$mail->CharSet = $platform_email['SMTP_CHARSET'];
	$mail->WordWrap = 200; // stay far below SMTP protocol 980 chars limit

	if($platform_email['SMTP_AUTH'])
	{
		$mail->SMTPAuth = 1;
		$mail->Username = $platform_email['SMTP_USER'];
		$mail->Password = $platform_email['SMTP_PASS'];
	}

	$mail->Priority = 3; // 5=low, 1=high
	$mail->AddCustomHeader("Errors-To: ".$platform_email['SMTP_FROM_EMAIL']."");
	$mail->IsHTML(0);
	$mail->SMTPKeepAlive = true;

	// attachments
	// $mail->AddAttachment($path);
	// $mail->AddAttachment($path,$filename);

	if ($sender_email!="")
	{
		$mail->From         = $sender_email;
		$mail->Sender       = $sender_email;
		//$mail->ConfirmReadingTo = $sender_email; //Disposition-Notification
	}
	else
	{
		$mail->From         = $platform_email['SMTP_FROM_EMAIL'];
		$mail->Sender       = $platform_email['SMTP_FROM_EMAIL'];
		//$mail->ConfirmReadingTo = $platform_email['SMTP_FROM_EMAIL']; //Disposition-Notification
	}

	if ($sender_name!="")
	{
		$mail->FromName = $sender_name;
	}
	else
	{
		$mail->FromName = $platform_email['SMTP_FROM_NAME'];
	}
	$mail->Subject = $subject;
	$mail->Body    = $message;

	//only valid address
	if(eregi( $regexp_rfc3696, $recipient_email ))
	{
		$mail->AddAddress($recipient_email, $recipient_name);
	}

	if ($extra_headers != ""){
		$mail->AddCustomHeader($extra_headers);
	}

	//send mail
	if (!$mail->Send())
	{
		//echo "ERROR: mail not sent to ".$recipient_name." (".$recipient_email.") because of ".$mail->ErrorInfo."<br>";
		return 0;
	}

	// Clear all addresses
	$mail->ClearAddresses();
	return 1;
}

/**
 * Sends an HTML email using the phpmailer class (and multipart/alternative to downgrade gracefully)
 * Sender name and email can be specified, if not specified
 * name and email of the platform admin are used
 *
 * @author Bert Vanderkimpen ICT&O UGent
 * @author Yannick Warnier <yannick.warnier@beeznest.com>
 *
 * @param string    name of recipient
 * @param string    email of recipient
 * @param string    email subject
 * @param string    email body
 * @param string    sender name
 * @param string    sender e-mail
 * @param array     extra headers in form $headers = array($name => $value) to allow parsing
 * @param array     data file (path and filename)
 * @param array     data to attach a file (optional)
 * @param bool      True for attaching a embedded file inside content html (optional)
 * @return          returns true if mail was sent
 * @see             class.phpmailer.php
 */
function api_mail_html($recipient_name, $recipient_email, $subject, $message, $sender_name = "", $sender_email = "", $extra_headers = null, $data_file = array(), $embedded_image = false) {

	global $regexp_rfc3696;
	global $platform_email;

	$mail = new PHPMailer();
	$mail->Mailer  = $platform_email['SMTP_MAILER'];
	$mail->Host    = $platform_email['SMTP_HOST'];
	$mail->Port    = $platform_email['SMTP_PORT'];
	$mail->CharSet = $platform_email['SMTP_CHARSET'];
	$mail->WordWrap = 200; // stay far below SMTP protocol 980 chars limit

	if ($platform_email['SMTP_AUTH']) {
		$mail->SMTPAuth = 1;
		$mail->Username = $platform_email['SMTP_USER'];
		$mail->Password = $platform_email['SMTP_PASS'];
	}

	$mail->Priority = 3; // 5=low, 1=high
	$mail->AddCustomHeader("Errors-To: ".$platform_email['SMTP_FROM_EMAIL']."");
	$mail->IsHTML(0);
	$mail->SMTPKeepAlive = true;

	if (($sender_email != "") && ($sender_name != "")) {
		$mail->AddReplyTo ($sender_email,$sender_name);
	}

	// attachments
	// $mail->AddAttachment($path);
	// $mail->AddAttachment($path,$filename);

	if ($sender_email!="") {
		$mail->From         = $sender_email;
		$mail->Sender       = $sender_email;
		//$mail->ConfirmReadingTo = $sender_email; //Disposition-Notification
	} else {
		$mail->From         = $platform_email['SMTP_FROM_EMAIL'];
		$mail->Sender       = $platform_email['SMTP_FROM_EMAIL'];
		//$mail->ConfirmReadingTo = $platform_email['SMTP_FROM_EMAIL']; //Disposition-Notification
	}

	if ($sender_name!="") {
		$mail->FromName = $sender_name;
	} else {
		$mail->FromName = $platform_email['SMTP_FROM_NAME'];
	}
	$mail->Subject = $subject;

	$mail->AltBody = strip_tags(str_replace('<br />',"\n", api_html_entity_decode($message)));

        // send embedded image
        if ($embedded_image) {
           // get all images html inside content
           preg_match_all("/<img\s+.*?src=[\"\']?([^\"\' >]*)[\"\']?[^>]*>/i",$message,$m);
           // prepare new tag images
           $new_images_html = array();
           $i = 1;
           if (!empty($m[1])) {
               foreach ($m[1] as $image_path) {
                   $real_path = realpath($image_path);
                   $filename  = basename($image_path);
                   $image_cid = $filename.'_'.$i;
                   $encoding = 'base64';
                   $image_type = mime_content_type($real_path);
                   $mail->AddEmbeddedImage($real_path, $image_cid, $filename, $encoding, $image_type);
                   $new_images_html[] = '<img src="cid:'.$image_cid.'" />';
                   $i++;
               }
           }
           // replace origin image for new embedded image html
           $x = 0;
           if (!empty($m[0])) {
               foreach ($m[0] as $orig_img) {
                   $message = str_replace($orig_img, $new_images_html[$x], $message);
                   $x++;
               }
           }
        }

	$mail->Body = '<html><head></head><body>'.$message.'</body></html>';

	// attachment ...
	if (!empty($data_file)) {
		$mail->AddAttachment($data_file['path'], $data_file['filename']);
	}

	// only valid address
	if(is_array($recipient_email)) {
		foreach($recipient_email as $dest) {
			if(eregi( $regexp_rfc3696, $dest )) {
				$mail->AddAddress($dest, $recipient_name);
				//$mail->AddAddress($dest, ($i>1?'':$recipient_name));
			}
		}
	} else {
		if(eregi( $regexp_rfc3696, $recipient_email ))
		{
			$mail->AddAddress($recipient_email, $recipient_name);
		} else {
			return 0;
		}
	}

	if (is_array($extra_headers) && count($extra_headers)>0){
		foreach($extra_headers as $key=>$value)
		{
			switch(strtolower($key)){
				case 'encoding':
				case 'content-transfer-encoding':
					$mail->Encoding = $value;
					break;
				case 'charset':
					$mail->Charset = $value;
					break;
				case 'contenttype':
				case 'content-type':
					$mail->ContentType = $value;
					break;
				default:
					$mail->AddCustomHeader($key.':'.$value);
					break;
			}
		}
	}

	// WordWrap the html body (phpMailer only fixes AltBody) FS#2988
	$mail->Body = $mail->WrapText($mail->Body, $mail->WordWrap);

	//send mail
	if (!$mail->Send())
	{
		//echo "ERROR: mail not sent to ".$recipient_name." (".$recipient_email.") because of ".$mail->ErrorInfo."<br>";
		return 0;
	}

	// Clear all addresses
	$mail->ClearAddresses();
	return 1;
}

?>