Additional Options for Checkbox Fields
Note: These features are part of the Visforms Subscription and are not included in the free Visforms version.
Dynamically Setting the Checkbox Field Default
For checkbox fields, there is an option to dynamically determine the pre-selected state of the checkbox field for the first display of the form. A dynamic pre-selected checkbox field is configured by specifying a field from the user management. If the values of the checkbox field and the configured field from the user management match, the checkbox field appears pre-selected when the form is first displayed.
The dynamic pre-selected checkbox field is a default value setting.
Configuration
The dynamic default setting of the checkbox field is configured and controlled as follows:
- Setting the value of the checkbox field
- Field Configuration » Tab: Basic Settings
Group: Value Setting » Parameter: Value.
- Field Configuration » Tab: Basic Settings
- Setting the Follow User Information option for the checkbox field
- Field Configuration » Tab: Basic Settings
Group: Initial Value Settings » Parameter: Checked = “Follow User Information”.
- Field Configuration » Tab: Basic Settings
- Specifying a field from the user management.
Without an active Subscription, the User Information listbox with the dynamic options remains empty and only a reference to the Subscription is displayed.- Field Configuration » Tab: Basic Settings
Group: Initial Value Settings » Parameter: User Information.
- Field Configuration » Tab: Basic Settings
Supported User Management Fields
- The following fields of the user account 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 for the About Me text area.
Match Check
A check is performed to see whether the value of the Joomla user field matches the value of the checkbox 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 consistency. The comparison ends at the first match, and the configured form checkbox appears preselected when the form is first displayed. If no match is found for 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 checkbox in the text comparison.
‘Current Page URL’ Option
The User Information parameter’s listbox contains the Current Page URL entry, 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 for 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 an entry called Current Page URL in the listbox of the User Information parameter. If the current page URL matches the value stored in the field configuration, the checkbox will be preselected when the form is first displayed.