##################################################################  
#  (C)1998, 1999 Bignosebird.com   Version 1.0 (May 8, 1998)
#  Version 2.0 Released May 2, 1999
#  This software is FREEWARE! Do with it as you wish. It is yours   
#  to share and enjoy. Modify it, improve it, and have fun with it! 
#  It is distributed strictly as a learning aid and bignosebird.com 
#  disclaims all warranties- including but not limited to:          
#  fitness for a particular purpose, merchantability, loss of       
#  business, harm to your system, etc... ALWAYS BACK UP YOUR        
#  SYSTEM BEFORE INSTALLING ANY SCRIPT OR PROGRAM FROM ANY          
#  SOURCE!
##################################################################  

** Updated May 2, 1999 **

 The script now allows you to use either SMTP via Sockets or
 sendmail. The SMTP option makes the script much easier to install
 on Windows based servers.

                          BIRDCAST 2.0

   BIRDCAST 2.0 is a very simple, yet powerful script that 
   you can use to help promote your site. It features:

    1. As many recipient fields as you would like. 

    2. Text area entry for the reader to send a personal note
       with the e-mail.

    3. Automatic page recognition (FULL URL!) and automatic
       return to that page upon completion of the form.

    4. Domain validation to prevent "parasitic" use by others.

    5. Maintains a logfile of date/time, calling page and e-mail
       information.

                       *** INSTALLATION ***

   To install this script on your site, just do the following.

    1. Edit the birdcast.cgi file so that all of the configuration
       options are set properly for your server. In addition to
       the configuration section, check for the BNB SAYS! located
       through the script for even more customization notes.

    2. Upload the script to your cgi-bin directory as ASCII.
       (Please, ASCII NOT Binary!) 

    3. Using telnet or your FTP program, chmod 755 birdcast.cgi
       This means owner has read-write-execute permission, group
       and others can read-execute.

    4. Create a link on a page using either an image or text
       such as:

        <A HREF="http://yourdomain.com/cgi-bin/recomenda.cgi">
          Tell your friends about this page</A>!

    5. If the script does not create the logfile, place an empty
       file with the name you are using in the directory. Then
       chmod 666 the file (read-write for all).

    All of the configuration options are in the configuration
    section of the script. This is an easy one!

                            *** NOTES ***

   If you wish to create your own form and call this using 
   the POST METHOD, then please note the following.

   The only CRITICAL fields to making this script work is

        recipemail_X  (where x is a number from 1 to whatever)
        It is represented in the script as recipemail_$i
      
   The other fields recognized by the script are:

        send_name    Sender's name
        send_email   Sender's email address
        recipname_X  Recipient Name (where X is 1 to whatever)
        message      The textarea note field
        call_by   (hidden field passed by script containing calling URL)

