Field Types
VFB Pro provides many different field types to speed up your form building. In addition to the standard form fields, VFB Pro includes several advanced fields. Standard form fields are typical form inputs, some we automatically validate (i.e. Email or URL). Advanced fields are usually “widgets” that provide functionality outside of the typical form input and have a custom appearance (i.e. Range Slider or Rating).
Validation is the process of checking whether or not the user’s input meets certain requirements. For example, the Email field checks if a valid email address has been entered. If a valid email address is not entered, the form cannot be submitted. By automatically including this kind of validation in certain fields, VFB Pro removes the need to worry about what kind of validation settings to apply to a field.
Standard Fields
Heading
One of the few fields that does not accept user input. Include a heading title along with an optional description. This field replaces the older Fieldset field.
Submit
Without a Submit button, your form cannot be processed. Always include a Submit button placed last in your list of fields.
Text
This is the workhorse of form building. A one line input that accepts all types of text. Include all custom validation settings so you can craft your own field type.
Textarea
Similar to the Text field, this also accepts all kinds of text. This input is much larger than the Text field and allows for multiple lines of text to be entered.
Checkbox
This field presents a list of options to be selected by the user. With checkboxes, a user can select any, all, or none of the options. Best used when you want to allow multiple selections.
Radio
This field also presents a list of options, but the difference is that the user can only select one option.
Select
This field presents a drop down box with your list of options. It is similar to the Radio field in that you can only select one option. The difference is that the Select field combines your list of options into a box that saves space on your form.
Address
The address field is a special field that combines several inputs into one. It combines an Address, Address Line 2, Country, State, and Zip Code into a single field. This field will localize itself based on the Country you select. So if you select Canada, it will replace the State dropdown with a Province dropdown. After form submission, the values are combined and saved as one.
Date
This field displays a date picker pop-up when the input is in focus and allows the user to easily select a date with their mouse. This date picker is fully customizable by configuring the Date Properties.
Collect emails with this field as it will automatically validate user input to meet email standards.
URL
This field is intended to collect websites or URLs. Only valid URLs must be entered into this field.
Currency
The currency field accepts all kinds of input in a monetary format. This can be localized to accept currency in your country’s format.
Number
The number field is best used when you wish to collect data that is in numerical format. This field only accepts numbers, so anything else will return an error.
Time
This field displays a time/clock picker pop-up when the input is in focus and allows the user to easily select a time with their mouse. This time picker is fully customizable by configuring the Time Properties.
Phone
The phone field accepts phone numbers in various international formats. You can select the country from a dropdown and it will automatically apply the country code and format necessary for that location. This field is fully customizable by configuring the Phone Properties.
HTML
This field allows users to insert HTML code. An editor that works exactly like the WordPress Post editor will be output on the form. This editor includes several rich text editing buttons.
File Upload
The file upload field allows users to attach files to their form submission. This field can collect one or more files at once. A file preview is displayed above the input when the user selects a file from their computer. You can customize this input by configuring the File Upload Properties.
Instructions
Another field that does not accept text. The instructions field is for outputting large sections of text for display to the user. Best used when you want to include a detail description or set of instructions to the user in the middle of your form.
Advanced Fields
Name
A special field that combines several inputs onto a single line. This field collects the First and Last name with a single field. You can also include Title and Suffix. After form submission, the values are combined and saved as one.
Captcha
This field outputs a Google reCAPTCHA field that will stop spammers from submitting your form. To use this field, you must add your reCAPTCHA keys to the VFB Pro > Settings page.
Hidden
When you want to include a field on your form without it being visible to the user, then you should use the hidden field. The hidden field can collect various information such as the page URL or the current user’s email address. For more information on what is available, see the Hidden Properties page.
Color Picker
This field will display a color picker pop-up when the input is in focus and allows the user to select a special color (HEX code).
Autocomplete
If you have a large set of options that is more than you desire to display in a Radio, Checkbox, or Select, then the Autocomplete is what you want. This field will display an input that matches user input as it is typed. So if you have a list of states and someone types ‘Al’ it will display a list with “Alabama”, “Alaska”, and “California” as matches. You can select more than one option and once an option is entered, it will be removed from the list.
Range Slider
The range slider is a widget field that uses a special output to allow the user to slide along a scale to select a number value. The range slider is fully customizable by configuring the Range Slider Properties.
Min
This field is a one line input that, when configured, will only allow the user to enter a value starting with a certain number.
Max
This field is a one line input that, when configured, will only allow the user to enter a value up to a certain number.
Range
This field is a one line input that, when configured, will only allow the user to enter a value starting with a certain minimum number and up to a maximum number.
Page Break
While this field does not collect any data, it allows you to split your form up into multiple pages. For more information, refer to the Using the Page Break documentation.
Likert
A likert field is a series of multiple choice questions laid out in a tabular format. Ideal for ranking and evaluating data, a likert field contains a number value indicating the weight of the option. For example, Disagree may equal 1 and Agree equals 2. These weights will come into play when examining the results of your data and gathering useful averages about the statements evaluated.
Rating
This field allows you to provide a rating scale using icons. The user mouses over the icons and selects the number they’d like to display for the rating. There are several icons available and can be customized by configuring the Rating Properties.
Knob
This field allows you to display a dynamic and animated number picker. The user drags the mouse around a circle, like a knob control, to increase or decrease the desired number.
Signature
This field is designed to capture a user's digital signature.
Create User Fields
Username
Only available with the Create User add-on, this field allows your users to enter their desired username for creating a WordPress account.
Password
Only available with the Create User add-on, this field allows your users to enter their password for creating a WordPress account. The password field validates a user’s input to require a strong password and will display a strength meter informing the user of how strong the password is.
Create Post Fields
Post Title
Only available with the Create Post add-on, this field will be used to create a WordPress Post title. The field is a one line input that accepts all types of text.
Post Content
Only available with the Create Post add-on, this field will be used to create the WordPress Post content. An editor that works exactly like the WordPress Post editor will be output on the form. This editor includes several rich text editing buttons.
Post Excerpt
Only available with the Create Post add-on, this field will be used to create a WordPress Post excerpt. The field is also accepts all types of text but allows for multiple lines to be entered.
Post Category
Only available with the Create Post add-on, this field will be used to create a WordPress Post category. This field will output a Select dropdown of all available categories.
Post Tag
Only available with the Create Post add-on, this field will be used to create WordPress Post tags. This field works exactly like the Autocomplete field.
Custom Field
Only available with the Create Post add-on, this field will be used to create a WordPress Post custom field. The field is a one line input that accepts all types of text.