FormJobber™ will submit your form to more than one CGI program and/or other form handling software or web page.
The information from the form can be submitted to individual destinations with a choice of method GET or method POST.
Note: FormJobber™ can not process file uploads.
Three files need to be uploaded to your server into a directory that can run Perl CGI programs:
FormJobber.pm FormJobber.cgi FormJobberCP.cgi
Upload these with an FTP program as ASCII/plain text.
Note that some FTP programs do not automatically transfer .pm or .cgi files as plain text. If you get an Internal Server Error when you try the program, this is the first thing to check.
Once uploaded, give these two files:
FormJobber.cgi FormJobberCP.cgi
755 permissions. File FormJobber.pm does not need its permissions changed — although it doesn't hurt if you want to give it 755, also.
You're probably done with the installation at this point. However, depending on how your server is configured, you might need to manually create the data subdirectory.
When you use the control panel (see below), FormJobber™ will automatically try to create the data directory it needs. If you specify some information (like a new password) in the control panel and save it, and the information isn't remembered, then it was unable to create the data directory and you'll need to create it manually.
Create the data directory manually only if required. Letting FormJobber™ create it is preferred, so long as it can.
To create the data directory manually:
First, let's define what a submission sequence is.
Submission Sequence:
The URLs, in correct order, where
the information submitted by the form should be sent.
This information is easily listed in the control panel.
When you first use the control panel, you'll be asked to provide a password to be used for future access. Once that's done, you'll see the control panel Main Page.
On the Main Page, you can provide general configuration information, change the password, log out, add a submission sequence, and edit any submission sequence previously added.
This section provides FormJobber™ with the information it needs to send email. It's entirely optional.
If you want to be notified whenever FormJobber™ experiences a noticeable failure when submitting information, provide the sendmail location and the email address the notification should be sent to. Noticeable submission failures are any that return a status code other than 200-Okay or return no status code at all.
Use this link to change the control panel password.
It is a good idea to log out when done with the control panel, especially if people not authorized to use the control panel have access to your computer.
A submission sequence is the list of URLs, in order, where the form's information should be sent.
At the top of the page, provide a name for the submission sequence. This is for your recognition, and will be listed on the control panel Main Page. This is a required field.
The next item on the page is optional, a text box that can be used to list any hidden field names and their values that you want to be included with the form information when it is submitted to the URLs in the submission sequence.
One could use this to send along information that shouldn't be in the source code of the web page. Two examples: Hidden fields containing a "thank-you" page URL might provide information for someone to bypass the form. Hidden fields containing an email address can be vulnerable to spammer's harvesting robots. This text box, then, provides the means to include information not submitted with the form itself.
Use one line for each hidden field and value set — type the field name, one or more spaces, then the value. Field names may not contain spaces. Do not enclose values within quotation marks unless you mean the quotation marks to be part of the value. Example:
redirect http://example.com/ email name@example.com secret The name is Mr. Fortune
Below the text box are 3 sets of form fields, numbered. (Use only as many as you need.)
Each set asks for the URL where the form information shall be submitted to. And it asks whether the information shall be submitted as method GET or method POST.
Note:
If you need more than the available sets, edit the sequence.
When a sequence is edited, an extra blank URL/method form field set is made available.
The last form field on the page is optional.
If used, it specifies the URL where the form user's browser will be redirected — the "thank you page". The redirect happens after the form information has been submitted to all the locations in the submission sequence. The URL can be absolute or relative to FormJobber™'s installation location.
If you choose not to provide a redirect URL, then the web page response received from the last URL in the submission sequence will be displayed in the user's browser.
To edit a sequence, click the sequence's Edit button on the Main Page.
Any information provided when the sequence was added can be edited. In addition, an extra blank URL/method form field set is made available.
Deleting a submission sequence requires two actions, checking the checkbox and clicking the Delete button. Both checkbox and button are on the Main Page.
When you click the name of a sequence on the Main Page, a popup window is created that contains information needed by the form to integrate it with FormJobber™
Before integrating it with FormJobber™, verify the form submits to all URLs in the sequence, tested individually, without error.
When ready to integrate with FormJobber™, do these two steps:
Replace the form's action attribute value with the URL to FormJobber™ — the URL may be absolute or relative.
Open the control panel's Main Page and click on the sequence name. The click opens a popup window containing the HTML code for a hidden field. Copy this hidden field and paste it into the source code of your form.
Test your form before going live with it.
Please see the Support Forum for technical support.