#################################################################### # Script: | Form Manager # # Version: | 1.5 # # By: | i2 Services, Inc. / CGI World # # Contact: | Contact@CGI-World.com # # Web Site: | http://www.cgi-world.com # # Copyright: | CGI World of i2-Services, Inc. # # Released: | January 4th, 2001 # # Updated: | April 23th, 2003 # #################################################################### # By using this software, you have agreed to the license # # agreement packaged with this program. i2-Services, Inc # # (CGI-World.Com) reserves the right to track this license. # # # #################################################################### # Form Manager ( http://www.CGI-World.Com/form_manager.html ) : # # ------------------------------------------------------------------ - Misc. ------------------------------------------------------------------ READ - Install_Form_Manager.txt - Documentation and installation information for the Program. READ - License.txt - Form Manager Program User License Agreement. ------------------------------------------------------------------ - Installation ------------------------------------------------------------------ 1. Unzip the Form Manager ZIP Archive and Preserve the Directory Structure. Modify the top line of the two .cgi files to point to Perl 5 on the webserver. Normally located at /usr/bin/perl The location is to have the standard #! before the path (Example: #!/usr/bin/perl) 2. Create The Following Directory Structure inside a directory which can execute CGI Programs. You may want to create a separate directory (Example: /cgi-bin/forms/) to run the program in. This directory will need a execute / 755 permission and is not required to be named /forms/. * /forms/ (Execute / 755 Permission) html_forms/ (No Permission Change Needed) logs/ (Writable / 777 Permission) prog_files/ (Writable / 777 Permission) prog_templates/ (No Permission Change Needed) 3. Upload the files that were extracted from the Form Manager ZIP File to the following directories. Set the file permission labeled next to each file if stated. * /forms/ admin.cgi ( Execute / 755 Permission ) forms.cgi ( Execute / 755 Permission ) NOTE: If using an NT Server .pl file extensions may be needed. If so rename the files with a .cgi extension to .pl * html_forms/ example_1_Complete.html example_1_pg1.html example_1_pg2.html example_1_pg3.html example_2_Complete.html example_2_pg1.html NOTE: The files above are the example forms sent with the program. This is where you will place your HTML Form Files to be used with the program. NOTE: This is where you will upload your created HTML Form Files to. Normally HTML files can not be placed in the /cgi-bin/. Due to the program using these files as output, its allowed. * prog_files/ blat.exe buttons.gif settings.dat.cgi ( Writable / 666 Permission ) setup.dat.cgi ( Writable / 666 Permission ) spacer.gif * prog_templates/ about.html _admin_login.html _admin_setup_edit.html _create_form.html _delete_form.html _list_forms.html _menu_bar.html _modify_form.html 4. You should now have the program setup correctly. Access the admin.cgi file using your web browser. Access the URL to admin.cgi with your browser to run the admin program. Two Example Forms will be listed. Click on the View link for either form listed to access & fill out the form. The Example forms will not send emails until you modify the settings for it to send emails. You will need to check the mailing options for this to be done & set the email fields. ------------------------------------------------------------------ - Creating Forms to use with Form Manager ------------------------------------------------------------------ Creating HTML Forms to use with Form Manager requires you use a few specific tags inside your
to
tag. These HTML Form files are to be stored in the /html_forms/ directory with a .html file extension. This directory resides in the directory the Form Manager CGI Files are in. The following tag needs to be inserted under the
tag on the final page the user would fill out. If its a single page form, insert it on that page. If you are creating a multiple page form, insert this tag on the last page the user will view. --------------------------------------------------------------- * TO START --------------------------------------------------------------- $form_values$ The $cgiurl$ variable reference above will be replaced with the filename of the form program. --------------------------------------------------------------- * SETTING REQUIRED FIELDS --------------------------------------------------------------- Follow the format above to set required fields inside the current page you are working with. the value of this tag is: "field_name:Required Field Description" To set more than one required field, use this format above, separted by a comma as shown in the example tag above. If a required field is not filled in, the user will be shown the required description which is to the right of the : in the name="required" tag. If a required field is not filled in the page will be returned to the user with the requried descriptions being displayed on the page where you have placed this tag: The form field name="email" is for the users email address. This field is set to be required will be also checked for correct email syntax. --------------------------------------------------------------- * MULTIPLE PAGE FORMS --------------------------------------------------------------- ------------------------------- * SENDING A USER TO THE NEXT PAGE ------------------------------- Creating a Multiple Page form using Form Manager requires you to specify the next page to be shown from the one the user is currently viewing. You also have the option to setup the option to return to the previous page they filled out. These pages are also to be stored in the /html_forms/ directory. - Fields Associated with Going to the Next Page: name="next_page" is the page next that the user will be shown after they successfully complete the page they're on. Do not enter the file names extension in this field. Leave ".html" off the value. name="next" is the submit button that takes them to the next page. You can set the value of this field to whatever you would like (IE: Continue / Go to Next Page). ------------------------------------------------ * SENDING A USER TO THE PREVIOUS PAGE THEY WERE ON ------------------------------------------------ Use the fields below to send a user back to the previous page they were on. This lets a user check or change the information entered on a previous page before they finalize / submit their data. name="last_page" is the previous page name that the user will be sent back to. Do not enter the file names extension in this field. Leave ".html" off the value. name="previous" is the submit button that takes them back to the previous page they viewed. You can set the value of this field to whatever you would like (IE: Previous Page / Go Back). ------------------------------------------------ * KEEPING FIELDS ALREADY ENTERED SELECTED ------------------------------------------------ Form Manager will keep track of the fields already entered so the user does not have to re-type them in as they move back and forth between pages, or if they submit the page and a required field still needs to be entered. ------------------------------------------------ * Regular Text Entry Field ------------------------------------------------ Your Name: Entering $field_name$ in the value="" section of the input field will pre-fill that field in if it was already entered. field_name = the text/name inside name="" ------------------------------------------------ * Radio & Checkbox Form Selection ------------------------------------------------ Yes
checkbox For a radio or checkbox button its a bit different from a regular text field. Take the name of the field as above "us_resident", the actual value of the selection which above is "Yes" and the word checked and add them all together, with an underscore separating them. Result: us_resident_Yes_checked If your value="" has a space in it (value="Yes US Resident" replace the spaces with an underscore. Result: us_resident_Yes_US_Resident_checked Placing dollar signs around that text to get: $us_resident_Yes_checked$ and placing it after value="" will keep the users selection checked should they not fill in all required fields, or go back and forth between the last & next page. ------------------------------------------------ * Drop Down Form Selection Box ------------------------------------------------ Gender: For a dropdown menu its a bit different from a radio or checkbox field. Take the name of the field as above "gender", the actual value of the selection which one above is "Male" and the word selected and add them all together, with an underscore separating them. Result: gender_Male_selected If your value="" has a space in it (value="space value") replace the spaces with an underscore. Result: gender_space_value_selected Placing dollar signs around that text to get: $gender_Male_selected$ and placing it after value="" will keep the users chosen option selected should they not fill in all required fields, or go back and forth between the last & next page. ------------------------------------------------------------------ - Frequently Asked Questions ------------------------------------------------------------------ Q) The script is producing a Internal Server Error when I view the .cgi script w/ my browser: * A) This could be because of several reasons. First, did you upload the .cgi script in ASCII Mode? Set the CGI Script to mode 755 (chmod 755 filename.cgi) or not have the correct path to Perl5 as the top line? If the above checks out, at telnet type: perl -c filename.cgi - This will tell you what errors perl has found with the script. If you happen to get a syntax error, it may be because you're not using a recent version of perl 5. If you get a syntax OK message back, check again the first set of possible problems. To find where perl5 is on your server type: whereis perl5 To find which version of perl is at /usr/bin/perl type: perl -v ------------------------------------------------------------------ - Product Support ------------------------------------------------------------------ If you need support for this product please visit: * http://www.cgi-world.com/support.html or e-Mail Us @: * support_request@cgi-world.com or Visit Our Contact Us Page @: * http://www.cgi-world.com/contact_us.html ------------------------------------------------------------------ - Copyright & Author Notes ------------------------------------------------------------------ Form Manager - All Rights Reserved. Copyright CGI World CGI World (http://www.CGI-World.Com) CGI World is a Prouct of i2 Services, Inc. (http://www.i2-Services.Com)