Dynamic preselection for Select Fields
Note: This feature is part of the Visforms Subscription and is not included in the free Visforms version.
Statically Defined Preselection
Note: The statically defined preselection is already included in the free Visforms version.
The following field types are select 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,
- Radio Button,
- Checkbox Group.
If you check the box in the Default column, this option will be preselected the first time the form is displayed:
- Set the static default selection of the selection field
- Field Configuration » Tab: Basic Settings
Group: Create Options List » Area: Options List » Column: Default = “Selected”.
- Field Configuration » Tab: Basic Settings
Note: The checkbox in the Default column loses its effect if the preselection of the select fields is set dynamically.
Dynamically Adjusted Preselection
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 preselection of the selection field 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 option of the selection field appears preselected when the form is first displayed.
The dynamic preselection of the selection field is a default value setting.
Configuration
The dynamic preselection 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 preselection 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.