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.
All Form Processor Pro - the Web Form Processor of Choice.
|
 This 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.
|
Multiple Page Form Handler
Page 1 Page 2 Combined- Disclaimer
- Introduction
- Requirements
- Configuration
- Installation
- Default Settings
- Aesthetics
- Email Settings
- File Settings
- Miscellaneous
- Admin Notification Template
- Customer Notification Template
- Form Field Sorting Order
- Website Error Pages Template
- Custom Error Messages
- Preview Page Template
- Thank You Page Template
- Creating your first form
- Creating your first Multi-Paged form
- What you should do
- What you should not do
- Managing Single Forms
- Managing Multi Page Forms
- Managing MultiPaged Forms
- How to redirect to next form
- Viewing Multi-Page Form Submissions
- Edit Multi-Page Form Submissions
- How to add custom form fields and file uploads
- How to require fields
- Download / Export Form Submissions
- Markers %%% - %%%
- 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.
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 :
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.
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.
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
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.
PasswordErrorr 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.
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
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
Page 1 Page 2
