$Id: INSTALL,v 1.5 2000/08/19 17:39:09 darren Exp $

This program requires the these other programs to be installed:
	The MySQL database system, available from http://www.mysql.com
	
	PHP with MySQL support enabled. Available from http://php.net
	The time sheet system was developed using PHP version 3.0.12
	it should function with and 3.0.X version or with version 4,
	although this has not been tested.
	
	Apache or any other HTTP server that supports PHP. 
	Apache is available at http://apache.org.
	PHP support must be enabled. Consult the PHP / Apache
	documentation for detailed instructions on how to do this.
	
	
To install the time sheet system follow these steps

1.  Download the latest version. If you are reading this file
    you have probably already done this.
	
2.  Change directories to your web server document root directory.
    For example /home/httpd/html is a common location.
	
3.  Extract the time sheet program files with this command:
	
    tar -xzvf path_to_the_timesheet_tarball
	
4.  You should have a timesheet directory with the timesheet php3 and HTML 
    files in it.
	
5.  Read the README, INSTALL and Changelog files and follow any special
    instructions in them.

6.  If desired, move the directories templates and include out of the web server
    root. This will prevent someone from gaining direct access to them
    via the web server and gives somewhat greater security.
	
7.  Copy the file config.php3.dist to config.php3. Edit the file config.php3. 
    You will need to provide values for these
    parameters:
		
      $admin_password:  This is the password used to control access to the
		        timesheet administrative interface.
		        DO NOT KEEP THE DEFAULT PASSWORD!!!!

      $DB_Host:	        The computer running the MySQL database system.
		        The default setting will be fine unless you are
					running MySQL on another computer.

      $DB_Username:     The MySQL user with access to the timesheet database.
		        It would be a good idea to create a specific
		        MySQL user for this and not use the MySQL superuser
		        account.

      $DB_Password:     The password for the above user.

      $DB_Database:     The default will be fine. If you use a different database
      	    	        name, change this to your database name.
		       
      *********   New in Version 1.2.0 ***************************************
      $templates:   	The directory where the HTML templates are placed.
      	    	    	This should be a complete path. 
			
      $lang:	    	Which set of templates to use for the local language.
      	    	    	Currently only English (en) templates are supplied.
      
      $Email_Notify:	If this is set to TRUE an email notification will
      	    	    	sent every time someone enters their time into the database.
			
      $notify_address:	If email notification is active, this the address mail will be
      	    	    	sent to.
      
      $from_address:	The address mail notifications should have as their From: address.
      
      week_start:   	The day that weeks start on. Should be set to either
      	    	    	0 for Sunday or 1 for Monday.
			
		
		No other settings should be changed.
		
8.	Create the timesheet database like this
	
	mysqladmin create timesheet
	
	Or use another MySQL interface to create the database.
	
9.	Create the database structure like this
	
	mysql timesheet < timesheet.sql
	
10.	The system should now be ready to use. Point a browser at this
	URL http://yourhost/timesheet/admin.php3 to access the administrative
	interface. Add companies, job id numbers and workers as
	desired.
	
11. To access the timesheet portion of the system go to this URL
	http://yourhost/timesheet/
	

	
