Add analytics
[bus.git] / busui / owa / includes / PHPMailer_v2.0.3 / README
blob:a/busui/owa/includes/PHPMailer_v2.0.3/README -> blob:b/busui/owa/includes/PHPMailer_v2.0.3/README
--- a/busui/owa/includes/PHPMailer_v2.0.3/README
+++ b/busui/owa/includes/PHPMailer_v2.0.3/README
@@ -1,1 +1,170 @@
+/*******************************************************************

+* The http://phpmailer.codeworxtech.com/ website now carries a few *

+* advertisements through the Google Adsense network. Please visit  *

+* the advertiser sites and help us offset some of our costs.       *

+* Thanks ....                                                      *

+********************************************************************/

+

+PHPMailer

+Full Featured Email Transfer Class for PHP

+==========================================

+

+Version 2.3 (November 08, 2008)

+

+PHP4 continues to be a major platform for developers. We are responding

+to the emails received to continue development for PHP4 with this 

+release.

+

+We have removed the /phpdoc from the downloads. All documentation is now on

+the http://phpmailer.codeworxtech.com website.

+

+For all other changes and notes, please see the changelog.

+

+Donations are accepted at PayPal with our id "paypal@worxteam.com".

+

+Version 2.2 (July 15 2008)

+

+- see the changelog.

+

+Version 2.0.2 (June 04 2008)

+

+With this release, we are announcing that the development of PHPMailer for PHP5

+will be our focus from this date on. We have implemented all the enhancements

+and fixes from the sourceforge.net Tracker.

+

+** NOTE: WE HAVE A NEW LANGUAGE VARIABLE FOR DIGITALLY SIGNED S/MIME EMAILS.

+   IF YOU CAN HELP WITH LANGUAGES OTHER THAN ENGLISH AND SPANISH, IT WOULD BE

+   APPRECIATED.

+

+We have now added S/MIME functionality (ability to digitally sign emails).

+BIG THANKS TO "sergiocambra" for posting this patch back in November 2007.

+The "Signed Emails" functionality adds the Sign method to pass the private key

+filename and the password to read it, and then email will be sent with

+content-type multipart/signed and with the digital signature attached.

+

+We have also included more example files to show the use of "sendmail", "mail()",

+"smtp", and "gmail".

+

+We are also looking for more programmers to join the volunteer development team.

+If you have an interest in this, please let us know.

+

+Enjoy!

+

+** NOTE:

+

+As of November 2007, PHPMailer has a new project team headed by industry

+veteran Andy Prevost (codeworxtech). The first release in more than two

+years will focus on fixes, adding ease-of-use enhancements, provide

+basic compatibility with PHP4 and PHP5 using PHP5 backwards compatibility

+features. A new release is planned before year-end 2007 that will provide

+full compatiblity with PHP4 and PHP5, as well as more bug fixes.

+

+We are looking for project developers to assist in restoring PHPMailer to

+its leadership position. Our goals are to simplify use of PHPMailer, provide

+good documentation and examples, and retain backward compatibility to level

+1.7.3 standards.

+

+If you are interested in helping out, visit http://sourceforge.net/projects/phpmailer

+and indicate your interest.

+

+**

+

+http://phpmailer.sourceforge.net/

+

+This software is licenced under the LGPL.  Please read LICENSE for information on the

+software availability and distribution.

+

+Class Features:

+- Send emails with multiple TOs, CCs, BCCs and REPLY-TOs

+- Redundant SMTP servers

+- Multipart/alternative emails for mail clients that do not read HTML email

+- Support for 8bit, base64, binary, and quoted-printable encoding

+- Uses the same methods as the very popular AspEmail active server (COM) component

+- SMTP authentication

+- Native language support

+- Word wrap, and more!

+

+Why you might need it:

+

+Many PHP developers utilize email in their code.  The only PHP function

+that supports this is the mail() function.  However, it does not expose

+any of the popular features that many email clients use nowadays like

+HTML-based emails and attachments. There are two proprietary

+development tools out there that have all the functionality built into

+easy to use classes: AspEmail(tm) and AspMail.  Both of these

+programs are COM components only available on Windows.  They are also a

+little pricey for smaller projects.

+


+So I built a version myself that implements the same methods (object

+calls) that the Windows-based components do. It is open source and the

+LGPL license allows you to place the class in your proprietary PHP

+projects.

+

+

+Installation:

+

+Copy class.phpmailer.php into your php.ini include_path. If you are

+using the SMTP mailer then place class.smtp.php in your path as well.

+In the language directory you will find several files like

+phpmailer.lang-en.php.  If you look right before the .php extension

+that there are two letters.  These represent the language type of the

+translation file.  For instance "en" is the English file and "br" is

+the Portuguese file.  Chose the file that best fits with your language

+and place it in the PHP include path.  If your language is English

+then you have nothing more to do.  If it is a different language then

+you must point PHPMailer to the correct translation.  To do this, call

+the PHPMailer SetLanguage method like so:

+

+// To load the Portuguese version

+$mail->SetLanguage("br", "/optional/path/to/language/directory/");

+

+That's it.  You should now be ready to use PHPMailer!

+

+

+A Simple Example:

+

+<?php

+require("class.phpmailer.php");

+

+$mail = new PHPMailer();

+

+$mail->IsSMTP();                                      // set mailer to use SMTP

+$mail->Host = "smtp1.example.com;smtp2.example.com";  // specify main and backup server

+$mail->SMTPAuth = true;     // turn on SMTP authentication

+$mail->Username = "jswan";  // SMTP username

+$mail->Password = "secret"; // SMTP password

+

+$mail->From = "from@example.com";

+$mail->FromName = "Mailer";

+$mail->AddAddress("josh@example.net", "Josh Adams");

+$mail->AddAddress("ellen@example.com");                  // name is optional

+$mail->AddReplyTo("info@example.com", "Information");

+

+$mail->WordWrap = 50;                                 // set word wrap to 50 characters

+$mail->AddAttachment("/var/tmp/file.tar.gz");         // add attachments

+$mail->AddAttachment("/tmp/image.jpg", "new.jpg");    // optional name

+$mail->IsHTML(true);                                  // set email format to HTML

+

+$mail->Subject = "Here is the subject";

+$mail->Body    = "This is the HTML message body <b>in bold!</b>";

+$mail->AltBody = "This is the body in plain text for non-HTML mail clients";

+

+if(!$mail->Send())

+{

+   echo "Message could not be sent. <p>";

+   echo "Mailer Error: " . $mail->ErrorInfo;

+   exit;

+}

+

+echo "Message has been sent";

+?>

+

+CHANGELOG

+

+See ChangeLog.txt

+

+Download: http://sourceforge.net/project/showfiles.php?group_id=26031

+

+Andy Prevost