PHPFormMail - Classic

• Copyright and Header
• Overview
• Setting Up the PHPFormMail Script
  • Necessary Variables
    • $referers
    • $valid_env
• Form Configuration
  • Necessary Form Fields
    • recipient
  • Optional Form Fields
    • subject
    • email
    • recipient_cc*
    • recipient_bcc*
    • realname
    • redirect
    • required
    • sort
    • env_report
    • priority*
    • print_blank_fields
    • title
    • return_link_url
    • return_link_title
    • missing_fields_redirect
    • background
    • bgcolor
    • text_color
    • link_color
    • vlink_color
    • alink_color
    • css*
    • _regex*
  • HTML Notes
    • Multiple Results (checkboxes and multiple lists)
• Donations
• History

#############################################################################
# PHPFormMail - Something we've always had...                               #
# Copyright (c) 1999 Andrew Riley (webmaster@boaddrink.com)                 #

#                                                                           #
#############################################################################
#                                                                           #
# If you run into any problems, please check out http://www.boaddrink.com.  #
#                                                                           #
#############################################################################

PHPFormMail is a universal WWW form to e-mail gateway.. PHPFormMail's main goal is to seamlessly take the place of it's PERL sister. All functions from PERL FormMail have an exact duplicate in PHPFormMail. PHPFormMail also has some extra functions built in, where ever you see a "*" (red star) is a new feature. Special thanks to Matt's Script Archive (http://www.worldwidemart.com/scripts) for if it wasn't for him/them/her (?) there would be no FormMail period. =:^)

There is only one required form input tag which must be specified in order for this script to work with your existing forms. Other hidden configuration fields can also be used to enhance the operation of FormMail on your site.

The anonymous WWW user must have the ability to read/execute the PHPFormMail.php script. If you have problems running a script with the .php extension, try .php3, .phtm, .phtml. If those do not work, please check with your system administrator for more help on running PHP scripts.

The PHPFormMail.php script does not have to be extensively configured in order to work. There are only two variables in the script in which you will need to modify.

 

$referers = array("boaddrink.com","216.92.77.123");

This array allows you to define the domains that you will allow forms to reside on and use your PHPFormMail script. If a user tries to put a form on another server, that is not in your list, they will receive an error message when someone tries to fill out their form. By placing boaddrink in the $referers array, this DOES NOT allow www.boaddrink.com, ftp.boaddrink.com, any other http address with boaddrink.com in it. I included boaddrink.com's IP address to access this script as well, just to be on the safe side..

Note: The domains listed in the $referers array must also include the domain that the e-mail is going to.

Example: If the recipient of the e-mail is test@example.com and the form is hosted on boaddrink.com, your $referes array will have to look like

$referers = array("boaddrink.com", "example.com");

Remember, the domain name of the recipient's domain must be listed in the $referer array, even if the form isn't hosted on that domain. Rule of thumb, include the domain name that is hosting the form AND include the domain name of the recipients (This includes recipient, recipient_cc, and recipient_bcc).

 

$valid_env = array("REMOTE_HOST", "REMOTE_ADDR", "REMOTE_USER", "HTTP_USER_AGENT");

This array allows you to define enviromental variables that can be reported. The odds are you won't need to change these. For more information on environmental variables, please see env_report.

Your phpformmail program is now configured.

Note: Users of PHP3 will need to uncomment the following lines:

/*function in_array($needle,$haystack){
      $found = false;
      while (list($key,$val) = each ($haystack)){
           if ($needle == $val){
               $found = true;
           }
      }
      return $found;
}*/

Will look like:

function in_array($needle,$haystack){
      $found = false;
      while (list($key,$val) = each ($haystack)){
           if ($needle == $val){
               $found = true;
           }
      }
      return $found;
}

The action of your form needs to point towards this script (obviously), and the method must be POST or GET in capital letters. Below is a list of form fields you can use and how to implement them.

There is only one form field that you must have in your form, for PHPFormMail to work correctly. This is the recipient field.

Optional Form Fields

Any other form fields that appear in your script will be mailed back to you and displayed on the resulting page if you do not have the redirect field set. There is no limit as to how many other form fields you can use with this form, except the limits imposed by browsers and your server.

 

Multiple Results

When using checkboxes and multiple selection lists, you'll need to add [] to the end of the name. When the [] is added, PHPFormMail can then properly process the field and print it out in a comma separated format.

As you know, most of the software I release is free, and will always be free. Keep in mind that this donation page isn't for me to profit, it's to allow me to continue developing free software and to keep boaddrink.com for you, the user. Please remember that this software is free for you to download and use but that doesn't mean it's not worth anything. You can donate any amount of money you wish... from $1 to $1,000,000. While a million dollars would be nice don't be pressured, any amount helps, even one dollar.

If you wish to donate, please visit http://www.boaddrink.com/donate.php

Thanks,
Andrew Riley