Heads Up: This is the documentation for Joomla 3

We recommend using the Documentation for Joomla 4!

It is more up-to-date and extensive. Most of it applies retrospectively to Joomla 3.

Joomla 5 Notice

We are pleased to announce that as of January 29, 2024, all of our Joomla extensions are compatible with Joomla 5.

For all who are still updateing from Joomla 3 to Joomla 4: Joomla 4 Migration instructions are available here:

There is now a separate Documentation for Visforms for Joomla 4 and for Visforms for Joomla 5!

Plugin Configuration

This feature is part of the Visforms Subscription and not available in the free Visforms version..

This is legacy documentation for old versions of the plugin as shipped with Visforms Subscription prior to version 3.2.2. In newer versions, individual success pages are configured directly in form fields with option lists.

We suggest reading the documentation from the beginning, starting with the Introduction. We will not repeat explanations that help you to better understand the whole context.

Create a control field in your form

Create a field of type select, radio or checkbox group in your form and create options for this field. Each option will then be linked to a specific redirect url for a specific success page.

Please note down the option values (see screenshot) and the field id, you need this information to set up the redirects.

Option Values

Setting Up Custom Redirects

User inputs in form and custom redirect urls are connected in the form configuration tab "Custom Redirects"

The configuration - conneting user inputs with redirect urls - is achived by adding an option string into the parameter "Configuration string". The string links options of the control field, which you have created (and noted) in your form, to redirect urls.

Example Configuration String

{
"1": {"id":"5", "value":"Hotel Astoria", "redirecturl":"index.php?Itemid=110"},
"2":{"id":"5", "value":"Hotel Memphis", "redirecturl":"index.php?Itemid=111"},
"3": {"id":"5", "value":"Hotel California", "redirecturl":"https://vi-solutions.de"}
}

Structure

Enclose the string in curled brackets {}.

Create a "record set" for each value of the control field. In the example above each "record set" is noted in a single line.

Each "record set" has to begin with a unique id (integer), which is enclosed in double quotes "and which is followed bei a colon :. After the colon you enter the assignment information (see below) which is enclosed in curled brackets {} again. Separate "record sets" with a comma. Please make sure, that you omit the comma after the last "record set". You can add as many assignment record sets as you like.

The assignment information consist of 3 "name":"value" pairs. Please make sure, you do not misspell names or values! Misspelling is the most common reason why the plugin looks as if it would not work properly. The names are constant. You only have to change the values.

id: Field Id (of control field). You can retrieve the field id from the field list in the Visforms administration (last column). The field id are also available in the field edit view.

value: User input, that triggers the custom redirect.These are the "values" of the option list (see screenshot above) which you have noted.

redirecturl: Internal or external url to a success page, where the user is redericted to after the form was submitted successfully. Please note: Internal Urls must always be the original url (i.e. index.php?option=com_content&view=article&id=10&Itemid=45) not a SEF url!

Avoid blanks in the option string, except for the values, enclosed in double quotes.

It's important that you really use double quotes "!

How it works

If the submitted user input matches a condition defined in the plugin option string, Visforms will just use the connected url for the redirect. If you have set a default redirect url in the form configuration tab "Result", the custom redirect url will override the default one for this specific submission.

If there is no custom rederect url set for the selection which the user has made in the current form submission, then the default settings made in the form configuration tab "Result" will be used.

Article list Find suitable subscription