
  phpHtmlLib INSTALLATION


  Introduction
  ============

  I have tried to make the phpHtmlLib fairly easy to install
  and to use on anyone's current running site.  There are a few assumptions     
  I've made, but it shouldn't be a problem for 99% of the folks out there.  I   
  haven't tested the libs in a windows environment, as I don't have a M$ O.S. 
  installed anywhere in my house.  If you encounter any issues, please let me    
  know.  I welcome any and all feedback.
  
  Thanks and enjoy,
  Walt A. Boring IV
  waboring@newsblob.com
  


  Installing the libs
  ================================================

  1. Overview for the impatient
     --------------------------

     $ mv phphtmllib <your webdir DOCUMENT_ROOT>
     
     NOTE: in your script, set a global variable $phphtmllib to the
           location of your phphtml install.  If you installed it into
	     your DOCUMENT_ROOT, you would do 
	   <?php 
	      $phphtmllib = $_SERVER["DOCUMENT_ROOT"] . "/phphtmllib"; 
	      include_once("$phphtmllib/includes.inc");
	   ?>

  2. Requirements
     ------------

     The following requirements exist for using phpHtmlLib :

     o  PHP version 4.2.x 
     
     Optional
     o  One of phpHtmlLib's DataListSource Classes can work with
        PEAR and/or ADODB DB abstraction layer classes.  PEAR should
	already be installed if you have a proper PHP install.  You 
	can get ADODB (much better IMHO) from 
	http://php.weblogs.com/ADODB


  3. Installing
     ----------

     1. Copy the entire phphtmllib directory into your website's source
        tree.  I typically install it in DOCUMENT_ROOT/phphtmllib.
	  You don't have to have it installed in the document root, but that is
	  where I normally install it.
	
     2. In each script that uses the libs, you MUST set a global variable
        $phphtmllib to the path of your phphtmllib dir in your web tree.
	  So, if you installed phphtmllib in your DOCUMENT_ROOT, like I do,
	  then you set $phphtmllib = $_SERVER["DOCUMENT_ROOT"] . "/phphtmllib"
	  I usually do this at the top of my scripts, or have a include file
	  of defines and such that sets this.
	
        After that you should be able to include the main includes file
	  include_once("$phphtmllib/includes.inc"); to include all of the files
	  in the lib, or you can include each file that you need individually
	  to save include processing.
     3. Optionally, review the SECURITY file if you are installing 
      phphtmllib into a production environment.

  9. Contacts
     --------

     o All the latest updates and news will be posted on phpHtmlLib's project
       website at http://phphtmllib.newsblob.com

     o You can always contact me by sending an email to: Walt Boring
       waboring@newsblob.com


     Thanks for trying phpHtmlLib.
                                          Walt Boring IV

