Mail Manage EX Pro ReadMe

• Installing MMEX Pro onto web server
• Edit Form Settings
• Changing Permissions
• Creating HTML Form
• Troubleshooting

1. Open the ftp program that you use.
2. Upload all files in mmex pro folder or the whole folder itself to your web server.
3. That is it!

1. Open settings.php.
2. You will see two options under Main Settings.
   • $send_type is very important. It tells where the information will be sent to.
     The choices are email (sent to email), dbase (sent to database), file (sent to a flat-file) or emailfile (sent to email and flat-file).
     (ex: $send_type = 'email';)
   • $req_fields are the form fields that you want to be required. (Seperate each one by a comma).
     (ex: $req_fields = 'name,email,age';)
     
   • $confirm_fields are the group of form fields that need to be entered twice such as a password. (Must be in groups of two and have each one seperated by a comma).
     (ex: $confirm_fields = 'email,confirm_email,password,confirm_password';)
     
     
3. Next are the Display Settings.
   
   • $icons is used if you want the provided icons to be displayed on error messages. (To use, enter yes otherwise leave it blank).
   • $font_size is used to display the font size of all messages. (Default = '11pt').
   • $font_color is used to display the font color of all messages. (Default = '#000000').
   • $font_weight is used to display the font weight of all messages such as bold. (Default = 'none').
     
     
4. Next are the Email Settings. (Note: these only apply if $send_type = 'email' or 'emailfile';).
   • $recipient is the email address you want the form results to be sent to. Without this, no email will be sent.
   • $cc is another email address that you would like to receive the form results.
   • $bcc is any other email address(es) that you would like to receive the form results.
   • $subject is the subject you would like to be displayed in the recipient's email. (Default = 'Form Submission').
   • $ip_address is used if you want to see the user's ip address in the form results email. (To use, enter yes otherwise leave it blank).
   • $getdate is used if you want to see the date and time in the form results email. (To use, enter yes otherwise leave it blank).
   • $browser is used if you want to see the user's browser agent in the form results email. (To use, enter yes otherwise leave it blank).
     
     
5. Next are the Database Settings. (Note: these only apply if $send_type = 'dbase';).
   It is assumed that you have already created a table with all the proper fields in your database.
   
   
   • $db_user is the username to get into your database.
   • $db_pass is the password to get into your database.
   • $db_name is the name of your database.
   • $table_name is the name of your table in the database.
   • $table_fields is the list of fields in your table. (ex: $table_fields = 'name,phone,email,comments';).
     
     
6. Next are the Flat-file Settings. (Note: these only apply if $send_type = 'file' or 'emailfile';).
   To anyone who is unclear on what this is, it is basically a small database saved to a file instead of an actual database.
   
   
   • $flatfile_name is the name of the file that you form results will be saved to. (ex: $flat_file = 'log.txt';).
   • $file_limit is used to control what you want the maximum capacity of your flat-file to be until an alert email is sent to you.
     (3500 = 20-30 entries | 7000 = 45-60 entries | 15000 = 90-115 entries)
   • $alert is used if you want to be alerted by email if your falt-file is getting too big.
   • $alert_address is the email address the alert message will be sent to.
     
     
7. Next are the After Submission Settings.
   • $thankyou is used if you want a custom thank you message displayed upon submission. (Default = 'Thank you for your submission').
     
     
   • $redirect is used if you want the user to be taken to a certain page after submission. (ex: $redirect = 'thankyou.html';).
     
     
   • $auto_respond is used if you want an email to be sent to the user after submission.(To use, enter yes otherwise leave it blank).
   • $alert_subject is the subject of the email sent to the user. (Default = 'Thank you for your submission').
   • $alert_content is the content of the email sent to the user. (Default = 'Thank you for your submmission. We will contact you shortly.').
     
     
8. Next are the Security Settings.(Note: these add security to your forms but do no guarantee 100% protection.).
   
   
• $flood_control retsricts how often a form can be submitted from the same ip address. This controls multiple entries too.
• $floodfile_name is the name of the file of the data for the flood control.
• $interval is the allowed length of time between submissions (in minutes).
  
  
• $ip_block is used to block certain ip addresses. (To use, enter yes otherwise leave it blank).
• $ipfile_name is the name of the file that the ip addresses are listed on.
  
  
• $referer is used to make sure that your script is only being used from an authorized web page. Make sure it is the full url of your form page.
  (ex: $referer = 'http://www.arecaweb.com.php/form.html';).

1. If you chose to use the ip block or flood control feature and/or save your form results to a flat-file this applies to you.
2. You will need to go to your file manager on your web control panel.
3. Find log.txt,flood.txt and/or ipblock.txt. Somewhere there should be a "change permissions" button or link that allows you to edit
   the permissions of these files.
4. Change the permissions to 666 and save the changes. This allows the documents to be editted from the script, otherwise you will receive error messages.
5. If you dont know where this is or your control panel doesnt have this feature, consult with your hosting company as to how to change these files.

1. In the html form that you create you need to make sure that your <form> tag has at least these two elements:
   <form method="post" action="yourdomain../../mmexpro.php">
2. Set a hidden type in the form to reference which settings you want for this form.
   
   Example: (Form A would have) <input type="hidden" name="settings" value="Asettings.php">
   Example: (Form B would have) <input type="hidden" name="settings" value="Bsettings.php">
3. This feature provides the ability to have different settings for different forms on your site.
   This allows the developer to use mmexpro.php as many times as they want for as many forms as they want.
4. Look at the sample provided to see format.
5. Format validation is used for these preset form field names: email, phone, state, zip_code
6. A small but nice feature about MMPX is that if you have a multi-word form field name that is sepearted by underscores
   (ex: input type="text" name="favorite_food"), MMPX will display those as spaces in your results.