=================================== === = = - -   
| GuestFriend Ver 0.99 Beta
============================ === = = - -

##########################################################################
# COPYRIGHT NOTICE:
# 
# Copyright FocalMedia.Net 2001
# 
# This program is free to use for commercial and non commercial use. 
# This script may be used and modified by anyone, so long as this copyright 
# notice and the header above remain intact. Selling the code for this 
# program without prior written consent is expressly forbidden.
# 
# This program is distributed "as is" and without warranty of any
# kind, either express or implied.
#
##########################################################################


=================================== === = = - -   
| What is GuestFriend?
============================ === = = - -

Simply put, Guestfriend is a guestbook that you put on your web site. Visitors can
ad their names and comments.

=================================== === = = - -   
| Installation
============================ === = = - -

Follow the steps below and you will have Guestfriend serving your visitors in
no time.

    ----------
	| Step 1 |--> Unzip the .zip archive that contains the setup files.
    ----------

    ----------
	| Step 2 |--> Open admin.cgi and guestbook.cgi with your favourite text
    ----------    editor and make sure that the first line points to the
                  correct path where your perl interpreter is located.
                  
                  Remember to save the cgi script files in unix format 
                  if you are going to be running GuestFriend from a unix
                  machine. If you are going to run GuestFriend from a windows
                  machine, remember to save the .cgi scripts in windows
                  file format.
                  
    ----------
	| Step 3 |--> Copy setup.cfg, admin.cgi, guestbook.cgi, setup.cgi, and data.txt
    ----------    to your cgi-bin directory.
    
    			  Make admin.cgi, guestbook.cgi and setup.cgi world executable.
    			  Example: chmod 755 *.cgi
                  
                  Give data.txt and setup.cfg the following permission: 766
                  Example: chmod 766 data.txt
                  		   chmod 766 setup.cfg

    ----------
	| Step 4 |--> Copy logo.gif, listings.html, main_layout.html, problem.html and
    ----------    thanks.html somewhere in your web server's document root. - This is
                  is a directory where you can access the .html files with your web 
                  browser.
                  
                  For Example:
                  Fictional URL Path: http://www.yourdomain.com/guestfriend
				  Fictional Server Path: /home/yourdomain/www/guestfriend
                  

    ----------
	| Step 5 |--> Ok, you have now transferred all the files and have set the 
    ----------    correct permissions for them. Now execute setup.cgi
                  in your web browser. 
                  Fictional Example: http://www.yourdomain.com/cgi-bin/guestfriend/setup.cgi
                  
                  You will be prompted to supply paths and information.
            

    ----------
	| Step 6 |--> You should now have completed the setup questions in setup.cgi. Your  
    ----------    guestbook should now be ready for action and visitors.
    
    			  Execute admin.cgi in your web browser to access GuestFriend's admin 
    			  control panel.
    			  
    			  Execute guestbook.cgi in your web browser to access your guestbook.
    			  
    			  Test your guestbook and if it's working correctly delete setup.cgi 
    			  in your cgi-bin directory.

				  You can now customize the look and feel of your guestbook to your
				  liking. Open listings.html or main_layout.html or problem.html with
				  your web editor and edit away. You may also add images to these
				  HTML files. Just remember to place the images in the same directory
				  as the .html files. Please leave the words enclosed by !! intact.
				  The words enclosed by !! is special variables used by guestfriend.
				  Example of such a variable: !!guest_book_entries!!		
				  
				  If you are going to use Java Script in the .html files please 
				  turn off the image parser in setup.cgi

  

================================
| Installation Trouble Shooter |
================================

1. Did you chmod 755 admin.cgi, guestbook.cgi and setup.cgi

2. Did you chmod 766 setup.cfg and data.txt

3. Did you enter the correct paths when you ran setup.cgi


Any comments very welcome! Send them to support@focalmedia.net