Forms 

 

Using a simple Form editor you can easily create different types of web forms that can help you interact with your site visitors or gather user information. The Form editor is very similar to the Text and Image editor, but has a set of additional options for customizing your forms. It lets you add all types of form fields you may need, and arrange them as you like to create any type of web form - Feedback form, Product / Service Information Request forms, Subscription forms, Surveys, Questionnaires and more.

 

To add a Form to your website simply reach for the top menu and click Add Content > Form. Green rectangles will appear to indicate the locations where a form may be added. Select the desired location by clicking on a green rectangle and the Form editor will be displayed.


There are two tabs in the Form editor - Layout and Actions. In the Layout you will configure the Form content, fields, checkboxes, radio buttons, and the Call To Action Button required for submitting the form. In the Actions section you will specify what happens when a visitor Submits the form - send to email, send to mailing list, send to database.

 


Layout - types of fields, checkboxes and buttons  

 


1. Text Field

The Text Field may be used in your form to type text which is fairly short, and does not need to be split in lines. To add a Text Field press the  button from the Form editor tools menu. Now click over the Text Field you have added and you will see a set of options displayed in the right pane of the Form editor.

  • Type determines what information users should fill into this field.
a. Text: the text users fill in will appear just as they typed it
b. Password
: the text will appear as **** so other users may not see it
c. File*
: visitors can upload image, audio, video and other binary files to your site. When your site visitors submit to the form on your site you will receive an email with the information and a click-able link to the "File" they uploaded.
d. Hidden can be used when you need to gather system-related information (like IP or browser used to submit the form) or add data which users should not see. A hidden field will not be visible on the page.
  • The Name, just like the name of a person, is used to identify the form field when you need to refer to it anywhere inside the form editor as well as in the email / blog entry generated by this form. That is why each form field should have a unique Name.
  • You may adjust the Width of the text box either by typing a different width number or by just dragging the resize controls of the field text box (the resize controls will appear when you click over the form field).
  • Max Length is the maximum number of symbols this form field can accept. Your form may visually be very short, but it will accept as many symbols as you define in Max Length.
  • Validate As field will let you define the type of content users are required to fill into this form field. If they don't fill in the proper content type - they won't be able to submit the form. E.g your form field Email may be validated to accept just content type Email. Thus if some user submits a form with incorrect email address (like me@yahoo or meyahoo.com) on trying to submit of the form the user will see a notice to correct the email.
  • Default Value - This value will be pre-filled upon opening of the form and the visitor will be able to change it. The following special strings will be replaced with the corresponding values:

$date  - Date in format YYYY-MM-DD

$date_time  - Date and time in format YYYY-MM-DD HH:MM

$browser_ver  - Browser version and type of operating system

$referrer  - The page the visitor came from (referrer page)

$ip  - Visitor's IP address

 

*Files - In order to preserve the files sent via web form, the Form needs to be connected with a Database. Files that become part of the database will use the account storage and will remain accessible as long as they are in the Database. File links that are sent to an email do not use account space and therefore will expire in 2 weeks.


2. Text Area    

The Text Area form field is similar to the text box field but can hold longer, multi-line text. Add a Text Area from the form editor > . Click over the Text Area field you have added to see its customization options displayed to the right.
The options Name, Width, Validate As and Default Value are identical to those of the Text Field. In addition, here we have :

  • Height of the text area - you may change it either by changing the number in the height field or by dragging the text area size controls.
  • Wrap - defines the wrapping of the submitted form field text when displayed in an email or forum / blog. Choose Default value to have your browser and mail client (Outlook, etc) wrap the text according to their default settings. Set wrapping Off to disallow the wrapping of the text when it is typed. Choose Physical to display the text in the mail the way it was wrapped in the text area. Choose Virtual to allow the mail client to decide how exactly the text should be wrapped.



3. Select Field    

The Select Field is a box with a dropdown list inside, or a box with several options displayed one below the other. Add a Select field from the Form Editor >  button. Click on the select field you have just added and you will see its properties again to the right.The new options displayed here are:

  • Type - if you choose Menu type the select field will be a dropdown with options. If List is selected, the available field options will be listed one below the other.
  • The Options will be displayed as variants for selection in your Select Field. The Option Name is the exact text to appear in the dropdown / list, and the Option Value is the text that will be sent to you in an email or posted to a forum when the respective option is selected. Using up/down arrows you may rearrange the options in the dropdown or list. You may also delete options as well as choose a specific option to be selected by default. 



4. Checkboxes    

Checkboxes are used when there is a list of possible options and the user may select any number of choices from them. A stand-alone checkbox may also be used for a single option that the user may turn on or off.

Add a checkbox from the form editor >  and select it to see the customization options in the right pane. 

  • The checkboxes, just like all other form fields, have a Name which identifies the field in the form template editor as well as in the email/blog entry generated by this form. You may consider the Name as the question your users will have to answer by checking or un-checking the checkboxes associated with it.
  • The Value of the checkbox is the answer you will get on your question. I.e if you set the checkbox value to Yes when the users checked this checkbox this means they answered your question affirmatively.
  • If you check the Default State option, your checkbox form field will be initially checked when the users load your form.
  • And finally, if you make a checkbox mandatory users will be required to check it before being able to submit the form. E.g if you want them to agree to your Terms and Conditions before they may submit the form - add an Agreement checkbox and make it Mandatory.



5. Radio buttons    

Radio buttons are used when there is a list of several mutually exclusive options - i.e. the user can select just one option out of all available. Add a radio button from the form editor > . Now click the radio button to see the customization options for it displayed to the right.

  • All radio buttons representing the options for one and the same question must belong to the same Group. I.e. the Groups are the questions which will have radio button answers. At any time only one radio button from a group may be selected - clicking another radio button will deselect the previously selected radio button in this group.
  • The Values of the radio buttons are the actual answers to your questions. The value gets posted in the email / forum when this radio button is selected.
    Imagine your question was Do you like my site and you want to give the users 3 options: Yes, No and Needs more work. Your radio button group may then be named 'LikeMySite' and the Values of the radio buttons will be Yes, No and Needs work.  If a user selects the radio button with value Yes, in the email or forum where the results of the form get posted you will receive this information as LikeMySite: Yes
  • The Default State and Mandatory options work the same way as described for the checkbox field.


6. Feedback Form Wizard    
The Form editor features a ready form wizard for Feedback. You can add it using its icon. It comes with the necessary for this type of form submission fields, complete with a Call To Action button. The fields have predefined settings that you can modify if necessary.



7. Location of Success and Error messages    

After submission of the Form the system displays success or error message. The Form allows you to specify the location on the succession and error messages, depending on where in the editor you add them. Use the following icon:  located at the top right of the Form editor to specify the desired location.


The form properties also allows you to specify a custom Success message, when Advanced Options are On. If you leave the field blank, the system will display the default success message, otherwise you can input the desired notice to be displayed to your website visitors.


Please note, the custom Success message options is not available if the form is configured to redirect the site visitor to another page.



8. Call To Action button    


The Call To Action button is essential to the Form. Without it your users cannot submit the form and it cannot complete its actions. To insert the Call To Action button, click on its icon  at the far right corner of the Form editor. To make it a Call To Action button for sending a form, click on it and from the Link drop-down menu select {Submit Form}. You can create a Form {Reset} button using the same process.


Default Options:


Use the editable fields in the right panel to change the Default Captions / Mouse-over Captions text the button will display.


Button Icon Source: You can select to Upload Custom images that will be placed inside the button, or choose such from our Stock Image Library.


You can select from a list of Mouse-over Transitions to be used between the Default Captions / Mouse-over Captions and the Default / Mouse-over icons.


With the last default option, we can choose between three Button Alignment and Text Flow styles for each button:

  1. no wrapping

  2. left wrap

  3. right wrap




Advanced Options    


Enable the Advanced Options to access additional editing options.


You can choose from a list of Highlight Animation Effects. When such effect is applied to the button, it will appear 3 seconds after the page is loaded and it will be repeated on every 30 seconds.


Icon Location - Specify if the icon should be placed at the left or at the right of the caption.


Adjust the Spacing Around Button in relation to the text content by specifying top, bottom, left and right padding in pixels. 


Button Size & Button Color - You choose from three pre-defined sizes (Small, Medium & Large) and three pre-defined button color styles.


Actions


1. Next Page: define which page from your site should open after successful submission of the form (it may be a 'Thank You' page for example).


2. Send to Email

Send the contents of your form to your email. Check the Send to Email checkbox to expand all options in this section.

  • To Email: Specify the address To which submitted forms should be addressed. We can display customer submitted details by applying $xxxxx$ wildcards for the special values of the corresponding Form Field Name.

  • From Email: Specify the address From which the form will be sent. This can be your own specific email address, or we can display customer submitted details by applying $xxxxx$ wildcards for the special values of the corresponding Form Field Name.

  • Mail Subject: of the email that will be received on submission of the form (like New Information Request). We can display customer submitted details by applying $xxxxx$ wildcards for the special values of the corresponding Form Field Name.



Advanced Options - Actions    


Enable the Advanced Options to reveal additional Form Actions.


3. Format: of the mail. If Plain is selected any formatting will be lost. If HTML is selected the submitted email will be displayed in HTML format if your mail client supports this option.


To display additional information and/or apply special formatting to the mail containing the form data submitted, choose Use Template option and a Template Editor will open.

The Template Editor resembles a simplified Text and Images editor, and has its own Save and Cancel links which will let you save the template or go back to the Form editor. The Template Editor will let you apply your own formatting and include in the email body the value of any field from the form. Use the Value dropdown on top right of the Template Editor to insert placeholders for the desired field values in your template. You will see that all form fields you have added to your form appear in this dropdown referenced by their Name. After your template is ready and saved, each submission of your form will result in an email sent to your email, and the content of the email will follow the content structure you have set in your Template.


4. Send Confirmation Email
This action allows you to send a timely response to your visitors notifying that their information has been properly submitted and will be processed shortly. To Email drop-down lets you specify the field to be used for email data. The field will be filled in with your visitor's email address, and the Form will use it to send the confirmation email to it. Enter the email address from which this confirmation message will appear to be sent in your visitor's mailbox. Specify its subject. Finally, you have the option to edit the confirmation message itself, clicking the Template > Edit link. It will open a simple Text  Templateeditor to be used to devise your message. Save the template when you are done using the Save button on the Template Editor.
 
5. Send to Database
By selecting the Send to Database checkbox all form-fields submitted through your form will be added to a database on your site. The Form will create its own database, with all necessary columns of the type it needs. This data is accessible along with the Database Editor application. You can also use an imported database, but before setting up the Form to use the imported database, make sure it has all necessary columns of type and name exactly as the type and name your Form fields use. For more details visit our Database Editor application tutorial.


If you check the option Requires Confirmation, your visitors will receive an email with a link they need to click to confirm their entry. Checking this option will open a To Email drop-down, asking you to specify the email field from the Form. The email address your visitor enters in that field will be used to send the confirmation email with the confirmation link.


If you check the option Require Approval, you will need to also enter email address for the moderator. The moderator will be sent an email upon submission of the Form, asking him to click on a link to approve this entry in a database. This function is useful to guard against spam submissions or accident submissions from visitors.