adding doc for the sitewide options I added last night

git-svn-id: https://svn.code.sf.net/p/squirrelmail/code/trunk/squirrelmail@6374 7612ce4b-ef26-0410-bec9-ea0150e637f0

diff --git a/ChangeLog b/ChangeLog
index b5822703b86972f61e609de9edaa68e5a2518e98..7099b341992270b44b69ab4aa2cd01ca1737cd10 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -113,6 +113,7 @@ Version 1.5.0 -- CVS
   - Fix again for Internet Explorer's stupidity of decoding characters, then
     executing it blindly. See http://www.securityfocus.com/archive/1/340118.
   - Replaced obsolate 2mbit.com RBL with ahbl.org RBL. Bug.No.829887
   - Fix again for Internet Explorer's stupidity of decoding characters, then
     executing it blindly. See http://www.securityfocus.com/archive/1/340118.
   - Replaced obsolate 2mbit.com RBL with ahbl.org RBL. Bug.No.829887

+  - Added a sitewide override for authenticated SMTP - see authentication.txt.

   - Fixed sorting of sent_subfolders.
     Sent_subfolder plugin is hooked to special_mailbox hook.
 
   - Fixed sorting of sent_subfolders.
     Sent_subfolder plugin is hooked to special_mailbox hook.
 

diff --git a/doc/authentication.txt b/doc/authentication.txt
index d58e389548c5d839d2fb16a0c2b6b02d408e904f..40dbee220b47e160861a923a6ec191b6f8134309 100644 (file)
--- a/doc/authentication.txt
+++ b/doc/authentication.txt
@@ -81,4 +81,26 @@ To get the challenge with SMTP:
        QUIT
        [server says bye, closes connection]
 
        QUIT
        [server says bye, closes connection]
 

+
+OPTIONAL SMTP AUTH CONFIGURATION
+--------------------------------
+
+If you need all users to send mail via an upstream SMTP provider
+(your ISP, for example), and that ISP requires authentication,
+there are two variables that can be added to config_local.php
+that will specify a sitewide SMTP username and password.
+
+Set up SMTP authentication to the remote server according to the 
+instructions above, then add the following to config_local.php, 
+replacing <smtp_user> and <smtp_pass> with the username and password
+you'd like to use for the entire site:
+
+  $smtp_sitewide_user = '<smtp_user>';
+  $smtp_sitewide_pass = '<smtp_pass>';
+
+These values will be used to connect to the SMTP server as long
+as the authentication mechanism is something besides 'none', i.e.
+'login','plain','cram-md5', or 'digest-md5'.
+
+

 [End]
 [End]