###################################################################
# Junk STOP - Anonamous Webmaster's Email				Version 1.0 
#                         
# Copyright (©)2000 Marek A Molozzi, All Rights Reserved.
#
# Duplicating or redistributing this program without prior
# written consent is expressly forbidden.  You must Obtain
# permission before redistributing this software by any means.
# In all cases this copyright/license notice must remain intact.
#
# http://Marek'sScripts.w2w.cc/ 
#               
# Last Modified 6/18/2000      
###################################################################


Copyright
====================

   Duplicating or redistributing this program without prior written consent is 
   expressly forbidden.  You must Obtain permission before redistributing this 
   software by any means. In all cases the copyright/license notice must remain 
   intact.


Description
====================

   Ok, you've tried just about everything to prevent spam bots from collecting 
   your email address and sending you a mountain of junk email.  Even using 
   FormMail doesn't work because your email address can still be found on your 
   web site and spam bots are getting smarter every day. Junk STOP is a simple 
   form to email script that has the webmaster's email address embedded in the 
   script and therefore inaccessible to robots.


Features
====================

	- Prevents Spam Bots from collecting your email address.

	- Allows your visitors to easily contact you.

	- Requires a valid email address.

	- Script access limited to your site.

	- Custom Thank You Page.


Requirements
====================

	- Perl 5

	- Unix Based Web Server

	- cgi capability

	- Sendmail



Installation Steps
====================

   A. Edit the first line of the main  script from #!/usr/bin/perl to the required
      Perl path specified on your server. (If you don't know contact somebody
      who does, such as a web host's technical support. Commonly it can be
      /usr/bin/perl, /usr/sbin/perl, /usr/local/perl, etc...)

   B. Modify the variables in the junk.cgi (open it using notepad and scroll down 
      until you see the line "Define Variables").


     1. $yourmail = "youremail\@yourdomain.com";
        ====================================================================
        Your email address.  Make sure you include the "\" before the @ symbol.  
        If you don't it will cause the script to crash.


     2. $sendmail="/usr/bin/sendmail";
        ====================================================================
        Enter the full path to sendmail on your server (If you don't know 
        contact somebody who does, such as a web host's technical support. 
        Commonly it can be /usr/lib/sendmail, /usr/sbin/sendmail, 
        /usr/bin/sendmail, etc...).


     4. @referers = ('yourdomain.com', www.yourdomain.com', '209.456.66.132');
        ====================================================================
        The referrers list is the list of domains and IP addresses that are
        allowed access the script. Use it to prevent others from accessing the 
        program from another server.  Replace yourdomain.com and the IP numbers 
        to match your site (case insensitive). You can add as many as you like.

        @referers = ('yourdomain.com','another.com','another2.com');
        @referers = ('yourdomain.com');

        As you can see each item should be in single quotes and seperated
        by a comma (unless there is only 1 item, then no comma is required)


   C. Modify the junkstop.html (open it using notepad and scroll down 
      until you see the line "<form method="POST"").  Change 
      action="cgi-bin/junk.cgi" to reflect the path to the script on your 
      server.  Optionally, you can include a full URL 
      (e.g. action="http://www.yourdomain.com/cgi-bin/up.cgi").

      Scroll down  until you see the line "<input type=hidden name="redirect"". 
      Change value="thankyou.html" to reflect the path to your custom server.  
      Optionally, you can include a full URL (e.g. 
      action="http://www.yourdomain.com/cgi-bin/up.cgi"). If you leave the 
      value blank (i.e. value="") Junk STOP! will create it's own thank you page.


   D. Upload junk.cgi into your cgi-bin directory using ASCII mode (any other 
      mode would make things not work).

   E. Chmod the junk.cgi to 755.

   F. Upload junkstop.html to your site.  

   G. You are now setup to run the Junk STOP!, have fun and if you
      have any problems please feel free to contact me.