=================================================================
M&M Guestbook v1.1

(c)2001 By Michael May all rights reserved. 
        http://webmasters.winnfreenet.com  tmaster@bigfoot.com

This software is Shareware or FreeViewWare (tm).
You are free to use as long as you use the provided error pages
with my banners and links to the download site.  You may register
this software for a donation of $5 and remove the banners but I
request you keep the link to my site. You may register this
software for a donation of $15 and remove all links to my site.
Please check website for ordering info.


=================================================================


This script does not generating HTML on the Fly doing so slows down
the server and does not allow search systems to index your pages.

Creates a guestbook HTML page.

Saves guestbook data in a text file that can be edited.

Anti Spammer option E-Mails the webmaster a copy of each post.

Header and Footer txt files hold your custom HTML so you can
control what is on top and botom of your guestbook page.



-------------
Install


 You should have a CGI-BIN directory that is CHMODed to 777.  Be sure to check
 your servers CGI help screens because some may require another setting.

 You should also test to see if your server allows you to display a 
HTML file from your CGI-BIN directory. Some do not and on those servers
you will have to save the HTML file somewhere else. A seperate path
setting is provided for such servers. Also some servers will only
allow you to save the HTML in your CGI-BIN.



1) Edit error.cgi with a text editor to set your paths.
   Set the following.

Your path to perl. This one works on most servers.

#!/usr/local/bin/perl

# Email to send a report to
$webmaster_email = 'me@mydomain.com';

# Email report will be sent from
$webmaster_from  = 'mywebsite@mydomain.com';




 Path to your cgi directory. Here are some samples.
 If you don't know it you must ask your webmaster

 hypermart = /data1/hypermart.net/USERNAME/cgi-bin
 virtualave= /data1/virtualave.net/USERNAME/public_html/cgi-bin
 portland  = /home/USERNAME/cgi-bin


$path   =  "/yourpath-to-your-directory/cgi-bin";


 Path where you will save your HTML file
 the file mmlink.gif needs to be placed in this directory.

$guestbook = "/yourpath-to-your-directory/cgi-bin/guestbook.html";


 URL of the guestbook.html

$domainRedirect  = "http://www.mydomain.com/cgi-bin/guestbook.html";


 Your Sendmail path. This is optional because the script will search a known
list of paths and use the one that works. If you do know your path enter
in on the first $mailer line. 

 Portland users are told to enter a special path on the first line like this
 '/usr/lib/sendmail -u yourusername'  your username goes after the -u 
 However I have found that entering this on the second line and entering
 '/usr/lib/sendmail' on the first line works for now.


2) Upload mmguest.cgi to your CGI directory using text mode!

3) Chmod to 777

4) Edit the start.htm file to include the correct path to
   the CGI script. It might work as is.

5) Edit the footer.txt file to include the correct path to the CGI 
   script. When the script runs the html in this file will create
   the guestbook.html file.

6) Test the script by entering loading the guestbook.html file
   In your browser and saving a post.



This should display the guestbook.html page with your sample post
if it does not then start over you must have mistyped a path or
not chmoded the script right.




    
Setup Help
==========

 This script has been tested on Hypermart Virtualave and Portland and does work.


1) Recheck the path settings in the script. Make sure you do know your correct path.

2) Chmod your CGI-BIN to 777.  Do not trust what your ftp client tells you about the
   chmod status do it again. Portland has been known to report a false status to your
   ftp client.

3) Reupload the script making sure you do it in text mode. You may have to turn off
   auto and force your FTP client into text mode.

4) Chmod the script 777 it does not matter that you did it before do it again.

5) Some servers do not allow users to view HTML files if they are in
   the CGI-BIN directory. Some servers will try to run the file like
   it was a CGI program.  Portland does this Hypermart does not so be
   sure to test your server.   If your server will not display HTML
   files from the CGI-BIN you will have to place the HTML outside the
   directory. Try saving to root or if that won't work create another
   directory be sure to chmod the directory giving your scripts Write
   access but not run access.  




If you are not on any of the tested servers and all of the above does not start
the script to working then please visit the website for more up to date info.


Register
=============

Since I know that you must have web access to use this script I ask that you
please visit the website to register. Or you may email me if that does not work.


http://webmasters.winnfreenet.com

tmaster@bigfoot.com
---
* Have many nice days *







