modules/phpmailer/README.txt

/* $Id: README.txt,v 1.9 2009/10/12 19:44:43 smk Exp $ */

-- SUMMARY --

Adds SMTP support for sending e-mails using the PHPMailer library.

For a full description of the module, visit the project page:
  http://drupal.org/project/phpmailer
To submit bug reports and feature suggestions, or to track changes:
  http://drupal.org/project/issues/phpmailer


-- REQUIREMENTS --

* Access to an SMTP server

* Libraries API module
  http://drupal.org/project/libraries

* PHPMailer for PHP5/6
  http://phpmailer.codeworxtech.com

Optional:

* To connect to an SMTP server using SSL, your PHP installation needs to have
  OpenSSL support.

* Mime Mail module to send HTML e-mails
  http://drupal.org/project/mimemail

* Personalized E-mails module to adjust the displayed sender name
  http://drupal.org/project/pmail


-- INSTALLATION --

1. Download PHPMailer for PHP5/6 from

     http://sourceforge.net/projects/phpmailer/files/phpmailer%20for%20php5_6/

   and extract the following files to the phpmailer subdirectory of your
   libraries directory:

     class.phpmailer.php
     class.smtp.php

   Be careful NOT to extract the path names contained in the archive.

   It is recommended that you create your libraries directory at one of the
   following locations:

     sites/all/libraries
     sites/<domain>/libraries

   Consult the Libraries API documentation for further information.

2. Install as usual, see http://drupal.org/node/70151 for further information.


-- CONFIGURATION --

* Configure user permissions at Administer >> User management >> Access control
  >> phpmailer module.

  Only users with the "administer phpmailer settings" permission will gain
  access to the module configuration page.

* When not using the optional Mime Mail module, customize module settings at
  Administer >> Site configuration >> PHPMailer.

  If used in conjunction with Mime Mail, PHPMailer will show up as an e-mail
  engine in the Mime Mail module settings.  Note that there will be no separate
  PHPMailer configuration page in this case.

* Using Google Mail as SMTP server

  To send e-mails with Google Mail use the following settings:

    SMTP server:     smtp.gmail.com
    SMTP port:       465
    Secure protocol: SSL
    Username:        your_google_mail_name@gmail.com
    Password:        your_google_mail_password

  Note however, that Google automatically rewrites the "from" line of any e-mail
  you send via their SMTP gateway to your Google Mail address.  Also note the
  sending limits [1] for Google Mail accounts.

  [1] http://mail.google.com/support/bin/answer.py?hl=en&answer=22839

* Debug settings

  PHPMailer supports rerouting all e-mails for debugging purposes, so you don't
  accidentally send e-mails to your users from a development site.  To enable
  this feature, add the following lines to the end of your settings.php (usually
  located in sites/default):

    $conf = array(
      'phpmailer_debug_email' => 'your_debug_email@yoursite.com',
    );

  This will change the recipient of all e-mails to the configured address.


-- CREDITS --

Authors:
* Stefan M. Kudwien (smk-ka) - http://drupal.org/user/48898
* Daniel F. Kudwien (sun) - http://drupal.org/user/54136

This project has been sponsored by UNLEASHED MIND
Specialized in consulting and planning of Drupal powered sites, UNLEASHED
MIND offers installation, development, theming, customization, and hosting
to get you started. Visit http://www.unleashedmind.com for more information.

1	/* $Id: README.txt,v 1.9 2009/10/12 19:44:43 smk Exp $ */
2
3	-- SUMMARY --
4
5	Adds SMTP support for sending e-mails using the PHPMailer library.
6
7	For a full description of the module, visit the project page:
8	http://drupal.org/project/phpmailer
9	To submit bug reports and feature suggestions, or to track changes:
10	http://drupal.org/project/issues/phpmailer
11
12
13	-- REQUIREMENTS --
14
15	* Access to an SMTP server
16
17	* Libraries API module
18	http://drupal.org/project/libraries
19
20	* PHPMailer for PHP5/6
21	http://phpmailer.codeworxtech.com
22
23	Optional:
24
25	* To connect to an SMTP server using SSL, your PHP installation needs to have
26	OpenSSL support.
27
28	* Mime Mail module to send HTML e-mails
29	http://drupal.org/project/mimemail
30
31	* Personalized E-mails module to adjust the displayed sender name
32	http://drupal.org/project/pmail
33
34
35	-- INSTALLATION --
36
37	1. Download PHPMailer for PHP5/6 from
38
39	http://sourceforge.net/projects/phpmailer/files/phpmailer%20for%20php5_6/
40
41	and extract the following files to the phpmailer subdirectory of your
42	libraries directory:
43
44	class.phpmailer.php
45	class.smtp.php
46
47	Be careful NOT to extract the path names contained in the archive.
48
49	It is recommended that you create your libraries directory at one of the
50	following locations:
51
52	sites/all/libraries
53	sites/<domain>/libraries
54
55	Consult the Libraries API documentation for further information.
56
57	2. Install as usual, see http://drupal.org/node/70151 for further information.
58
59
60	-- CONFIGURATION --
61
62	* Configure user permissions at Administer >> User management >> Access control
63	>> phpmailer module.
64
65	Only users with the "administer phpmailer settings" permission will gain
66	access to the module configuration page.
67
68	* When not using the optional Mime Mail module, customize module settings at
69	Administer >> Site configuration >> PHPMailer.
70
71	If used in conjunction with Mime Mail, PHPMailer will show up as an e-mail
72	engine in the Mime Mail module settings. Note that there will be no separate
73	PHPMailer configuration page in this case.
74
75	* Using Google Mail as SMTP server
76
77	To send e-mails with Google Mail use the following settings:
78
79	SMTP server: smtp.gmail.com
80	SMTP port: 465
81	Secure protocol: SSL
82	Username: your_google_mail_name@gmail.com
83	Password: your_google_mail_password
84
85	Note however, that Google automatically rewrites the "from" line of any e-mail
86	you send via their SMTP gateway to your Google Mail address. Also note the
87	sending limits [1] for Google Mail accounts.
88
89	[1] http://mail.google.com/support/bin/answer.py?hl=en&answer=22839
90
91	* Debug settings
92
93	PHPMailer supports rerouting all e-mails for debugging purposes, so you don't
94	accidentally send e-mails to your users from a development site. To enable
95	this feature, add the following lines to the end of your settings.php (usually
96	located in sites/default):
97
98	$conf = array(
99	'phpmailer_debug_email' => 'your_debug_email@yoursite.com',
100	);
101
102	This will change the recipient of all e-mails to the configured address.
103
104
105	-- CREDITS --
106
107	Authors:
108	* Stefan M. Kudwien (smk-ka) - http://drupal.org/user/48898
109	* Daniel F. Kudwien (sun) - http://drupal.org/user/54136
110
111	This project has been sponsored by UNLEASHED MIND
112	Specialized in consulting and planning of Drupal powered sites, UNLEASHED
113	MIND offers installation, development, theming, customization, and hosting
114	to get you started. Visit http://www.unleashedmind.com for more information.
115