PHPost - A web based POP mail client written in PHP4
====================================================

Version: 1.08
URL:     http://webgadgets.com/phpost/
Author:  Mark Morley
Email:   mark@webgadgets.com


PHPost is a free PHP4 program that implements a POP mail client.  It is
designed to work with any standard POP and SMTP server (for receiving and
sending mail respectively).  It is simple and straight-forward, it doesn't
rely on any PHP add-ons or optional modules (although it will use certain
ones if they are available).


Installation:

   1) Grab the latest version of PHPost from here:

         http://webgadgets.com/phpost/phpost-1.08.tar.gz

      and extract it into the directory where you want it to run from.

   2) Create a subdirectory (in the directory where you extracted the
      archive) named "phpost_cache".  This is used by PHPost to store
      session files and index caches.  If you are running PHP in safe
      mode, the directory will have to be chgroup'd to the same group
      that your web server runs as (usually 'nobody').  You will also
      want to change the permissions to "drwxrwx---" (that's 770).

   3) Create another subdirectory (in the same location) named
      "phpost_prefs".  This is where per-user preferences are stored.
      It will need the same ownership and permissions as the directory
      you created in step 2.  Likewise for a directory named "phpost_temp"
      which is used as a temporary spot to hold extracted MIME parts.

      For example, on my system the three directories look like this:

         rwxrwx---  2 webgadgets nobody    512 May 18 11:19 phpost_cache
         rwxrwx---  2 webgadgets nobody    512 May 18 11:19 phpost_prefs
         rwxrwx---  2 webgadgets nobody    512 May 18 11:19 phpost_temp

   4) For extra security you should place a ".htaccess" file in both the
      "phpost_cache" and "phpost_prefs" that prevent access to all files
      within them.  Here's an example that works with Apache:

         <files *>
         order allow,deny
         deny from all
         </files>

      Don't put one of these in the "phpost_temp" directory though - that
      one needs to be able to serve up files.

   5) Edit the "phpost.inc" file and change the various config settings
      to suit your site. *PLEASE* change the default domain - I get too
      many replies to @webgadgets.com addresses :-)

   6) That's it, enjoy.

