Installation/Updating
Installation
There are two different package types:
- Installers for Joomla
- Joomla with preinstalled VirtueMart core and extensions
1. installers for joomla
The installers for Joomla are provided in a com_virtuemart.x.y.z_extract_first.zip. The z stands for the subversion, packages with even numbers are released for production. Packages ending with an uneven number are prereleases for testing. After extraction you will find three files
- com_virtuemart.x.y.z.zip
- com_virtuemart_ext_aio.x.y.z.zip
- com_tcpdf_x.y.z.zip
They are meant to be installed in the above order using the Extension Manager in the Joomla back-end. If there are installation problems, it is also valid to extract the packages into a folder on your computer and upload them using an FTP client. In this case it is mandatory to use the "Discover" feature of Joomla and it is recommended to execute the "Install tables or if necessary update them" command accessible in the VirtueMart tools section. This tool is quite important. It executes the install/update scripts of VirtueMart manually. The VirtueMart Aio menu item displays a list with all extensions for VirtueMart and also has a button to update or install the tables of the plugins.
You may follow this tutorial Installation of VirtueMart
2. joomla with preinstalled VirtueMart and extensions
The installation is the same as for Joomla. It just needs to be uploaded/extracted into the web directory. The installation is done with a slightly modified Joomla setup. The normal Joomla sample data is replaced with the basic setup for a store. The full installer provides many advantages and saves a lot of configuration time. It directly creates a working store and provides a menu for the VirtueMart views. It also demonstrates how a basic setup should look like. It is possible to do the first test checkout within 2 minutes after installation.
Updating
The normal installation packages are also directly useable for updates. The normal way here is also to use the Joomla Extension Manager for installing an update. Always directly update to the last version of VirtueMart. So a vm2.0.2 can be directly updated to vm2.6.28. For updating to a new main version it is the same rule. A VM2 should be always directly updated with the most recent VM3. It is very likely that are more recent version has also more backward compatibilities fixes and enhanced updating procedure.
VirtueMart has it's own table updater, which checks for differences in the installation.sql and the existing tables. Deletion of columns is disabled to prevent data losses in case the tables got modified (have additional tables). So it is quite normal that the update process displays messages of the type 'Notice', like "Taking config from file" or some variants of 'Table updated: Tablename '.$tablename.' dropped: '.$dropped.' altered: '.$altered.' added: '.$added.
It is only important to pay attention to messages which are Errors or Warnings.
Languages
Before the installation of VirtueMart it is recommended to install the preferred main language first. The preferred language should be configured as 'site' language in Joomla.
When installing VirtueMart, the installer creates the language database tables for the selected site language, into which for example the product information is stored. Only English language files are delivered with the VirtueMart installation packages. All other language packs can be downloaded from http://virtuemart.net/community/translations and installed using the Joomla Extension Manager. Afterwards the language(s) is (are) available for selection in the VirtueMart configuration.
When updating old versions of VirtueMart or when it was accidently installed with the wrong language, it is possible to change the used language and let VirtueMart create the new tables or update the old ones by storing the VirtueMart configuration.
A guide for setting up a multilanguage shop is available here:
http://docs.virtuemart.net/tutorials/multilingual-store/99-multilanguage-setup.html
Troubleshooting
alterColumns alterKey not finished, please raise execution time and update tables again.
In this case it may be sufficient to use the "Install tables or if necessary update them" command accessible in the tools section.
"There was an error uploading this file to the server" or "unknown archive type
Then just upload the installer per ftp to the temp directory and choose the 2nd option, for more information, look here http://www.phoca.cz/phocagallery/478-how-to-install-large-components-with-help-of-ftp-in-joomla
ERROR: Could not find an XML setup file in the package". What's wrong?
Mostly this problem arises because you have not unpacked the file com_virtuemart.x.y.z_extract_first.zip before and tried to upload/install this file.
Backend menu entry is missing
This can happen, when you did uninstall VirtueMart core or the Aio. Check your extension table of joomla and set the value of the column state from -1 to 0.
Another component is already using the directory com_virtuemart
Please delete the directories /site_root/components/com_virtuemart and /site_root/administrator/components/com_virtuemart. If you can't delete the directories using ftp, try the eXtplorer file manager extension for Joomla! instead.