----------------------------------------------------------------------
WAPpop
A WAP based POP email management tool
Copyright SANIsoft

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., 675 Mass Ave, Cambridge, MA 02139, USA.


SANIsoft
e-mail <tarique@sanisoft.com>
WAPpop home <http://www.sanisoft.com/wappop/>
---------------------------------------------------------------------
These instructions refer to my configuration of WAPpop (PHP
4.0.4, PHP Base Library 7.2c, MySQL 3.22.21, Apache 1.3.9, Red Hat
Linux 6.2). WAPpop has only been tested under this configuration,
though it  should work in any PHP environment with a PHPLIB supported
database.  Currently, PHPLIB supports MySQL, PostgreSQL, Oracle,
Sybase and  ODBC databases

These instructions assume that you have the following working
together: Web Server, PHP, PHPLIB, and database. The following
configuration is recommended:

- Apache Web Server (http://www.apache.org/). I recommend downloading
the source and compiling it yourself so that you can compile PHP as
an Apache module. NOTE: The RPM or other binary version should work
as well.

- PHP (http://www.php.net/). Again I recommend downloading the source
and compiling it yourself so that you can compile PHP as an Apache
module. NOTE: WAPpop should also work using PHP as a CGI
executable either compiled yourself or from a binary distribution of
PHP.

- MySQL (http://www.mysql.net/). You can either compile the source,
or in my case I downloaded the binary RPMs from the MySQL website.
Either should work.

--
WAPpop installation
(after untar/unzip the distribution file to a temporary location...)

1. Move the wappop directory that was created by the un-tar/un-zip to
a location under your webserver's document root - so that the
web server will serve the WAPpop directory and pages.

2. Edit the .htaccess file in wappop directory to point to the correct location

3. Tell your webserver NOT TO SERVE pages in the WAPpop/lib directory.
These pages contain the user ID and password to your database and
you don't want folks seeing them. I have included an .htaccess
file in this directory for use by Apache that will stop browsing
of the lib directory. Make sure and test this after the installation
by trying to get to http://your-domain.com/WAPpop/lib/poplocal.inc
You should NOT be able to get to this URL.

4. Update the waplocal.inc file with the name of your WAPpop
database and the user ID and password used to connect to it. I use
"WAPpop" as the name of my WAPpop database. Review the
contents of this file and update to support the database you are
using.

5. Update the wappop.inc file with the configuration settings
for your environment.

6. OPTIONAL:
  Full customization is available with the Template support in WAPpop.
Update the files in the WAPpop/lib/templates directory to create the
look & feel and language that you desire for your installation of WAPpop.

7. Create the tables in the database used by WAPpop
using the WAPpop.sql definition. In MySQL this can be done
(assuming you have created a database named WAPpop) with the
following command:
  mysql WAPpop <WAPpop.sql

8. Add the rows to the auth_user table for those users that you
want to allow to use WAPpop. Passwords are NOT needed in auth_user.
The POP server provides the authentication. The use of auth_user is
merely to allow you to control who can use the application. See the
WAPpop.sql file in this distribution for example INSERTS into auth_user.

10. To give WAPpop full control over character handling,
especially quotes, you must turn magic_quotes_gpc, magic_quotes_sybase
and magic_quotes_runtime off. You can do this in the php3.ini file
or if supported by your webserver in the .htaccess file. These settings
are already set in the sample .htaccess file from the distribution.

12. Open the index.php3 page in your WAP emulator / browser / device, enter your POP user ID
in the user ID field (normally your email user), enter your POP password
in the password field, click "Login" button, and enjoy!

Install FAQ
-----------

If you receive a message like:
  "Fatal error: DB_Sql is already a function or class in
   db_mysql.inc on line 12"
when you run WAPpop, then you have included the DB_Sql class twice.
This is most often caused by having the prepend PHP.INI option set to include a file as well as
including the file in the page source itself. WAPpop includes all pages it needs in its source files.
It does not support the PHP.INI prepend setting for any classes it uses (PHPLIB or otherwise).
Remove the prepend setting from your PHP.INI file to aleviate this problem.

WAPpop installation end
--