All Scripts backed by 10 years in business, free support, free updates and a 30 day money back guarantee.
Download Purchase Programming F.A.Q. Support Contact
Commercial Perl Scripts
All Form Pro Updated
Count It
Form Mailer + Attachments
Client File Manager
Da Godfaddah
Dropbox Updated
FAQ Builder
HT Manager Updated
RegisterHT
Mailing List Server
Page Updater - Text
Page Updater Pro Updated
PS Guestbook Updated
PS Lightning Search Updated
Quick File Mailer
Quick MySQL
Select-A-File
Upload Center
Free Perl Scripts
Access Log Viewer
All Form
Epoch Converter
Error Log Viewer
Invoice Center
PS Upload
Question Manager
Quick CHMOD
QuickHT
Site File Finder
Site File Lister
SSI Tag Maker
Perl Modules
Monger Calendar
Monger File
Monger Mail
Monger Persist
JavaScript Generators
PopUp Windows
Meta Gen
RGB / Hex Converter
Page Colors
Sudoku
Tutorials and FAQs
Cookies
Using CuteFTP
Using WS_FTP
Installing Scripts
Debugging
Utilities
env_vars.pl
backup.pl
restore.pl
check_email.pl
date.pl
dayname.pl
fileage.pl
format_length.pl
format_url.pl
getfile.pl
parse.pl
redirect_html.pl
Free Services
Epoch Converter
TLD Registries
RGB/Hex FInder
Colour Checker
ASCII Codes
Policies
Terms and Conditions
Privacy Policy
Refund Policy
Site Map

Form Processor with no SPAM from robots.

Anti-spam, anti-robot, anti-flame, Guestbook for your website.

Manage Remote websites from your website. Allow clients to update sections of their own web pages.

Secure file manager with upload progress meter. A printer's best friend. Find out more.

All Form Processor Pro - the Web Form Processor of Choice.

 
Supported Servers Unix, Linux, FreeBSD, Sun, BSDOS, Mac, Windows
Price USD $69.00
Requires Perl / cgi-bin
Documentation F.A.Q. Users Guide Demo
Quality Perl Script GuaranteeThis Perl Script has been quality guarantee stamped by our customers. If this script does not perform for you on your server as advertised, we'll issue you with a full refund plus a 10% credit voucher.

Multi-Page Form Manager

  1. Disclaimer
  2. Introduction
  3. Requirements
  4. Configuration
  5. Installation

  6. Default Settings
    1. Aesthetics
    2. Email Settings
    3. File Settings
    4. Miscellaneous
    5. Admin Notification Template
    6. Customer Notification Template
    7. Form Field Sorting Order
    8. Website Error Pages Template
    9. Custom Error Messages
    10. Preview Page Template
    11. Thank You Page Template

  7. Creating your first form
  8. Creating your first Multi-Paged form
  9. What you should do
  10. What you should not do

  11. Managing Single Forms
    1. Managing Forms
    2. How to redirect
    3. Viewing Form Submissions
    4. Edit Form Submissions

  12. Managing Multi Page Forms
    1. Managing MultiPaged Forms
    2. How to redirect to next form
    3. Viewing Multi-Page Form Submissions
    4. Edit Multi-Page Form Submissions

  13. How to add custom form fields and file uploads
  14. How to require fields
  15. Download / Export Form Submissions
  16. Markers %%% - %%%
  17. Support

Please read the Perl Services Licensing Agreement

By downloading, purchasing, acquiring and/or implementing any PerlServices software, you agree to be bound by the terms and conditions of the distribution policy.

To Top




Introduction

Thank you for choosing AllForm Pro as your solution for Multi-Page Form Management and Processing. This CGI formmail manager provides you with the ability to create and manage multiple forms and multiple multi-paged forms, each with the ability to transfer files from your website to your server, show previews of form data entered, and return file attachments to both Admin and Customers in personalized, customized email autoresponders.

We strongly recommend you take the time to read this User Guide in it's entirety to get the most out of AllForm Pro and to make the task of creating Multiple Single and Multi Page forms as easy as possible.

To Top




Requirements

AllForm requires Perl with a functioning cgi-bin. The CGI Perl Module, standard with all Perl installations is also required.

To Top




Configuration

Path To Perl
All CGI programs written in Perl must start with a line that tells the web server where to look for the Perl interpreter. This means the very first line of each of the .cgi or .pl files MUST be the path to Perl. Here are some examples of common paths to Perl:

#!/usr/bin/perl
#!/usr/bin/perl5
#!/usr/lib/perl
#!/usr/local/bin/perl

This program was shipped with a default path of: #!/usr/bin/perl

On most servers, this should be all that is required. You do not have to set any variables.

This program uses our advanced set-up routine, which will resolve paths, create directories and set permissions on data directories. If the program encounters a problem during the set-up process, you will be given specific directions on what to do. If the instructions given don't allow you to successfully install the program or you are not comfortable following the instructions, contact us through the Perl Services Support

To Top




Installation

To install this program, you must have an FTP client and be familiar with how to use it's basic functions. If your not sure how to achieve any of the stated functions or commands with your FTP client, please refer to our tutorial on installation and on using FTP clients at:

http://www.perlservices.net/perlfaqs/index.html

Having set the path to Perl, it's time to install the program.

Here are the installation steps:

1. Open your FTP client and connect to your web space.

2. In your cgi-bin create a sub-directory with any legal name that you want (i.e. "uploads").

3. CHMOD this sub-directory to 755 (rwx-rx-rx).

4. Change into this sub-directory with your FTP client.

5. Making sure your FTP client is set to transfer in ASCII mode and not binary mode, transfer all files into the newly created sub-directory.

6. CHMOD all files to 755 (rwx-rx-rx).

7. Launch your web browser and in the address line of the browser, type the full URL to the afp_setup.cgi script:

i.e. http://www.foo.com/cgi-bin/uploads/afp_setup.cgi

8. You should now see a set-up screen asking you to enter a User Name and Password. If you see this screen, it means the program has been configured correctly. Enter your new User Name and Password. Enter the Password a second time in the space provided. Submit the form.

Once you have received the screen that says "Set-up Successful" your program is installed, configured and ready to run. The first thing you should do is log into the admin program and click on "Settings".

To Top




Default Settings

Upon successful installation of your MultiPage Formmailer, the first item to address should be your Default Settings. The values you enter in your Default Settings are copied over to each new Form You create. Your Default Settings are accessed by clicking the link titled "Default Settings" in the Admin Control Panel.

To Top




Aesthetics

The Aesthetical Settings apply to error messages returned by AllForm Pro. These allow you to set the font and color of text printed.

To Top




Email Settings

Path to Mail Program

The default Path to Mail Program set by AllForm is :

/usr/sbin/sendmail

This applies to all Unix type servers. If this fails, try

/usr/lib/sendmail

When using /usr/lib/sendmail wait a few minutes for the email to arrive after uploading a file. If you're running AllForm on a Windows server, or the above settings do not work on your server, then you'll need to enter the path to your server's SMTP mail agent. Which is almost always

mail.YOURDOMAINNAME.com

where YOURDOMAINNAME.com is your website address.

If all of the above fails, your host will need to be contacted.

Admin Email

This is the email address for each administrator wanting to receive notification of new form Submissions. Separate each email address with a comma.

Use HTML Mail

Set this to Yes if all Mail sent by the form is to be sent in a Rich HTML Mail format. Note that if using HTML mail, your e-mail notification templates should also use HTML code for line breaks etc. This also allows you to create email messages that look like your website so recipients will instantly recognize the sender of the message.

Send Files to my Inbox

Set this to Yes if you would like all files uploaded by Customers sent to you as real file attachments in your Admin Notifications. Set to No, if you'd rather log in to the Admin section to view and download the files uploaded by Customers using your forms.



To Top




File Settings

Each Form can store uploaded files in a separate folder. Note however that Multi Page forms always use the last form's setting for the destination folder. The Default Folder and Default Web Address to Folder must both point to the same folder. The former must be the server's absolute path, and the later must be the website URL path. Maximum File sizes apply to each file uploaded, not a cumulative total file size.

To Top




Miscellaneous

Redirecting Customers

AllForm Pro allows you to redirect the Customer to a generic Thank You page after they have filled in any given form. This can be achieved in one of two ways.

1). Enter the absolute path (starting with http://) to your Thank You page in a hidden tag in your HTML form. E.g.

<input type="Hidden" name="redirect" value="http://www.google.com">

2). In the given Form's Settings, under the "Miscellaneous" tab, in the "Redirect User to" setting, enter the absolute path to your Thank You page. E.g.

It is important to note that if using Multi-Page Forms you must set a value for the hidden redirect field in the HTML code generated for your HTML pages. This value must point to the next form in your Multi Page Form series. E.g.

<input type="Hidden" name="redirect" value="http://www.google.com/form2.html">

If you do not set a value for Multi-Page forms, AllForm Pro will display an error message after the form has been filled in instructing you to do so.

Show Preview of Form

Set this to Yes for any given form's settings, whether Single or Multi-Page, if you would like a preview of Form Field names and values entered by your customers displayed before the form is actually Submitted. See also, Preview Page Template and What you should do regarding form field names.

Require Password

This setting allows you to require a password from Customers. If the password entered does not match the Password you set, the form cannot be submitted. Note that the password, if one is set, is checked only on the Last form for Multi Page forms and in all Single Page forms. The password is generic, that is, everyone who fills in your forms would enter the same password to complete the Submission. Enter any password you like here. To request a password in your forms, use the following code :

<input type="Text" name="pass" value="">

Web Link

This setting allows you to create a link that show up on the Single Page Forms page in the Admin Section. It's sole purpose is to provide a quick link from the Admin section to the location of your form. The value you enter here should be an absolute URL to a web page of your choice. Ideally, the URL to your Form.

CSV File deletions

When Exporting your Submissions to CSV file, a copy of the file is first create on your server. This file remains on your server even after you download it. You can enter a value in this Setting so that any CSV files older than the specified number of days are automatically deleted.

This setting only appears in the Miscellaneous Tab when you click on "Default Settings" in the Admin Control Panel.

To Top




Form Field Sorting Order

AllForm Pro's sorting feature allows you to control the Display order of form fields in :

  • Preview pages if Previews are switched on
  • Default order of fields in Export Wizard Form
  • View / Edit Submissions Form in the Admin Section

    To edit the Sorting Order for Single Page Forms

    Log in and while on the "Single Page Forms" page, click on Settings for the form you wish to edit. Scroll down to "Form Field Sorting Order" about half way down the page. Enter the form fields, one per line with the percentage signs. Any fields you forget to enter will still show up when editing form submissions, with a link to the Sorting Template so you can modify the order if required.

    Here's an Example

    %%%fname%%%
    %%%lname%%%
    %%%email%%%
    %%%Address%%%
    %%%City%%%
    %%%State%%%

    To edit the Sorting Order for MultiPage Forms

    Log in and click on "Multi Page Forms" page, click on Settings for the form you wish to edit. Scroll down a little to "Form Field Sorting Order". Enter the form fields, one per line with the percentage signs. Remember to include fields for all of the forms in this Series. Any fields you forget to enter will still show up when editing form submissions, with a link to the Sorting Template so you can modify the order if required.

    Note also that an inadvertent feature which became apparent when coding the Sorting feature, is the ability to create new fields in the Submission Edit form. Let's say for example you wanted to add your own comments to each Submission after the forms had been filled in and Submitted. You could the following to your Sorting Template:

    %%%AdminCommentsTA%%%

    which would create an additional field for you to add your own comments about the Submission when editing or reviewing them. Changes are recorded, stored in your database and are exportable.

    To Top




    Admin Notification Template

    This is the auto-response sent to Admin each time a form is filled in. Notifications are sent to recipients set in the Admin Email field. If you have Use HTML Mail set to Yes, your Admin Notification Template should also include regular HTML code to create line breaks, add your logos, etc. Note that absolute paths for image tags and hyper links must be used in HTML code.

    If using Plain Text format, regular carriage returns in the Admin Notification Template are preserved in outgoing messages. All available markers can be used in this template, allowing you to virtually re-create your online form, with values entered, in outgoing email messages.

    Note that if using Multi-Paged Forms, you need only edit this Template for the last form in your series.

    The Form Field Sorting Order does not apply to email notifications. To sort fields in notifications, for either Single or Multi Page Forms, click the navy colored Settings link from the Summary page for the desired Form (Multi Page Forms use the last Form's Notification Templates and Settings) and scroll down to the Notification Templates. Add desired field markers in case sensitive manner, padded by percentage signs. For example :

    %%%email%%%
    %%%fname%%%
    %%%UID%%%
    %%%IP%%%
    %%%Age%%%


    In addition to the stock variable markers, you can also use any of the form fields defined in your form. For example, if you have a form field that requests the User's email address, it would looking something like this:

    <input type="Text" name="email">

    To have the field value sent in your notification, add the name of the form field to your template as such:

    %%%email%%%

    Though for ease of understanding, you might add something like the following to your email template:

    User's email address is : %%%email%%%

    To Top




    Customer Notification Template

    This is the auto-response sent to Customers each time they fill in a form. Notifications are sent to the value entered in the form field named "email" (must be lowercase) found in your form. If you have Use HTML Mail set to Yes, your Customer Notification Template should also include regular HTML code to create line breaks, add your logos, etc. Note that absolute paths for image tags and hyper links must be used in HTML code.

    If using Plain Text format, regular carriage returns in the Customer Notification Template are preserved in outgoing messages. All available markers can be used in this template, allowing you to virtually re-create your online form, with values entered, in outgoing email messages.

    Note that if using Multi-Paged Forms, you need only edit this Template for the last form in your series. See Admin Notification Template for details on formatting this message.

    To Top




    Website Error Pages Template

    This is your entire HTML page, from <html tag to </html> tag. Somewhere in the middle of your code, you need to place the %%%content%%% marker. This marker is replaced with the Form Script generated content. That is, the form fields and values entered by your Customers.

    To edit the Website Error Page Template, log in and while on the "Single Page Forms" page, click on Settings for the form you wish to edit. Scroll down to "Website Error Page Template" near the bottom of the page. Each one of your forms, whether a Multi-Paged Form or Single Page Form, are edited from the Single Page Form Settings. If you're wanting to edit the first form in your Multi Page form series, then you would edit the Settings for the desired form.

    Enter the HTML code that makes up your entire page, and then scroll to the very bottom of the page and click the button labelled "Save all Settings" to save your changes. The Aesthetical Settings at the top of the Settings Page govern the font type used to render error messages printed by the Form Processor.

    The code for a Website Error Page might look something like the following :

    <html>
    <head><title></title></head>
    <body>
    Your logo etc. here

    %%%content%%%

    Your copyright info etc. here
    </body>
    </html>


    Remember to use absolute paths in your image tags and hyperlinks. Or start the paths with a slash which is the same as entering your website home address. See also, What you should do regarding form field names and their display on Error Pages.

    To Top




    Preview Page Template

    This is your entire HTML page, from <html tag to </html> tag. Somewhere in the middle of your code, you need to place the %%%content%%% marker. This marker is replaced with the Form Script generated content. That is, the form fields and values entered by your Customers.

    To edit the Preview Page Template, log in and while on the "Single Page Forms" page, click on Settings for the form you wish to edit. Scroll down to "Preview Page Template" near the bottom of the page. Each one of your forms, whether a Multi-Paged Form or Single Page Form, are edited from the Single Page Form Settings. If you're wanting to edit the first form in your Multi Page form series, then you would edit the Settings for the desired form.

    If you want to switch Previews off, that is you do not want to have a Previews shown to Customers filling in your forms, then in the given form's Settings, under the "Miscellaneous" tab, set "Show Preview of Form" to No, which is the default setting.

    Enter the HTML code that makes up your entire page, select the "Table Background Color" and then scroll to the very bottom of the page and click the button labelled "Save all Settings" to save your changes.

    The code for a Preview page might look something like the following :

    <html>
    <head><title></title></head>
    <body>
    Your logo etc. here

    %%%content%%%

    Your copyright info etc. here
    </body>
    </html>


    Remember to use absolute paths in your image tags and hyperlinks. Or start the paths with a slash which is the same as entering your website home address. See also, What you should do regarding form field names and their display on Preview Pages.

    To Top




    Custom Error Messages

    The Custom Error Message feature enables Administrators to print all Public Side Error messages in a foreign language. Any Error messages that may be encountered by your Web Site Visitors can be translated in to the language of choice via the Admin Section Settings. The Translations can be applied to each and every Form Managed by AllForm Pro.

    To edit the Custom Error Messages, log in and while on the "Single Page Forms" page, click on Settings for the form you wish to edit. Scroll down to "Custom Error Messages / Translations for Public Pages" near the bottom of the page. The Default Template has all Error Messages listed on one per line, in the following format :

    key || default || custom

    key: This is a required variable that must remain in each line. Each Error Code must have a key so AllFormPro can find and print the associated Error Message.

    default: This key is also required. It is the Error Message printed by default. That is, if you have not added your own Custom Error Messages, the default value is printed so your Website Visitors are aware of the problem encountered.

    custom: This key is optional. AllForm Pro ships with this key left blank. This is where you can type in Translations for each Error in a language other than English, or simply re-word the Error Message printed if you'd like it to be more descriptive.

    The following is a complete list of all keys and values required in the Current Version of AllForm Pro. If any keys/values are missing, Website Visitors filling in your Forms may be left bewildered when an error is encountered but no message is printed to the page.


    The following is a description of Each Custom Error:

    InvalideMail Traps Form Submission and prints error page if Perl detects a value in the "email" field which is not in a valid email address form.

    MissedFields Traps Form Submission and prints error page if Perl detects any fields specified in the "required" field which do not have a value. Missed fields are then printed as a comma separated list in place of the %%%fields%%% marker. Make sure the %%%fields%%% marker is included in your Custom Translation.

    UploadFailed This message is printed if a File Transfer/Upload fails for any of the following reasons. The reason encountered follows this Error Message.

    UFReason0 This File Transfer/Upload error occurs when you have specified an incorrect path to the Directory Files are to be uploaded to, or if the Directory no longer exists. Often occurs when Users transfer scripts to another server and the path has changed.

    UFReason1 This File Transfer/Upload error checks the size of files being transferred do not exceed your Admin specified limits and is trapped before the File Upload/Transfer takes place. If for some reason, the scripts cannot read the file size prior to the transfer, the new error check after the transfer.

    UFReason2 As above, except the file size is double checked on the server side.

    UFReason3 This File Transfer/Upload error checks the type of being uploaded does not breech the Admin specified acceptable files list and is trapped before the File Upload/Transfer takes place.

    UFReason4 This File Transfer/Upload error returns any other error encountered by the script and returns the Server returned error, which could be anything from "Disk Quote Exceeded" which means your out of space and need to contact your Host to have it increased, to "0 byte size" which often means you're not using the correct "enctype" attribute in your <form> tag. Be sure you always copy and paste the entire <form> tag generated by AllForm Pro as it has valid attributes and values for all types of Forms.

    PasswordError This Error Message is printed if you're using the Require Password feature which enables you to Password Protect Forms. If a password is set, only those with the current password will be able to Submit the Form it's protecting.

    BackButton This is a Regular HTML Back Button printed to the Page if any of the above Errors occur. If clicked the User is taken back to the previous page (your Form). It's printed beneath the error messages. You can either edit the HTML Code or remove it altogether if desired.

    fname Because the following three fields are recommended with each Form, the each come with a synonym printed if the Fields are missed. That is, if User forgets to enter their First Name, even though the Form Field is named "fname" the Error Message will print "First Name" as the missed field. All other fields are printed as defined in the Form Field name except all underscores (_) are auto-replaced.

    lname As above.

    email As above.

    Months This enables you to enter Month Names in your primary language. Month names are applied to the %%%Date%%% marker, which can be used in email notifications and the Thank You page. Separate each month name with a space.

    Ords This enables you to enter the ordinals for each day of the month in your primary language. Ordinals, such as the 1st of January, are applied to the %%%Date%%% marker, which can be used in email notifications and the Thank You page. Separate each ordinal with a space.

    To Top




    Thank You Page Template

    Website Error Pages Template

    This is your entire HTML page, from <html tag to </html> tag. Somewhere in the middle of your code, you need to type in the message you want printed on the Thank You page. You can use any or all of the markers available to personalize the Thank You message.

    To edit the Thank You Page Template, log in and while on the "Single Page Forms" page, click on Settings for the form you wish to edit. Scroll down to "Thank You Page Template" located at the very bottom of the page. Each one of your forms, whether a Multi-Paged Form or Single Page Form, are edited from the Single Page Form Settings. You only need edit the Thank You Page Template for the very last form in a Multi-Paged series of forms.

    Enter the HTML code that makes up your entire page, and then scroll to the very bottom of the page and click the button labelled "Save all Settings" to save your changes.

    The code for a Thank You Page might look something like the following :

    <html>
    <head><title></title></head>
    <body>
    Your logo etc. here

    Thank you for filling in our form %%%fname%%%

    Your copyright info etc. here
    </body>
    </html>


    Remember to use absolute paths in your image tags and hyperlinks. Or start the paths with a slash which is the same as entering your website home address.

    Alternatively, you can redirect the Customer to a generic Thank You page. This can be achieved in one of two ways.

    1). Enter the absolute path (starting with http://) to your Thank You page in a hidden tag in your HTML form. E.g.

    <input type="Hidden" name="redirect" value="http://www.google.com">

    2). In the given Form's Settings, under the "Miscellaneous" tab, in the "Redirect User to" setting, enter the absolute path to your Thank You page. E.g.

    http://www.google.com

    To Top




    Creating your first form

    After you've entered your preferred Default Settings, click on "Create new" in the Admin Control Panel. Enter any reference name of the new form, it can be renamed later via the Form's Settings. If this is a Single Page form, you're done. You can Configure the Settings for this form at any time. To generate the minimum required code for this Single Page Form, click on the Form Name while on the "Single Page Forms" page. The code will appear in the Text box at the bottom of the same Page. Copy and paste that code to a regular HTML document and then load it in a browser to immediately use and test the form. You will of course need to upload that HTML document to your website when you're ready to go live so your Website visitors can also use the form.

    Note that the Same forms can be used as Single or Multi Page forms. AllForm Pro ascertains the type of form it is by reading the code generated for either.

    If it's a Multi Page form you're creating, see the next section.

    To Top




    Creating your first Multi-Paged form

    After you've created your first form, you will need to create every other form you wish to include in this MultiPage series of forms. Repeat the process of Creating form by clicking on "Create new" in the Admin Control Panel for each form you wish to create.

    Once you've created all desired forms, click on "Multi Page Forms" in the Admin Control Panel. Use the Form Combiner to create the structure and sequence for your Multi-Paged Form. That is,

    1). select a Form from the list of current forms (all forms you have created using "Create new") on the left side of the page by clicking on it.

    2). Click on the button labelled "Add Form -->"

    3). Repeat steps 1 and 2 until the list of forms on the right contains all forms that will make up the Multi Page Form.

    4). Sort the order of your forms using either the "Move Up" or "Move Down" buttons on the far right.

    5). Enter any reference name for this Multi Page Form in the field provided.

    6). Press the Button labelled "Save".

    The page will reload and you'll the beginning of a list underneath the Form Combiner Tool. This list allows you to :

    1). Edit the Name or sequential order of forms for the Multi-Page form you just created by clicking on the Name.

    2). View and edit any submissions made for this form by clicking the Number in the Submissions column.

    3). Generate the HTML code required for this series of Forms by clicking the "Get Code" link.

    4). Delete the Multi-Page Series structure.

    As with Single Page forms, the code for MultiPage Forms must be copied and pasted to your own regular HTML documents. Be sure to enter a value in the "redirect" field for each of the forms in your MultiForm series, except, unless desired, for the last Form in the series.

    The redirect field must point to the HTML page you created for the next form. For example, let's say you create a 2 page series of forms. You copy the generated code for the first form to a HTML page you name form1.html and the generated code for the second form to a HTML page named form2.html

    The hidden redirect field in your first form in form1.html must point to form2.html and must begin with http:// like such:

    <input type="Hidden" name="redirect" value="http://www.YOURWEBSITE.com/form2.html">

    To Top




    What you should do

    There are few do's and do not's to keep in mind while using AllForm Pro. What you should do is listed here.

    1). Read this User Guide in it's entirety before creating any forms. You will be glad you did and it will make for a smooth and enjoyable experience with AllForm Pro.

    2). Set your Preferred Default Settings before creating any forms, in particular, the Admin Email address, Admin Name, Website Name and the Website Template. This is because it is these Settings that are copied over to each new form you create. If you plan to only create 1 or 2 forms, this is not so important, however if you plan to create more than a few forms, setting the Defaults will save you time.

    3). When adding additional file upload fields, make sure the name of the field is "FILEx" where x is any unique number and FILE is in uppercase. For example if you wanted to allow up to three file uploads in a form, you could use:

    <input type="File" name="FILE1">
    <input type="File" name="FILE2">
    <input type="File" name="FILE3">


    You can use as many as you think your server can handle.

    4). When adding Custom form fields to any form, use descriptive field names and underscores instead of spaces. This is because the Preview Pages, Error Pages and Admin Section list the filed names adjacent to the data entered by Customers. For example, lets say you had a required field in your form that requested the Customer's Country of Birth. We suggest you use this:

    <input type="Text" name="Country_of_Birth">

    This way, if the Customer forgets to enter their Country of Birth, the Error page will display:

    Error you forget to enter the following fields

    Country of Birth

    The form processor will replace the underscores with spaces. If you had entered,

    <input type="Text" name="countryborn">

    the error page would display

    countryborn

    which may not be very helpful for the Customer. So keep the form field names short but descriptive. Being concise is the key.

    5). When adding Textareas (large text box fields), append "TA" to the form field name. This is so AllForm Pro's form processor knows they are Textareas and retains the line breaks in Plain Text email, HTML email and when viewing Admin Section Submissions. This does not apply to the "comments" field. For example:

    <textarea name="comments"></textarea> good

    <textarea name="BioTA"></textarea> good

    <textarea name="Bio"></textarea> bad

    <textarea name="InstructionsTA"></textarea> good

    <textarea name="Instructions"></textarea> bad

    6). Send us your feedback. If you purchased AllForm Pro, you have an email address to get in touch with us directly. You made quite an investment in your Multi-Page Form Handler and we want to be sure you're happy with it, with it's performance and it's usability, integrity and stability. We encourage all feedback and suggestions for improvement.

    To Top




    What you should not do

    There are few do's and do not's to keep in mind while using AllForm Pro. What you should NOT do is listed here.

    1). Do not change or alter the fname, lname and email form fields generated by AllForm Pro. They must be in lowercase and must be in your forms. They can be placed in any one of your Multi Paged forms. If you remove them, Customer Auto-responders will be sent to Admin with "No Name" as the name of the Customer. You can remove the FILE1 field and comments fields generated. These three fields have synonyms used by AllForm Pro which are displayed on Error Pages, Preview Pages and in the %%%ALLFIELDS%%% marker.

    2). Do not ignore any of the pointers given in this section and the section immediately above.

    To Top




    Managing Single Page Forms

    Viewing and Managing Single Page Forms forms is accomplished via the "Single Page Forms" page, which is the first page you see once you log in to the Admin Section. Functions available are listed in sortable columns. Click on the desired links in the row associated with the desired form.

    To Top




    How to redirect Single Page Forms

    You can redirect the Customer to a generic Thank You page after a Single form has been successfully submitted. This can be achieved in one of two ways.

    1). Enter the absolute path (starting with http://) to your Thank You page in a hidden tag in your HTML form. E.g.

    <input type="Hidden" name="redirect" value="http://www.google.com">

    2). In the given Form's Settings, under the "Miscellaneous" tab, in the "Redirect User to" setting, enter the absolute path to your Thank You page. E.g.

    http://www.google.com

    To Top




    Viewing Form Submissions

    Viewing Submissions made to Single Page Form is accomplished via the "Single Page Forms" page, which is the first page you see once you log in to the Admin Section. Click on the Numbers in the Submissions column in the row associated with the desired form. This will load a complete synoptic History of Submissions for the selected form in chronological order (most recent Submission last). Click on the Date of any given Submission to view it's details. Remember, the order of fields in which these Submissions are displayed is governed by your Preferred Form Field Sorting Order.

    To Top




    Edit Form Submissions

    To edit a Submission made to a Single Page Form:

    1). Click on "Single Page Forms" in the Admin Control Panel.

    2). Click on the Numbers in the Submissions column in the row associated with the desired form.

    3). Click on the Date for the desired Submission in the Synoptic History.

    4). Apply desired edits.

    5). Scroll to bottom of Page and press the button labelled "Save Edits".

    If you check "Go back to Synopsis after saving" the Synoptic History page will be loaded after the saving the edits, otherwise the same (updated) Submission is reloaded with the edits having be recorded.

    To Top




    Managing MultiPaged Forms

    Viewing and Managing Multiple Page Forms forms is accomplished via the "Multi Page Forms" page, which is accessed via the Admin Control Panel. Functions available are listed in sortable columns underneath the Form Combiner tool. Click on the desired links in the row associated with the desired form.

    To Top




    How to redirect to next form

    It is important to note that when using Multi-Page Forms you must set a value for the hidden redirect field in the HTML code generated for your HTML pages. This value must point to the next form in your Multi Page Form series. E.g.

    <input type="Hidden" name="redirect" value="http://www.google.com/form2.html">

    If you do not set a value for Multi-Page forms, AllForm Pro will display an error message after the form has been filled in instructing you to do so. Be sure to enter a value in the "redirect" field for each of the forms in your MultiForm series, except, unless desired, for the last Form in the series.

    The redirect field must point to the HTML page you created for the next form. For example, let's say you create a 2 page series of forms. You copy the generated code for the first form to a HTML page you name form1.html and the generated code for the second form to a HTML page named form2.html

    The hidden redirect field in your first form in form1.html must point to form2.html and must begin with http:// like such:

    <input type="Hidden" name="redirect" value="http://www.YOURWEBSITE.com/form2.html">

    To Top




    Viewing Multi-Page Form Submissions

    Viewing Submissions made to Multi Page Form is accomplished via the "Multi Page Forms" page, which is accessed via the Admin Control Panel. At the bottom of the "Multi Page Forms" page is a list of all Multi-Paged Forms you have created. Click on the Numbers in the Submissions column in the row associated with the desired form. This will load a complete synoptic History of Submissions for the selected form in chronological order (most recent Submission last). Click on the Date of any given Submission to view it's details. Remember, the order of fields in which these Submissions are displayed is governed by your Preferred Form Field Sorting Order.

    To Top




    Edit Multi-Page Form Submissions

    To edit a Submission made to a Multi-Page Form:

    1). Click on "Multi Page Forms" in the Admin Control Panel.

    2). Click on the Numbers in the Submissions column in the row associated with the desired form.

    3). Click on the Date for the desired Submission in the Synoptic History.

    4). Apply desired edits.

    5). Scroll to bottom of Page and press the button labelled "Save Edits".

    If you check "Go back to Synopsis after saving" the Synoptic History page will be loaded after the saving the edits, otherwise the same (updated) Submission is reloaded with the edits having be recorded.

    To Top




    How to add custom form fields and file uploads

    When adding additional file upload fields, make sure the name of the field is "FILEx" where x is any unique number and FILE is in uppercase. For example if you wanted to allow up to three file uploads in a form, you could use:

    <input type="File" name="FILE1">
    <input type="File" name="FILE2">
    <input type="File" name="FILE3">


    You can use as many as you think your server can handle.

    To Top




    How to require fields

    If you want some of your forms fields to be required, for either Single page or Multi Page Forms, then you specify those field names in a hidden field. Separate each field name with a comma but do not add any spaces. For example, if you had three fields you wanted required:

    <input type="text" name="email">
    <input type="text" name="address">
    <input type="text" name="city">


    ....then you would specify these as required fields using the following hidden field:

    <input type="hidden" name="required" value="email,address,city">

    Note that in Multi Paged Forms, each form in the Series must have it's own hidden "required" tag that lists the required fields found in that form.

    To Top




    Download / Export Form Submissions

    Exporting your submissions is achieved via the Export Wizard. Click the numbers in the Submissions column for either Single Page or Multi Page Forms. This will load a History of Submissions for the Selected Form. At the top of the page, beneath the Admin Control Panel, you'll see a link titled "Export CSV file". Click the link to load the Export Wizard.

    The Export Wizard lists the fields found in your first and last Submissions. If there are additional fields in other Submissions (for example fields you have removed from your forms since first creating them), you can enter those field names in the spaces provided. The default order of fields shown in the Export Wizard is governed by your Preferred Form Field Sorting Order for the selected form.

    To Export your data:

    1). Enter the column position for which the fields should appear in the results.

    2). Remove any fields from the Export Wizard which you do not wish to Export.

    3). Scroll to the bottom of the Export Wizard and select either "Print to Browser" in which case the results are printed to your Browser window, or "Export CSV" in which case a CSV file is created and then loaded in your browser.

    If Printing to Browser, view the resulting page's source code and save the file to your hard drive. The source code has each record on a separate line.

    If Exporting to CSV file and you have MS Office installed on your computer, the results are loaded in an Excel Spread Sheet inside your browser. You must then save the file. If you do not have MS Office or MS Excel installed, a download dialogue box will appear asking you to save the file to your hard drive.

    If the Export Wizard points you to a 404 error page or to http://www.yourservername.com/, you need to edit the afp_key.cgi file and enter your actual domain name in the $ExportURL variable on line 28. E.g.

    $ExportURL = "http://www.YOURSERVERNAME.com/psjs_datalogs/afp$FolderPass/data";

    To Top




    Special Markers

    The Special Markers available can be used in all Templates. The markers themselves are replaced with Customer Submitted data, allowing you personalize and customize e-mail notifications, Website Error Pages, Preview Pages and Thank You pages, including the ability to link directly to files uploaded, print just the file names and print the server paths to uploaded files.

    A full list of available markers is available from with the Admin Section. Log in and click on any of the Settings links. Scroll down to the "Admin Notification Template" and click on "Full list of Markers" to pop open a new window with instructions on using the markers.

    To Top




    Support

    If you have difficulties setting up this program, we can install it for you. The installation fee for AllForm Pro is free for the first installation. If this is your first installation, use the following Credit Card Number: 1111 1111 1111 1117. Installation can be ordered via our Secure Online order form. If we are unable to install the program because of a problem with the program the purchase price of the script will be refunded in full.

    To Top





  •   ©2009 All rights reserved, PerlServices.net. Website hosting by LinuxHostingPlans.com