formvista: A Business Component Framework for PHP
                             DemoShell Application 

Copyright 2001-2006, DTLink, LLC All Rights Reserved.

----------------------------------------------------------------------
INSTALLATION:

1. you need:

   - a website with PHP 4.3.9, Mysql 4.23.X or later. 
	- for added security the apache webserver is strongly recommended.
	- a mysql user and password that is allowed to connect from your
	  website and create databases.

   formVista has been tested under MacOSX, Linux, Solaris and 
	Windows 2000.

2. unpack the files somewhere onto your website. 

3. edit the "setup.php" file and change the line containing:

   define( "SETUP_PASSWORD", "replace_with_new_password" );

   Replace the text "replace_with_new_password" with a password
   of your choosing.

   If your website is hosted elsewhere you will need to upload your
   modified setup.php.

4. load the http://your_website/path/to/formvista_demoshell/setup.php
   in your browser.

   The location of formvista_demoshell/setup.php will depend on where
   on your website you unpacked the files.

   Just go through the screens and click NEXT.

   - if there are errors setup.php can be re-started.
   - errors about GD can be ignored. If you don't have it the image 
     manipulation and image upload will not work.
   - errors about missing POSIX libraries can be ignored under Windows.

5. The final page of the setup.php script includes a link to the home
   page of the installed demo.

6. It is recommended that you edit setup.php again and restore the
   password to:
	
   define( "SETUP_PASSWORD", "replace_with_new_password" );
	
	Just to make certain no one else will be able to run that script. 
	 
---------------------------------------------------------------------
REQUIREMENTS:
---------------------------------------------------------------------

Mysql 3.23 or higher.

PHP 4.3.4 or higher (older versions may work but will be unreliable).
   GD - for Image Manager and Image Upload to work.

   Microsoft Windows users will also need to have the
	
      "Collection of PECL modules for PHP"
		
   package installed. As of this writing the filename is 
			
      pecl-5.1.2-Win32.zip

Apache 1.3.xx or higher is strongly recommended.
   - because the entire application is designed to be installed under
     DOCUMENT_ROOT,  data files such a sessions may, if not properly 
     protected, be visible to the outside world. Each such directory 
     is protected by two layers of security:

     . .htaccess apache style deny from all protection.
     . each data file is encoded as a PHP file where the data is encased
       as a PHP comment. This means any attempt to load the file directly
       through a browser will result in a blank page.

---------------------------------------------------------------------
PHP SETUP:

If  you have a memory limit set in your PHP config you may need
to  raise it if you want to use image editing on larger photos.
Image  Editing  can  take  up  a  tremendous amount of ram. For
instance,  rotating  or editing a large JPG can require well in
excess of 20 megs of RAM.

----------------------------------------------------------------------
APACHE SETUP:

In order for the demo to work, PHP must be installed and set up
to parse *.php pages.

It is recommended that your Apache setup allow "deny from all" use
in .htaccess files.

-----------------------------------------------------------------------
MYSQL SETUP:

setup.php  needs  to  be able to create the formvista_demoshell
database. As such you should have two users:

1. a  mysql user with permissions enough to create databases and set
   up the environment.

2.  another  mysql user  with  lesser permissions that should be used
   when the application runs.

Refer to formvista_demoshell/conf/mysql*perms.txt for a list of
the permissions needed.

Setup  will  attempt  to  determine whether the users you enter
have  sufficient  permissions  and will display the permissions
needed.  As  part  of that, setup will attempt to use the first
user to query the Mysql "mysql" database. The user you have may
not  have  enough  access  to do this. If you receive a "cannot
connect"  error  it  just  means  that  setup  was  not able to
determine the user permissions.

--------------------------------------------------------------------------------

If you have any questions please join us in the formVista forums at:

     http://www.formvista.com/forum.html

-- DTLink Software.