Postman

Postman is a generic PHP processing script to the e-mail gateway that parses the results of any form and sends them to the specified users. This script has many formatting and operational options, most of which can be specified within a variable file "_variables.php" each form.

FILES

_postman.php - main processing file.

example.php - example PHP file using the script

stop-file.txt - file containing all words that you want to supress from the email.

_variables.php - file containing all the variables to handle processing options and destinations. You can have many variable files if you are running multiple forms on your site.

VARIABLES IN CONFIGURATION FILE

$postman = [
'attach' => true, // allow file uploads to be used by this form 'captcha' => false, // enable Google Recaptcha 'error' => '', // place holder 'mta' => [ 'service' => 'phpmailer', // enter service name - SENDGRID - PHPMAILER - Etc. 'api_key' => '', // required based on service 'id' => '', // required based on service 'pw' => '', // required based on service ], 'return_type' => 'self', // self, redirect, or json - return method will make the final routing 'return_method' => [ 'json' => ['type' => 'na'], 'self' => ['message' => 'Message sent'], 'redirect' => ['url' => 'http://www.example.com'], ], 'stop_words' => 'stop-file.txt', // to remove restricted words 'timezone' => 'America/New_York', // if a tz requirement is required // Google reCaptcha configuration 'google' => [ 'site_key' => '', 'secret' => '' ] ];

stop-file.txt = path to file containing all words that should be removed from any form field. These are not partial and are considered word boundry limitations

$aEmail = associative array containing all the values required to send an email to the reciepient of the form.

to | single email address from| single email address - $_POST['email'] default fromname | comman name associated with from cc | comma delimited list of email addresses bcc | comma delimited list of email addresses subject | character string msg-html | associative array | 'path' - file path - HTML version of email | 'character-set' - character set to use for data | 'content-type' - content type set to use for data

msg-text
| 'path' - file path - PLAINTEXT version of email | 'character-set' - character set to use for data | 'content-type' - content type set to use for data

attachments | array( '0' => array( 'path' => '' , 'name' => '' ) )

$aAcknowledgment = associative array containing all the values required to send an acknowledgement email to the end-user of the form.

from| single email address - $_POST['email'] default fromname | comman name associated with from cc | comma delimited list of email addresses bcc | comma delimited list of email addresses subject | character string msg-html | associative array | 'path' - file path - HTML version of email | 'character-set' - character set to use for data | 'content-type' - content type set to use for data

msg-text
| 'path' - file path - PLAINTEXT version of email | 'character-set' - character set to use for data | 'content-type' - content type set to use for data attachments | array( '0' => array( 'path' => '' , 'name' => '' ) )

   $aRequiredFields = associative array containing all the fields
   that are verified, the length of each field and the type of variable
	 scrubbing required.

	 $aRequiredFields = array( 
   	'Name' => array( 
   		'id' => 'form id associated with field',
   		'min-length' => minimum length of value,
   		'scrub' => 'type of scrubbing for the variable.',
      'type' => 'type of field.' // must be marked as "file" to test.
   	),

Example: $aRequiredFields = array( 'Name' => array( 'id' => 'name', 'min-length' => 3, 'scrub' => 'ALPHA', 'type' => 'text' ), 'Email' => array( 'id' => 'email', 'length' => 3, 'scrub' => 'EMAIL', 'type' => 'text' ), 'File' => array( 'id' => 'fupd_1', 'length' => 3, 'scrub' => 'N/A', 'type' => 'file' ) );

	 ALPHA - Only characters from A-Z and spaces.
	 ALPHA_NUM - Only characters from A-Z & 0-9 and spaces.
	 SIMPLE - Only characters found on the keyboard no special characters..
	 EMAIL - Only characters that are part of a well-formed email address.
	 HYPERLINK - A string that has been properly formatted as a URL.
	 WHOLE_NUM - A whole number example 1000000 valid 1,000,000 invalid
	 FLOAT_NUM - A float point number
	 FORMAT_NUM - A properly formatted number
	 SQL_INJECT - Only allow characters that are valid in value SQL calls.
	 REMOVE_SPACES - Remove all spaces from the string.
	 REMOVE_DOUBLESPACE - Remove double space and replace with single spaces.
	 BASIC - Only characters found on the keyboard no special characters.
 N/A - Not applicable and no scrubbing will be performed on the variable.