Details:
A “Form” page/section enables you to setup a custom form to gather information
from your visitors and users. The information is gathered through textfields,
checkboxes, radio buttons, drop-down menus, and other interface items which
you specify, and sent to an email address of your choice. Information submitted is
also stored in the backend database, and can be browsed directly here, in the
Admin. The form may optionally contain a captcha, to help avoid spamming.
The Form Editor has 2 main buttons - “Add Field” and “Settings” - as well as 2 sub-
sections - “Modify/Delete Field” and “Submissions”.
Add Field Button: Click this button to add an interface item to your custom form.
Once clicked, your options will be:
Title: the name of the item, which is displayed on the form
Type: can be one of:
Heading: a 'title' or emphatic text that appears on the form.
Short Text: a single-line text field.
Long Text: a large, multi-line text field.
Select Box: a drop-down menu - or listbox (multiple selections on).
Checkbox Group: specify from one to several checkboxes – each checkbox can be
ticked on or off separately from the others.
Radio Button Group: a series of options, where only 1 can be selected at any
given time – selecting one, deselects the others.
Email Address: a single-line text field, where the user must enter a properly
formatted email address – if text which is obviously not an email address is
entered, the form will not be submitted.
Save/Cancel Buttons: click to save the entered Title and Type, or to cancel, and
return to Admin->Pages->Modify Page.
When should you use a Radio Button Group, and when should you use a Select
Box instead?
The rule-of-thumb is, that if there are more than 3 options available, you should
use a Select Box.
Additional options
Once you click the “Save” button for the first time, become available for the
interface item you've chosen, depending on its type:
Heading: in the “Template” field, you can specify - using a combination of html and
Site Editor markup - the layout in which the heading appears.
Short Text: set the length (in characters) of the field, default text to appear in the
field, as well as whether the field is required – see below.
Long Text: specify default text to appear in the field, as well as whether the field is
required – see below.
Select Box: can enter the options to be listed, and optionally a specific size for the
menu/box. If “Allow Multiple Selections” is “Yes”, then it becomes a listbox,
otherwise it displays as a drop-down menu. You can also specify whether a
selection is required – see below.
Checkbox Group/Radio Button Group: can enter the options to be listed, as well
as an optional separator character to be put between each option. Can also
specify if a selection is required – see below.
Email Address: specify whether it is required – see below.
If an item is marked required, then the form is not allowed to be submitted, unless
the user has entered information or made a selection in this item.
Settings Button
Click this button to configure the functionality of your form. Once clicked, your
options will be:
Header: a mixture of html and Site Editor markup code that opens the form.
Field Loop: a mixture of html and Site Editor markup code that is repeated for
every
interface item defined in the form.
Footer: a mixture of html and Site Editor markup code that closes the form.
Email To: the email to which form submissions will be sent.
Note: You need to enter a valid mail address, otherwise no emails will be sent -
sounds logicall doesn´t it?
Email From: submissions are going to be sent, as if they were from this address.
You can pick an Email Address field from the list, if your form has one, or enter a
specific email address in the field.
Email Subject: the subject heading of the emails sent by the form.
Success Message: when the form information is submitted successfully, the user
is shown this message.
Max. Submissions Per Hour: low numbers helps avoid spammers.
Submissions Stored In Database: the number of submissions that the database
will store – when number is exceeded, oldest is thrown out.
Captcha Verification: displays a captcha, to help avoid spammers.
In your email client, you can setup a Rule/Filter that automatically handles
(highlights, archives, etc.) all the messages from your website form, based on the
Email Subject.
See your email client documentation for details.
Modify/Delete Field
Use the “Modify/Delete Field” list to reorder, edit and delete the interface items that
comprise your form.
To edit the settings of an existing item, click on its “settings” icon, or its title.
click on the item's “settings' icon – or on the title itself
To delete an item, click on its “delete” icon.
To move the item up or down in the form, click the item's “up” or “down” icon.
Submissions
The list in this section will contain the submissions of users and visitors who
have used your form. Only a finite number of submissions is stored in the
database – by default, 100. You can change this number in the form's Settings.
You can use the list to view and delete the submissions received.
To view a stored submission, click the “submission folder” icon.
To delete a submission, either click the “delete” icon for that submission here in
the list, or, while viewing the submission, click the “Delete” button.