# Fresh Guest Book Version 2.0 by Webfresh (TM)
# Copyright  1999-2000 Webfresh All Rights Reserved
#
# This program is being distributed as shareware.  It may be used and
# modified by anyone, so long as this copyright notice and the header
# above remain intact, but any usage should be registered.  (See the
# program documentation for registration information.)  Selling the
# code for this program without prior written consent is expressly
# forbidden.  Obtain permission before redistributing this program
# over the Internet or in any other medium.  In all cases copyright
# and header must remain intact.
#
# VERSIONS OF SOFTWARE
#-----------------------------------------------------------------------
# Only one copy of the shareware or registered version of Fresh Guest
# Book may be used on one web site owned by one owner or an entity.
#
# LICENSE TO REDISTRIBUTE
#-----------------------------------------------------------------------
# Distributing the software and/or documentation with other products
# (commercial or otherwise) or by other than electronic means without
# Webfresh prior written permission is forbidden.
# All rights to the Fresh Guest Book software and documentation not 
# expressly granted under this Agreement are reserved to Webfresh.
#
# DISCLAIMER OR WARRANTY
#-----------------------------------------------------------------------
# THIS SOFTWARE AND ACCOMPANYING DOCUMENTATION ARE PROVIDED "AS IS" AND
# WITHOUT WARRANTIES AS TO PERFORMANCE OF MERCHANTABILITY OR ANY OTHER
# WARRANTIES WHETHER EXPRESSED OR IMPLIED.   BECAUSE OF THE VARIOUS HARDWARE
# AND SOFTWARE ENVIRONMENTS INTO WHICH THE FRESH GUEST BOOK MAY BE USED, 
# NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED. THE USER MUST
# ASSUME THE ENTIRE RISK OF USING THIS PROGRAM. ANY LIABILITY OF WEBFRESH WILL BE
# LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT OR REFUND OF PURCHASE PRICE.
# IN NO CASE SHALL WEBFRESH BE LIABLE FOR ANY INCIDENTAL, SPECIAL OR
# CONSEQUENTIAL DAMAGES OR LOSS, INCLUDING, WITHOUT LIMITATION, LOST PROFITS
# OR THE INABILITY TO USE EQUIPMENT OR ACCESS DATA, WHETHER SUCH DAMAGES ARE
# BASED UPON A BREACH OF EXPRESS OR IMPLIED WARRANTIES, BREACH OF CONTRACT,
# NEGLIGENCE, STRICT TORT, OR ANY OTHER LEGAL THEORY. THIS IS TRUE EVEN IF
# WEBFRESH IS ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. IN NO CASE WILL
# WEBFRESH'S LIABILITY EXCEED THE AMOUNT OF THE LICENSE FEE ACTUALLY PAID
# BY LICENSEE TO WEBFRESH.
#
#################################################################################



Distribution :

--- admin.cgi (Admin Control Panel)
--- guest.cgi (Guest Book)
--- README.txt
--- .htaccess (!!! upload ONLY if you can not execute .cgi scripts
    outside of your cgi-bin !!!)

------ /data FOLDER
------ adminmail.txt (email notification to admin)
------ dirty.dat (dirty words)
------ emails.dat (guest email addresses)
------ footer.html (HTML you want to display below your Guestbook)
------ guest.dat (Guest Book Data)
------ guestmail.txt (email response to guest)
------ header.html (HTML you want to display above your Guestbook)
------ hits.dat (Guestbook counter file)
------ info.dat (Guest Book Data)
------ ip.dat (IP addresses)
------ plain.temp (Guestbook HTML template)

------ /smilies FOLDER
------ smilies.html (Smily Help)
------ colors.html (Color Codes)
------ Set of 11 .gif images (smilies)


Usage of Fresh Guest Book is free as long as the link to Webfresh.com
remains visible. If you want to remove the link you must register the
software please read below (7.) for more information.



1. INSTALLATION
---------------

a)

SETTING PATH TO PERL:

- Open "admin.cgi" and "guest.cgi" in a text editor and set the
path to perl. This is generally:
#!/usr/bin/perl
or
#!/usr/local/bin/perl
or any another variation.
If you dont know your path to Perl, contact your server Admin.


b) 

CREATING FOLDERS:

- Create a folder on your server for your Fresh Guest Book.
  Named to whatever you want.
  (In the following example we simply name it "guestbook")

- Create a folder named "smilies" inside "guestbook".
  (The folder must be named "smilies")

- Create a folder named "data" inside "guestbook".
  (The folder must be named "data")


c)

UPLOADING FILES:

- Upload "guest.cgi" and "admin.cgi" into the "guestbook" folder
  in ASCII mode.

- Upload all files from the "data" folder into the "data" folder
  on your server in ASCII mode.

- Upload all files from the "smilies" folder into the "smilies"
  folder on your server in BINARY mode.


d)

SETTING FILE PERMISSIONS:

- Chmod "guest.cgi" and "admin.cgi" 755 (rwxr-xr-x).

- Chmod all files in the "data" folder 666 (rw-rw-rw).
  (or 777 (rwxrwxrwx) if you have problems).



2. INITIALISING GUESTBOOK
-----------------------

Simply fire up admin.cgi in your browser.
(ex.: http://www.yourdomain.com/guestbook/admin.cgi)

The first time you run admin.cgi you will be asked to set

a) your admin password
b) your Homepage URL
c) the URL to your smilies HTML files and images
   
Then login to Admin Control Panel using the password you just set.



3. ADMINISTRATION, CONFIGURATION AND CUSTOMIZATION
--------------------------------------------------

Configuration, layout customization and all administrative stuff
can be done via your Admin Control Panel ("admin.cgi")



4. ADVANCED LAYOUT CUSTOMIZATION
--------------------------------

You can also modify the guestbook layout in "plain.temp".
You must leave the copyright notice in place if you have not
registered your Fresh Guest Book copy. (See 5.)

<!-- --> entries define different sections of the Guestbook
(ex.: guestbook section, add section, error section).
You can edit all sections in the "plain.temp" template.

%variable% entries will be replaced by the true values from
the script (ex.: name, email, date, message).

Please be careful when editing any <!-- --> or %% entries in
"plain.temp" unless you know what you are doing otherwise the
guestbook may not function properly anymore.

A good idea is always to make a backup copy before starting to
modify any files.



5. RUNNING YOUR FRESH GUEST BOOK
--------------------------------

Call the Fresh Guest Book ("guest.cgi") directly from your browser.
(ex. http://www.yourdomain.com/guestbook/guest.cgi)



6. Troubleshooting
------------------

If you get an (500 server) error check :

a) path to perl (see above)
b) file permissions (see above)
c) folders must be named "data" and "smilies"

If you can not run .cgi scripts outside of your cgi-bin, simply
upload the .htaccess file in the folder with guest.cgi and
admin.cgi

If you are still having trouble please send an email to
trouble@webfresh.com



7. Registering
--------------

Registering your Fresh Guest Book copy authorizes you to remove the
link back to Webfresh.com in your guestbook.
Registration fee is only US$ 19.
If you want to register please go to http://www.webfresh.com/perl/fgb
