DragonflyMail is an email client written in PHP.
Copyright (C) 2000 Dragonfly Technologies, 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; either version 2 of the License, or (at your 
option) any later version. 

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., 59
Temple Place - Suite 330, Boston, MA 02111-1307, USA



I. Installing Dragonfly Mail

   Requirements:
       PHP4RC1 with imap support
       smtp daemon running on your web server
       imap daemon running on your web server

   Instructions:
      1. Install PHP4.0.0 or better (www.php.net) according to the directions
      2. Install SSL if desired
         Note - This is not required, but it does make the email more secure.
      3. Unpack the DragonFlyMail archive into a directory that is shared
         under your web server.
 
         An example (FreeBSD, Linux, or other UNIX like operating system)

         Assumes your web root is /www

         yourBOX% cd /www
         yourBOX% mkdir webmail
         yourBOX% cd webmail
         yourBOX% cp /home/you/dragonflymail-X.X.tar.gz .
         yourBOX% tar -xzf dragonflymail-X.X.tar.gz
         yourBOX% rm dragonflymail-X.X.tar.gz
      4. Edit dfmail.inc if you want to change any of the default settings.

   That is all!  Note: if your version of tar doesn't support inline
   gunzip (-z option) you may have to do the unpacking in two steps:
      
      yourBOX% gunzip dragonflymail-X.X.tar.gz
      yourBOX% tar -xf dragonflymail-X.X.tar

   Dragonfly Mail can then be accessed via http://your.web.server/webmail/



II.  Things DragonFlyMail does not support
   1. Using any other email server other than the one than your web server.
      For security reasons I don't want others using my server, so this is
      not likely to be changed.
   2. Attachments.  Look for this in the future.  I do have some other
      clean up work to do before I tackle this.
   3. Folders within folders.  This might work, it is not tested.
   4. Subscribe to folders.  There is no way to subscribe to folders
      yet.  Only folders that are subscribed to are shown, so this is
      a bug.  I will fix it later.
   5. Pretty Icons.  When I find some icons that I like (I am NOT an artist)
      I will add icons to the "iconbar".  If you have icons that you think
      might be nice to put there, send them to prices@dflytech.com.  By
      sending them to me you give me full rights to freely distribute the
      icons.  The artists will be credited, however.  Please include the name
      of the artist in your email.


III.  Things DragonFlyMail does support
   1. Basic Email Functions (it IS an email client after all!)
   2. Read messages in any subscribed folder.
   3. Refresh buttons


IV.  Credit where credit is due
   DragonFlyMail is based on phpWebMail (http://www.bmpsystems.com). 


V.  Support
   If you have questions or bug reports on DragonFlyMail, please email
   the author (Scott Price) at prices@dflytech.com.  Please do not call
   Dragonfly Technologies, Inc. looking for phone support.  Since we
   distribute this product for free we can not afford to support it by
   phone.


VI.  Why?
   I modified phpWebMail because I had specific wants for a webmail 
   client that I just couldn't find. So I found the best one, and 
   modified it to my liking. A lot of the code is still similar. I 
   added frames, multiple folders capability, hard coded $server to 
   localhost, changed the look of it drastically, and added session 
   support. 

   Mostly I wanted two things: I didn't want anybody to be able to check 
   any mailbox on any server from my server, and I wanted something all in
   one window.  I will be adding more options if people ask for them, 
   or I get annoyed with a feature or lack there of. 




Thanks! 
Scott (prices@dflytech.com) 


