DynaForm v1.3 - Created by the Webligo Group
http://www.webligo.com/



>> SUMMARY

We created DynaForm to provide a way to easily and quickly create
HTML email forms without any required coding aside from a bit of HTML.
In fact, one "dynaform.php" file can handle ALL of your email forms without
any kind of configuration - it automatically adapts to handle any form inputs
you want to include. If you are ready to begin, please review the installation 
instructions outlined below.



>> INSTALLATION INSTRUCTIONS

1. Simply upload dynaform.php, example.html, thanks.html, and error.html to your web server using 
   a FTP program such as Ipswitch WS_FTP (http://www.ipswitch.com)

2. To test if DynaForm was installed correctly, point your browser to the
   "dynaform.php" file you uploaded. (e.g. http://www.yoursite.com/dynaform.php)
   If you see the message "DynaForm is installed correctly.", then continue to step 3.

       If you receieve any errors or anything else:
          a). Try setting permissions (CHMOD) on "dynaform.php" to 755.
          b). If that still fails, try setting permissions (CHMOD) on "dynaform.php" to 777.
          c). If neither of these work, your server is not compatible with the script.
              Make sure you have PHP4 installed and that the mail() function is available to you.
              NOTE: To set permissions in WS_FTP, right click on the file and select "chmod". Then click
              all the boxes to CHMOD 777.

3. Now, you must build your HTML email form. We have provided one for you named "example.html".
   This can be ANY HTML file with a form, but there are a few requirements.
   
      a). The form "action" must be set to the relative or exact URL of "dynaform.php".
          For example, if both "yourform.html" and "dynaform.php" are in the same folder:
          <form action='dynaform.php' method='POST'>

          If "dynaform.php" is one folder BELOW "yourform.html":
          <form action='../dynaform.php' method='POST'>

      b). In the email form, there are three hidden variables that MUST exist between the <form></form> tags.
          <input type='hidden' name='rec_mailto' value='youremail@yoursite.com'>
          <input type='hidden' name='rec_subject' value='New DynaForm Email'>
          <input type='hidden' name='rec_thanks' value='thanks.html'>

          "rec_mailto" tells DynaForm who to email the results of the form to. Simply enter one email address, or
          a list of email addresses into the "value" parameter:
          <input type='hidden' name='rec_mailto' value='email1@mysite.com,email2@mysite.com,email3@mysite.com'>

          "rec_subject" tells DynaForm what the email subject should be.
          <input type='hidden' name='rec_subject' value='New DynaForm Email'>

          "rec_thanks" tells DynaForm the URL to the page to send the user after they have submitted their form.
          We have provided "thanks.html" as an exmaple. The tag might look like:
          <input type='hidden' name='rec_thanks' value='thanks.html'>

          All three of these hidden fields are REQUIRED. If you have forgotten one, DynaForm will give you a
          missing field error. 

      c). Enter any other fields you like. As long as they are given a "name" parameter, they will be included in
          the email. For example:

          <input type='text' name='Name'>
          <input type='text' name='Email'>
          <textarea name='Comments'></textarea>

      d). Create as many forms as you wish! Each one may have different fields as long as your three required
          fields mentioned in section B are present.


NOTE: It may be helpful to view "example.html". This is an example form that we have made to give
you an idea of how your form might look.



>> OPTIONAL CONFIGURATIONS

      1. If you wish to hide the three required variables from your form HTML, please open "dynaform.php" with
         a plain text editor such as Notepad and refer to the area labeled "OVERRIDE REQUIRED VARIABLES?".

      2. If you wish to ban certain IP addresses from usign your DynaForm, please open "dynaform.php" with 
         a plain text editor such as Notepad and refer to the area labeled "BAN IP ADDRESSES".

      3. If you are getting the error "Invalid Domain" and both your HTML form and "dynaform.php" are on the
         same domain name, please open "dynaform.php" with a plain text editor such as Notepad and refer to
         the area labeled "ACTIVATE DOMAIN SECURITY?".

      4. If you would like DynaForm to automatically respond to every form submission, please open "dynaform.php"
         with a plain text editor such as Notepad and refer to the area labeled "ACTIVATE AUTO-RESPONSE?"

      5. If you would like to require that users complete certain fields, please open "dynaform.php"
         with a plain text editor such as Notepad and refer to the area labeled "ACTIVATE REQUIRED FIELDS?"


>> FINAL NOTES

If you are a web designer or hosting provider and would like to use DynaForm for your
client websites, please contact us at alex@zforum.net to discuss the purchase of a
commercial DynaForm license.

Our group spent time creating this free script for your convenience.
While it is not required, we greatly appreciate any links back to our site.
These links, spidered by Google and other search engines, will improve both our
visibility and yours. Please, let us know if you would like a link back to your site.

We hope you enjoy using our software as much as we enjoyed creating it.

Best Regards,
Alex Benzer
Webligo Developments - Webligo.com