Subscription installation instructions
Download the installation file
On our website you can download all versions of the Subscription during the term of your Subscription: vi-solutions
To do this, log in with the user account that you used to purchase the Subscription. You can access the login dialog by clicking on the user menu with the user icon in the top right-hand corner. After you have logged in, you will find an additional entry “My Downloads” in the user menu.
Note: You will only see the additional menu item "My Downloads" if you are logged-in with the user account that you used to purchase the Subscription.
Please click on the menu entry “My Downloads”.
You will now see a list of all downloads enabled by your active Subscriptions:
- Select the Subscription version that matches your Joomla version based on the download title.
- Click on the title of the download you want to download.
- Alternatively, you can also click on the download icon in the corresponding table row.
- Save the download to your computer.
The Visforms Subscription is installed using a so-called package installation. This means that there is only a single installation file. When installing this one file, all extensions, plugins and features of the Subscription are completely installed.
Installation of the file
To do this, go to the menu entry Extensions » Manage » Install in the administration of your website. Select the “Upload package file” tab. There you click on the “Browse” button and select the installation file with the name vfsubscription.zip.
Then click the “Upload & Install” button. This starts the upload and subsequent installation of the file. The successful installation is confirmed by a corresponding message.
PDF fonts are downloaded from the Internet during installation
The fonts for the PDF feature are around 30 MB and are not included in the installation, but are retrieved from the Internet and saved during installation. A very rare problem installing the free basic version (in the case of Joomla 3) or installing the Subscription (in the case of Joomla 4) may arise.
The very rare problem occurs when during installation
- there is no internet connection or
- access to the Internet is denied by PHP.
If the Subscription is installed on Joomla 4, the user will receive a corresponding message after the installation. The installation is not aborted, but runs through to the end. A subsequent installation of the Subscription with changed PHP settings finally downloads the PDF fonts.
Two PHP settings are important in this context.
Therefore, please check the following PHP settings:
allow_url_fopen = on
allow_url_include = on
More on this in: Internal Server Error
Use the Update Manager: Enter your download-ID
In order to be able to update your Visforms Subscription automatically via the Joomla Update Manager, you must first enter the download-ID you received. To do this, follow the instructions at Update via Update Manager. As soon as we release an update, you will be informed immediately by a corresponding update message in the Joomla administration.
Error messages during installation
The Visforms Subscription requires Visforms
Error
The Visforms Subscription requires Visforms.
Visforms is not installed.
You must install Visforms before you can install the extension.
Package installation error.
The Visforms Subscription requires a running Visforms installation with a defined minimum version on your website. The exact minimum version of Visforms required depends on the Subscription version.
If Visforms is not installed at all or the version is not high enough, the Subscription cannot be installed. The installation attempt aborts immediately with a corresponding error message. Please make sure first that Visforms is installed in a sufficiently high version and then try to install the Subscription again.
Wrong version sequence
Error
Incorrect version sequence.
Cannot update from 1.2.2 to 1.2.1.
Package installation error.
Suppose the Visforms Subscription is installed on your website in a specific version, for example version 1.2.2. Then you can always only install the same or a higher version of the Subscription. An attempt to run a lower version, such as version 1.2.1, fails with a corresponding error message.
How can I see if the installation was really successful?
Installation is complete or not at all
Although Joomla has a very sophisticated installation manager, there are occasional installation errors. Installation errors cause a half-completed installation to be aborted. It is extremely difficult to repair this condition afterwards. That’s why our installations are built to run all or not at all.
First, the prerequisites are checked
The installation prerequisites are checked first. If the requirements are not met, nothing is installed and the process is aborted with a corresponding error message.
The installation is carried out completely even in the event of an error
If the requirements are met, the installation starts and is carried out completely. If an error occurs at one point that would lead to the half-finished installation being aborted, then this error will be suppressed.
Effects of hidden errors
Suppose after installing the Subscription you have the feeling that the Subscription is not working properly. This could be the case, for example, because the “Calculation” field type is not displayed in the field configuration. This could be because there was a hidden error during the installation.
Is the Subscription fully installed?
The following explains how you can check whether the installation was actually and completely successful.
Installing the Visforms Subscription adds a number of extensions to your website. These extensions should all appear in your website’s administration under the Extensions » Manage » Manage menu item.
You can use the search tools in this view to verify that the appropriate extensions have been installed and are present. For example, use the search filters “Select type” and “Select directory”.
List of all extensions
At the current time, the following extensions should be available. If one of these extensions is missing, this is an indicator that the installation of the Subscription may not have been completely correct.
| Choose type | Name | Choose directory |
|---|---|---|
| Package | Visforms Subscription Package | select nothing |
| File | Visforms Subscription Files | select nothing |
| Plugin | Content - Visforms Form | content |
| Plugin | Content - Visforms Data | content |
| Plugin | Search Index - Visforms | finder |
| Plugin | Pagecache - Visforms | pagecache |
| Plugin | System - Clear Visforms data | system |
| Plugin | Visforms - Delete data automatically | visforms |
| Plugin | Visforms - Individual email addresses | visforms |
| Plugin | Visforms - Custom Redirects | visforms |
| Plugin | Visforms - Limit Transfer Count | visforms |
| Plugin | Visforms - Delay multiple registration | visforms |
| Plugin | Visforms - Double Opt-In | visforms |
| Plugin | Visforms - email attachments | visforms |
Fix installation errors
Extensions are missing
In this case, run the installation again.
The PDF fonts are missing
The installation of the Visforms Subscription also installs the PDF fonts as part of the PDF feature.
It may happen that the PDF fonts cannot be downloaded by your server.
This is usually caused by unfavorable configuration settings within the php.ini file.
More on this in:
TCPDF ERROR: Could not include font definition file: helvetica.
You can also install the missing PDF fonts manually. How to do this is described in the following section.
Pre-install the PDF fonts manually
It may happen that the PDF fonts as part of the PDF feature cannot be downloaded by your server. You can also install the missing PDF fonts manually in these cases. This does not disturb the regular installation of the Visforms Subscription.
- Download the following file pdffonts.zip from our server:
https://vi-solutions.de/index.php?option=com_vislinkrouter&linktype=pdffonts. - Unzip the pdffonts.zip file.
It contains the directory fonts. - Copy the fonts directory to the following directory within the Joomla instance:
media/com_visforms/tcpdf. - The following directory path results:
media/com_visforms/tcpdf/fonts.
Now start the installation of the Visforms Subscription.
If the media/com_visforms/tcpdf/fonts directory and the helvetica.php file in it are available, the PDF fonts will not be installed .
Uninstall Subscription
You can also completely uninstall the entire Visforms Subscription package first,
- if it is a complete new installation of the Subscription
- and you have not yet made any settings.
Then reinstall the Visforms Subscription package again.
Activate the Subscription plugins
Some features of the Visforms Subscription are provided by so-called plugins. Please refer to the table above for these.
Publish Feature Plugins
If you want to use one or more of these features of the plugins, you must first activate the corresponding plugins.
To do this, go to the “System” menu item in the administration of your Joomla installation and then to the “Plugins” entry on the “Manage” tile. Look there for the entry of the plugin that you want to activate. For example, use the search filter above the plugin list.
The plugin is activated when you see a green tick in the status column. It’s disabled when there’s a gray circle with a white X in its place. In this case, click once on the gray circle to activate the plugin.
Note: All other features of the Subscription are immediately available in the administration of the forms, fields and menus without any additional measures.
Uninstall
To uninstall the Subscription, go to the “System” menu item in the administration of your Joomla installation and then to the “Extensions” item on the “Manage” tile. Use the search tools in this view and select “Package” in the “Select type” search filter.
Check the “Visforms Subscription Package” column and then click the “Uninstall” button. This will uninstall the entire Visforms Subscription with all associated extensions, files and tables in the database.
Note: You can then no longer use the features of the Visforms Subscription.
Configuration settings of all Subscription plugins will be deleted
This will delete all configuration settings that you have made in the plugins of the Subscription. This includes, for example, settings that you have made in the form configuration under the “Email attachments” tab.
You can then reinstall the Visforms Subscription at any time.