<?php
/*=====================================================================*\
|| ###################################################################
|| # Iris Studios Shared Object Framework [#]version[#]
|| # Copyright Š2002-[#]year[#] Iris Studios, Inc.
|| #
|| # This program is free software; you can redistribute it and/or modify
|| # it under the terms of the GNU General Public License as published by
|| # the Free Software Foundation; version [#]gpl[#] of the License.
|| #
|| # This program is distributed in the hope that it will be useful, but
|| # WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
|| # or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
|| # more details.
|| #
|| # You should have received a copy of the GNU General Public License along
|| # with this program; if not, write to the Free Software Foundation, Inc.,
|| # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
|| ###################################################################
\*=====================================================================*/

/**
* Mail Sender
* mail.php
*
* @package	ISSO
*/

/**
* Mail Sender
*
* This framework is a wrapper for the PHP mail function that properly
* sends mail with full email headers.
*
* @author		Iris Studios, Inc.
* @copyright	Copyright Š2002 - [#]year[#], Iris Studios, Inc.
* @version		$Revision$
* @package		ISSO
* 
*/
class Mail
{
	/**
	* Framework registry object
	* @var	object
	*/
	var $registry = null;
	
	/**
	* The message recipient's email address
	* @var	string
	*/
	var $to = '';
	
	/**
	* The subject of the message
	* @var	string
	*/
	var $subject = '';
	
	/**
	* Body of the message
	* @var	string
	*/
	var $body = '';
	
	/**
	* The message sender's email address
	* @var	string
	*/
	var $from = '';
	
	/**
	* The message sender's display name
	* @var	string
	*/
	var $fromname = '';
	
	/**
	* Additional message headers
	* @var	string
	*/
	var $headers = '';
	
	/**
	* Constructor
	*/
	function __construct(&$registry)
	{
		$this->registry =& $registry;
	}
	
	/**
	* (PHP 4) Constructor
	*/
	function Mail(&$registry)
	{
		$this->__construct($registry);
	}
	
	/**
	* Sends an email to the specified address with the specified
	* sender, subject, and body.
	*
	* @access	public
	*
	* @return	bool	Status of the message
	*/
	function send()
	{
		if (!@ini_get('sendmail_path'))
		{
			$this->registry->debug("email: no sendmail -> not sending");
			return false;
		}
		
		$this->to = $this->_fetch_first_line($this->to);
		$this->from = $this->_fetch_first_line($this->from);
		
		if (!$this->from)
		{
			$this->registry->debug("email: no from -> not sending");
			return false;
		}
		else
		{
			$this->from = trim($this->registry->unsanitize($this->from, true));
		}
		
		if (!$this->fromname)
		{
			$this->fromname = $this->from;
		}
		else
		{
			$this->fromname = trim($this->registry->unsanitize($this->fromname, true));
		}
		
		if (!$this->to)
		{
			$this->registry->debug("email: no recipient -> not sending");
			return false;
		}
		else
		{
			$this->to = trim($this->registry->unsanitize($this->to));
		}
		
		if (!$this->subject)
		{
			$this->registry->debug("email: no subject -> not sending");
			return false;
		}
		else
		{
			$this->subject = trim($this->registry->unsanitize($this->_fetch_first_line($this->subject), true));
		}
		
		if (!$this->body)
		{
			$this->registry->debug("email: no body -> not sending");
			return false;
		}
		else
		{
			$this->body = $this->_convert_line_breaks($this->body);
			$this->body = trim($this->registry->unsanitize($this->body, true));
		}
		
		$this->headers = $this->_convert_line_breaks($this->headers);
		$this->headers .= "From: \"{$this->fromname}\" <{$this->from}>\n";
		$this->headers .= "Return-Path: {$this->from}\n";
		$this->headers .= "X-Mailer: ISSO Mail Framework \$Revision$\n";
		$this->headers .= "Content-Type: text/plain; charset=\"iso-8859-1\"\n";
		$this->headers .= "Content-Transfer-Encoding: 7bit\n";
		
		if (mail($this->to, $this->subject, $this->body, trim($this->headers), "-f {$this->from}"))
		{
			$this->registry->debug("email: sent -> good");
			return true;
		}
		else
		{
			$this->registry->debug("email: sent -> error");
			return false;
		}
	}
	
	/**
	* Fetches the first line of a string
	*
	* @access	private
	*
	* @param	string	A string
	*
	* @return	string	The first line of the string
	*/
	function _fetch_first_line($string)
	{
		$string = $this->_convert_line_breaks($string);
		$broken = explode("\n", $string);
		return $broken[0];
	}
	
	/**
	* Changes line breaks into one format
	*
	* @access	private
	*
	* @param	string	Text
	* @param	string	New line break (default is UNIX format)
	*
	* @return	string	Text with one type of line break
	*/
	function _convert_line_breaks($text, $convert_to = "\n")
	{
		$text = trim($text);
		$text = str_replace(array("\r\n", "\r", "\n"), "\n", $text);
		$text = str_replace("\n", $convert_to, $text);
		return $text;
	}
}

/*=====================================================================*\
|| ###################################################################
|| # $HeadURL$
|| # $Id$
|| ###################################################################
\*=====================================================================*/
?>