Additional Options for Selection Fields
Note: These features are part of the Visforms Subscription and are not included in the free Visforms version.
Statically Set Defaults
The following field types are selection fields, where multiple options can be created in the field configuration in the options list and are available for selection in the displayed form:
- Listbox,
- Radiobutton,
- Checkbox Group.
If you check the checkbox in the Default column, this option will appear pre-selected when the form is first displayed.
Note: The checkbox in the Default column loses its effect if the default settings for the selection fields are set dynamically.
Dynamically set defaults
For selection fields, there is an option to dynamically determine the default option of the selection field for the first display of the form. A dynamic selection field default is configured by specifying a field from the user management. If the values of an option in the selection field and the selected field from the user management match, the selection field option appears preselected when the form is first displayed.
The dynamic selection field default setting is a default value setting.
Configuration
The dynamic default setting of the selection field is configured and controlled as follows:
- Specifying a field from the user management.
Without an active Subscription, the User Information listbox with the dynamic options remains empty and there is only a reference to the Subscription.- Field Configuration » Tab: Basic Settings
Group: Dynamic Settings » Parameter: Follow user information.
- Field Configuration » Tab: Basic Settings
Note: The checkbox in the Default column loses its effect if the default setting of the selection fields is set dynamically.
Supported User Management Fields
- The following user account fields are available:
- Email,
- Name,
- Username.
- All Custom Joomla User Fields of the following field types are available:
- Checkbox,
- Radio Button,
- Listbox,
- Text,
- Email,
- URL,
- Date.
- All fields from the user profile are available, except the About Me text area.
Match Check
A check is made to see whether the value of the Joomla user field matches the value of an option in the drop-down list in a text-only comparison. If a user management field supports multiple values, such as a multi-select checkbox or listbox, all values set in the user management field are checked for a match. The comparison ends at the first match, and the configured option in the drop-down list appears preselected when the form is first displayed. If no match is found with any of the user field values, the configured form checkbox appears unselected when the form is first displayed.
Note: The Joomla user field must therefore be set up to match the Visforms field. The value in the Joomla user field must match the value of the configured option of the drop-down field in the text comparison.
Option ‘Current Page URL’
In the listbox of the User Information parameter, there is the entry Current Page URL, which is intended for the following situations.
A form can be embedded on many different pages, for example, via a module or using the Content Plugin - Visforms Data.
For displaying the form data of a specific submission, it is sometimes important to know from which page the form was completed and submitted. In these cases, this is truly important information.
To access this information about the URL of the page containing the form, there is the entry Current Page URL in the listbox of the User Information parameter. This means that if the current page URL matches the value of an option from the options list of the drop-down list, this option in the drop-down list will be preselected when the form is first displayed.