VirtueMart is absolutely huge. By some counts, it stands second in popularity amongst all eCommerce platforms. Last year we explained how to use it in a very detailed tutorial.
Nearly all Virtuemart shops run version 1.1 but recently Virtuemart launched version 2.0. This tutorial will show you how to move your Virtuemart installation from 1.1 to 2.0.
What you need to know
Migrating Virtuemart from 1.1 to the newest 2.0 version seems fairly simple with the migration utility that is built into Virtuemart. However there are a few potential pitfalls. The migration utility does move this data:
However, the migration utility does not move the following items. You will need to manually add this data:
In this tutorial, we'll walk you through the process of moving from 1.1 to 2.0.
Also, please make sure that you try this first on a development copy of your site. As we always advise: DO NOT ATTEMPT AN UPGRADE ON A LIVE, WORKING SITE. Here's a tutorial on creating a development copy of your Joomla site.
Step 1: Download the Virtuemart files
Go to http://virtuemart.net and download two things:
Step 2. Move your media into /images/stories/virtuemart/
Step 3. Rename your old com_virtuemart folders
Using your file manager or FTP program to go to /components/com_virtuemart/ and rename the entire /com_virtuemart/ folder. I used the word ORIGINAL in the image below so it would be easy to spot the change to /ORIGINALcom_virtuemart/.
Step 4. Disable the Joomla debug option plus Virtuemart modules and plugins
We need to go to the Joomla configuration and disable the Joomla debug option.
We also need to disable all of the Virtuemart modules.
If there are any green checks, for Virtuemart modules change them to red x's.
We also need to disable all the Virtuemart plugins:
Finally, if you have it installed, also disable the Akeeba System - System Restore Points plugin.
Step 5. Set the default language
Step 6. Install Virtuemart 2
When you download Virtuemart it comes in a compressed package that needs to be unzipped first. In fact, the download package will tell you to do this by having a name such as com_virtuemart.2.0.2_extract_first.zip. After unzipping you will see two files:
You only need to install the com_virtuemart.2.0.2.zip file Complete the installation of this file before you add the AIO (All-in-one) package. The AIO contains all the plugins and modules you'll need.
Go to Extensions > Install/Uninstall (or Extensions > Extensions Manager) in Joomla 2.5 and upload the files for Virtuemart 2.0. The file you want to upload will have a name such as com_virtuemart.2.0.3.zip.
The image below shows the successful installation response screen. You won't need to install sample data.
You can now go to Components > Virtuemart and confirm that all your data is intact and the upgrade has been made. If it was installed successfully, you'll see a screen like the image below. If anything went wrong, you'll see an error message, which seems to be a frequent result according to forum reports. However it's a simple fix. If you get an error message, uninstall Virtuemart 2 and reinstall it once more.
Step 7. Install AIO component
Return to the Extensions > Install/Uninstall and upload the AIO (All In One) component. This will have a name such as com_virtuemart.2.0.2_ext_aio.zip.
Step 8. Deactivate an incompatible plugin
If you have a Joomla 1.5 site, you will get an error message if you try to view the site now. The reason is that a Joomla 2.5 plugin was installed with the AIO component. If this is a 1.5 installation, the site will not load correctly. Here's how to fix it:
If you are locked out of your admin, you can turn off the module using phpMyAdmin as explained in this tutorial.
Check your site now. If it works, we let's get the migration going.
Step 9. Enable the database update tools
Step 11. Set up the migration
You already made these changes in the step above, but If you want to increase these manually, open your php.ini file in a script editor and change the parameters as needed. If you need help, here are two tutorials we have available for free, that will give you some guidance in finding the file and making changes.
Once the migration is complete, you'll see an screen like the image below. Mostly blue is a good sign. At this point you don't need to be too concerned about the error messages. You still need to configure all the details of your store, so that's the next step. That will correct these error messages.
Now go ahead and previewing the site. It shows you that all the products were imported and everything is working.
Congratulations! At this point your migration to Virtuemart 2 has gone as far as the in-built migration utility will take you.
Now you can configure your store by going to Components > Virtuemart > Configuration. We have a great tutorial on how to configure Virtuemart if you need it.
All the best with your new Virtuemart 2 store!
All of our tutorials are published under the Creative Commons Attribution-NonCommercial license. This means: