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 3.2.2 Free FormMail Manager

Supported Servers : Unix, Linux, FreeBSD, Sun, BSDOS, Mac, Windows
Price : Free
Requires : Perl / cgi-bin
Version : 3.2.2
Original Release Date : August 1999
Latest Release Date : August 2009
F.A.Q : Click here for F.A.Q.
Users Guide : Click here for Users Guide
Online Demo : Admin Section

Multiple Page Form Mailer

Page 1   Page 2

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

  6. Default Settings
    1. Aesthetics
    2. Email Settings
    3. File Settings
    4. Miscellaneous
    5. Form Field Sorting Order
    6. Admin Notification Template
    7. Customer Notification Template
    8. Website Error Pages Template
    9. Preview Page Template
    10. 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="Hidden" 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.

    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




    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


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