2 /*=====================================================================*\
3 || ###################################################################
4 || # Iris Studios Shared Object Framework [#]version[#]
5 || # Copyright ©2002-[#]year[#] Iris Studios, Inc.
7 || # This program is free software; you can redistribute it and/or modify
8 || # it under the terms of the GNU General Public License as published by
9 || # the Free Software Foundation; version [#]gpl[#] of the License.
11 || # This program is distributed in the hope that it will be useful, but
12 || # WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
13 || # or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
16 || # You should have received a copy of the GNU General Public License along
17 || # with this program; if not, write to the Free Software Foundation, Inc.,
18 || # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
19 || ###################################################################
20 \*=====================================================================*/
29 $OBJECT = 'Mail Sender';
36 * This framework is a wrapper for the PHP mail function that properly
37 * sends mail with full email headers.
39 * @author Iris Studios, Inc.
40 * @copyright Copyright ©2002 - [#]year[#], Iris Studios, Inc.
48 * Framework registry object
54 * The message recipient's email address
60 * The subject of the message
72 * The message sender's email address
78 * The message sender's display name
84 * Additional message headers
92 function Mail(&$registry)
94 $this->registry
=& $registry;
98 * Sends an email to the specified address with the specified
99 * sender, subject, and body.
101 * @return bool Status of the message
107 if (!@ini_get('sendmail_path'))
109 $_isso->debug("email: no sendmail -> not sending");
113 $this->to
= $this->_fetch_first_line($this->to
);
114 $this->from
= $this->_fetch_first_line($this->from
);
118 $_isso->debug("email: no from -> not sending");
123 $this->from
= trim($_isso->unsanitize($this->from
, true
));
126 if (!$this->fromname
)
128 $this->fromname
= $this->from
;
132 $this->fromname
= trim($_isso->unsanitize($this->fromname
, true
));
137 $_isso->debug("email: no recipient -> not sending");
142 $this->to
= trim($_isso->unsanitize($this->to
));
147 $_isso->debug("email: no subject -> not sending");
152 $this->subject
= trim($_isso->unsanitize($this->_fetch_first_line($this->subject
), true
));
157 $_isso->debug("email: no body -> not sending");
162 $this->body
= $this->_convert_line_breaks($this->body
);
163 $this->body
= trim($_isso->unsanitize($this->body
, true
));
166 $this->headers
= $this->_convert_line_breaks($this->headers
);
167 $this->headers
.= "From: \"{$this->fromname}\" <{$this->from}>\n";
168 $this->headers
.= "Return-Path: {$this->from}\n";
169 $this->headers
.= "X-Mailer: ISSO Mail Framework \$Revision$\n";
170 $this->headers
.= "Content-Type: text/plain; charset=\"iso-8859-1\"\n";
171 $this->headers
.= "Content-Transfer-Encoding: 7bit\n";
173 if (mail($this->to
, $this->subject
, $this->body
, trim($this->headers
), "-f {$this->from}"))
175 $_isso->debug("email: sent -> good");
180 $_isso->debug("email: sent -> error");
186 * Fetches the first line of a string
188 * @param string A string
190 * @return string The first line of the string
192 function _fetch_first_line($string)
194 $string = $this->_convert_line_breaks($string);
195 $broken = explode("\n", $string);
200 * Changes line breaks into one format
203 * @param string New line break (default is UNIX format)
205 * @return string Text with one type of line break
207 function _convert_line_breaks($text, $convert_to = "\n")
210 $text = str_replace(array("\r\n", "\r", "\n"), "\n", $text);
211 $text = str_replace("\n", $convert_to, $text);
216 /*=====================================================================*\
217 || ###################################################################
220 || ###################################################################
221 \*=====================================================================*/