HomeEventsLoginRegister Help
 GeneralMy eventsEvent options Form editorGlossary

Formarama Help : Form Editor

General

Every event must have an input form to populate the results list.
An input forms consist of form elements: text lines and input controls. Text lines are just for decoration and explaining things on the input form (the only place where they are visible). Input controls request interaction of the user (subscriber), like filling in their name fields or to select a choice. Labels for these control appear later as column headings on the subscription list.

The form editor enables you to add or edit text and controls to your form, to delete them or move them up or down on your form or to change their behavior.
 



The Form Editor


When you add or edit a form element, an edit box will appear on the place where you want to add the element. Every control has a set of attributes, which are explained below.
Each input control must have a unique label. This label is used as column heading in the result list.




Editing a control on your form
 

Hiding input controls on the input form

You can hide an input control on the input form for users by using the checkbox 'Hide when not logged in'
 

Unchecked: Everybody will see this control and can therefore use it.

Checked: You will only see this control when you are logged in.
Reasons why you want to do this, could be that you want to add some information later to a subscription, like payment status or just a remark.


Hiding Fields on the result page

Each control has three options for the subscription list:

 

Always Show: As it implies, this column will always be visible for everybody
 

    

Show when logged in: Only you as the registrar or the power-user of the event can see the result. Use this option for sensitive information like emails, or just to de-clutter the subscription list to keep it simple for the user
 

Never show: Nobody will see this column, even when logged in or as a Power User.
Use this option for including for example an invisible sort field like rank

Form Elements

The next overview list the controls with their attributes and possible settings.

| Top | Text line | Text Box | Text Area | Rich Text Area | Dropdown Box | Radio Buttons | Country Selector |
|
Formula |

Form Element Attributes Explanation
Text line Bold Checked: Text line will be appear in a bold typeface
Text lines are only visible on the input form, and are for decoration and explanations only

 

  Unchecked: Text line normal
Size The font size
Alignment left Text is placed in the left column
Alignment right Text is placed ion the right column
Alignment Centered text is placed centered over two columns

| Top | Text line | Text Box | Text Area | Rich Text Area | Dropdown Box | Radio Buttons | Country Selector |
|
Formula |

Form Element Attributes Explanation Icon
Text Box Required Checked: field cannot be left blank  
    Unchecked: Field can be left blank  
Example:

Text boxes are used for short inputs like names, numbers or email addresses. Input cannot exceed 100 characters.
 

 

 



 

Label Text to appear before the textbox. Cannot be left blank  
Minimum Minimum amount of characters for alphanumeric fields or numeric minimum for numeric fields. Leave blank if you don't want to check for minimum  
Maximum Maximum amount of characters for alphanumeric fields or numeric maximum for numeric fields. Leave blank if you don't want to check for maximum  
Text box type Anything: Use for alphanumeric input like names etc.   
  Numeric: Only numbers allowed
  Email: Email address
  Date: Check if the value is in the right date format. The date format is set in the page 'Event Options'
  Link: check if this field is a URL. On the subscription list this will be a clickable link.

| Top | Text line | Text Box | Text Area | Rich Text Area | Dropdown Box | Radio Buttons | Country Selector |
|
Formula |

Form Element Attributes Explanation
Text Area Required Checked: field cannot be left blank
    Unchecked: Field can be left blank
Example:

For longer textual inputs, up to 1000 characters

 

Label Text to appear before the text area. Cannot be left blank.
Minimum Minimum amount of characters. Leave blank if you don't want to check for this
Maximum Maximum amount of characters. Leave blank if you don't want to check for this
Width Width of the text area in characters.
Height Height of the text area in text lines

| Top | Text line | Text Box | Text Area | Rich Text Area | Dropdown Box | Radio Buttons | Country Selector |
|
Formula |

Form Element Attributes Explanation
Rich Text Area Required Checked: field cannot be left blank
    Unchecked: Field can be left blank
Example:

Hi, I'm used for Rich Text input



For longer textual inputs, up to 1000 characters

 

Label Text to appear before the text area. Cannot be left blank.
Minimum Minimum amount of characters. Leave blank if you don't want to check for this
Maximum Maximum amount of characters. Leave blank if you don't want to check for this

| Top | Text line | Text Box | Text Area | Rich Text Area | Dropdown Box | Radio Buttons | Country Selector |
|
Formula |

Form Element Attributes Explanation
Drop-down box Label Text to appear before the drop-down box. Cannot be left blank
Example:

Use for choices (up to ten)

 

Options Provide maximum 10 options here (minimum is two)

Advanced: you can specify value-prompt pairs as follows:

{10} I donate ten dollars
{20} I donate twenty dollars

The user sees 'I donate ten dollars' etc. but what will be stored in the database is the value 10

| Top | Text line | Text Box | Text Area | Rich Text Area | Dropdown Box | Radio Buttons | Country Selector |
|
Formula |

Form Element Attributes Explanation
Radio buttons Label Text to appear before the radio buttons. Cannot be left blank
Example:

 Male
 Female
 None of your business

Use for choices (up to ten)
Like a dropdown box, but here all choices are visible

 

Options Provide maximum 10 options here (minimum is two)

Advanced: you can specify value-prompt pairs as follows:

{10} I donate ten dollars
{20} I donate twenty dollars

The user sees 'I donate ten dollars' etc. but what will be stored in the database is the value 10

| Top | Text line | Text Box | Text Area | Rich Text Area | Dropdown Box | Radio Buttons | Country Selector |
|
Formula |

Form Element Attributes Explanation Icon
Country Selector Label Text to appear before the country selector. Cannot be left blank
Example:

Basically the same as a drop-down box, but pre-populated with the countries of the world

 

     

| Top | Text line | Text Box | Text Area | Rich Text Area | Dropdown Box | Radio Buttons | Country Selector |
|
Formula |

Form Element Attributes Explanation
Checkbox Label Text to appear before the check box.
   

Example:

  I'm a vegetarian

Use for yes/no answers

Required If checked, subscribers have no choice but to check this checkbox. Use it for 'I agree on terms and conditions' or something similar

| Top | Text line | Text Box | Text Area | Rich Text Area | Dropdown Box | Radio Buttons | Country Selector |
|
Formula |

Form Element Attributes Explanation Icon
Formula Label Text to appear as column header
 

 

A formula is used to replace field values to make a compound object.

The result of formula can only be shown on the result list.
Any label name between brackets {} will be replaced by the value in the database.

Lets say you have a field 'Telephone number' but you don't want to repeat the country and area prefixes for every entry. You can then insert a formula with the following text:

31-382-{telephone number}

Now it can be desirable not to show 31-382- as well when a telephone number is not available. Then simply place everything between square brackets, and when a value between the inner brackets {} is not found, everything between and including the square brackets is not shown.

See in the column to the left here, how this technique is used for a web address.
 

You can also use a formula to calculate a numeric value. In that case, your formula should start with an equal sign: '='

Lets say you have a drop down box with hotel prices, populated with the following options:
My Hotel:
{35} Hill Town Hotel
{50} Sharedon Hotel

And you have a check box to include breakfast when checked (5 US$)

You can then calculate the total price as follows:

={My Hotel} + 5 * {Include Breakfast}

Empty fields always evaluate to 0. Checkboxes evaluate to 1 when checked and zero when not checked.

 

| Top | Text line | Text Box | Text Area | Rich Text Area | Dropdown Box | Radio Buttons | Country Selector |
|
Formula |

 

| Home | Events | Login | Register | Help |

Use Formarama for: 

 Event Registration  Condolence Register    Rosters
 User Feedback  Announcements  Email lists
 Quick Poll  Guest Book  Tournaments  

Formarama (C) 2010 Email us at info@formarama.com