copyright


GUESTBOOK TOOL (ver. 1.08)

This is Readme file for Guestbook Tool. You can set it to record messages, home page and e-mail of those who visit you WWW documents, through form interface. Here is an example of the form in English and in Japanese and this is an example of the list of visitors.

1. How to get the package?

Get the package form here:

ftp_icon guest_home-1.08.tar.gz (11.9K)

2. Package

This package includes:

  1. guest_home.cgi
    A perl (ver. 4.x and 5.x) code that should be placed in your cgi-bin directory.
  2. record.html
    A html file containing a form to get the data from the visitors (in English).
  3. record_j.html
    A html file containing a form to get the data from the visitors (in Japanese).
  4. Copying
    GNU Copyright terms.
  5. Readme
    Text version of this file.

3. Installation

  1. You have to keep two publicly readable and writable files in your document structure. These are given at the top of the guest_home.cgi file. Edit the guest_home.cgi according to your system. Note that both visit_log and record_log files should be placed ina directory which is accessible to public and publicly writeable, under your document structure. If you put your html files in
    /usr/local/etc/httpd/htdocs
    then
    /usr/local/etc/httpd/htdocs/tmp
    is a good choice. Change the permission of the tmp directory to 777.
    (i.e. $ chmod 777 /usr/local/etc/httpd/htdocs/tmp)
  2. Place guest_home.cgi in your cgi-bin directory. Be sure to make it executable by giving the 755 permission to it.
    (i.e. $ chmod 755 guest_home.cgi )
  3. Place the record.html in your html directory hierarchy.
  4. Edit record.html file and set the path for the guest_home.cgi file in the FORM definition, near the top of this file.
  5. By calling http://your.host.domain/~your_name/dir1/dir2/record.html and filling in the form you can log visitors home page.
  6. That is all!!

4. Bug reports

This code has been tested on NCSA httpd 1.5.1, Netscape Enterprise Server 3.6, 6.0 using Sun Solaris 6, 7, and 8 for SPARC and Solaris 7, and 8 for x86. Please contact the author for bug reports, comments, suggestions and questions. My e-mail and address are given at the bottom of this file.

5. Copyright Terms
USING AND COPYING THIS PACKAGE IS PERMITTED CONDITIONALLY FOR EDUCATIONAL, CHARITY AND PERSONAL PURPOSES ONLY, PROVIDED THAT THE AUTHOR AND COPYRIGHT TAGS ARE KEPT UNCHANGED. ANY USE OF THE SOURCE CODE AND THIS PACKAGE IN A COMMERCIAL PRODUCT OR A COMMERCIAL SERVICE IS NOT ALLOWED AND NOT INCLUDED UNDER THIS LICENSE. THIS SOFTWARE IS MADE AVAILABLE AS IT IS, WITH NO WARRANTY ABOUT THE SOFTWARE ITSELF OR ITS PERFORMANCE OR ITS CONFORMITY TO ANY SPECIFICATION. PLEASE READ THE COPYING TERMS AND CONTACT THE AUTHOR FOR ANY QUESTIONS.

6. Author:

Behrouz H. Far
Department of Electrical and Computer Engineering, University of Calgary,
2500 University DR., N.W.
Calgary, Alberta,
Canada T2N 1N4

fare-mailenel.ucalgary.ca