FAQ

Migrating from Joomla 2.5 to Joomla 3.3

Print

The release of Joomla 2.5.28 marks the last planned released of the Joomla 2.5 series as its support is scheduled to end on Decemeber 31st, 2014.

This means that all Joomla 2.5 series must upgrade to the latest Joomla 3.3 series release, which at the time of this writing is Joomla 3.3.6.

Althought there are many online resources available that discuss and guide you through the upgrade process and the Planning for Mini-Migration - Joomla 2.5 to 3.x Joomla resource, we have compiled our own guide that is especially focused on Joomla 2.5 series sites with Community Builder 2.0 installed.

Don't let the many details scare you - it is really a very straight-forward process and the details are really meant to help you understand what is happening and why.

The entire process described in this article is demonstrated in our CB 2.0 Tutorials - 39 - Joomla 2.5 to Joomla 3.3 migration video.

 video39

 

Differences between Joomla 2.5 and Joomla 3.3

The main differences between Joomla 2.5 and Joomla 3.3 that will most likely influence your upgrade situation are:

  1. Joomla 3.3 uses Bootstrap, where Joomla 2.5 does not. The Bootstrap markup makes your Joomla website responsive, which means that your Joomla website should look great in all viewing devices (desktop, tablets and mobile phones)
  2. Joomla 3.3 uses jQuery, where Joomla 2.5 does not.
  3. Joomla 3.3 needs PHP 5.3.10+, but Joomla 2.5 will work on PHP 5.2.4+.
  4. Joomla 3.3 needs MYSQL 5.1+, but Joomla 2.5 will work on MYSQL 5.0.4+.

In addition to these high-level differences your upgrade process may run into snags due to one or more of the following issues:

  1. Extension compatibility (in case you have installed some third-party extensions on your Joomla 2.5 site that are not Joomla 3.3 compatible)
  2. Template compatibility (there are some differences in the Joomla templating system that will most likely make your Joomla 2.5 template not fully compatible with Joomla 3.3)

 

Planning your Upgrade

Before starting to upgrade, you should do your homework. You have a live website that you need to upgrade, so spend some time to carefully plan your upgrade project (yup, you should view it as a project).

Here are some planning steps that will help you:

  1. Verify that your hosting environment supports the Joomla 3.3 technical requirements (PHP 5.3.10+ and MYSQL 5.1+). If it does not ask your host helpdesk to upgrade your account appropriately. If your host has an issue with this request, then you should consider changing hosts.
  2. This is a great opportunity to remove any inactive extsnions you have on your Joomla 2.5 website. There is no need to keep old inactive extensions on your website and it does pose a security threat in the first place.
  3. Make a list of all your third-party extensions (modules, components and plugins) installed on your Joomla 2.5 website. Visit each extension provider website and make sure that you have the latest version and that this version is also Joomla 3.3 compatible. Some extensions might have a new - only for Joomla 3.3 - extension release. If this is the case, then download such releases and keep them handy for your post Joomla 3.3 upgrade steps. Some extensions (usually modules) might need post upgrade configuration changes due to the new CSS stylings (and Bootstrap) present in Joomla 3.3 - make a list of needed changes for each one.
    Community Builder 2.0.4 (and CB 1.9.1) works just fine on both Joomla 2.5 and Joomla 3.3 - there are some minor adjustments needed for the CB Login module (see post upgrade CB steps for details).
  4. Contact your template provider and download the Joomla 3.3 template version or ask them for specific instruction on changes that need to be made to your Joomla 2.5 template once you have upgraded to Joomla 3.3.

 

Upgrade Steps

Once you have done your planning steps and have all your resources ready (e.g., new template, new extension, etc.).  you can follow these steps:

  1. Make a backup of your Joomla 2.5 website before starting - even better to clone your Joomla 2.5 website and test the upgrade process on the clonned site before replicating it on your production site.
  2. Verify that your Joomla 2.5 site is on using Joomla 2.5.28. If it is not, you can easily upgrade to Joomla 2.5.28 from your Joomla 2.5 Component → Joomla Update page
  3. Verify that your third-party extensions are the latest Joomla 2.5 (and Joomla 3.3 if possible) compatible versions. You should have done this in step 2 of the planning process, but you can also do a sanity check by making sure that there are no reported upgrades in your Joomla 2.5 Control panel Updates icon or your Extension → Extension Manager → Update tab.
  4. Go back to your Joomla 2.5 Component → Joomla Update page and click on the Options button and then change the Update Server parameter in your Update Source tab from Long Term Support (recommended) to Short Term Support and click the Save button. Please note that these parameter settings are no longer accurate as Joomla 3.X will be supported for at least 2-4 years.
  5. Your Joomla 2.5 Component → Joomla Update page should now show you the option to one click install the latest Joomla 3.3.6 (or better) release. Click in the Install the update button.

Your Joomla 2.5 website has been upgraded to Joomla 3.3 and you are now ready for your post upgrade process steps.

 

Post Upgrade Steps

Now that your website has been upgraded to the latest Joomla 3.3 release, you can follow these post upgrade steps:

  1. Visit your Joomla 3.3 Extensions → Template Manager and select the isis - Default template as your Administrator template.
  2. Install any Joomla 3.3 extension upgrades you identified during step 2 of your planning phase and/or make any post upgrade changes recommended by your third-party developers.
  3. Install your new Joomla 3.3 compatible template from your template provide and/or make any changes to your existing template.
  4. Test and inspect everything - frontend and backend.

 

Default Joomla Template Upgrade Steps

As indicated in step one of the previous section your Joomla 3.3 administrator template should be set to Isis - Default.

If your Joomla 2.5 website was using one of the built-in Joomla site templates, e.g., Beez2-Default, you can choose to use one of the Joomla 3.3 site templates, e.g. Protostar - Default. If this is the case, you may also need to change the position of your main menu module from position-7 (which was the case on your Joomla 2.5 default template environment) to position-1 (for the Protostar template on Joomla 3.3). You should also set your Menu Class Suffix on your main menu module to nav-pills to get the default menu styling on Joomla 3.3.

 

Community Builder Post Upgrade Steps

Community Builder 2.0.4+ will work just fine on both Joomla 2.5 and Joomla 3.3 environments. User profile data and your Community Builder configurations will remain intact.

The following changes need to be applied to your Community Builder Login module configuration to adjust its styling to take advantage of the new CSS code and Bootstrap present in Joomla 3.3:

  1. Visit your Community Builder Login module instances from your Joomla 3.3 Extensions → Module Manager page
  2. In the Advanced Options tab set the Alternative Layout parameter to bootstrap.

That's it for Community Builder specific post upgrade configuration changes.

 

Conclusion

Upgrading from Joomla 2.5 to Joomla 3.3 is not as complicated as you may think. Proper planning and doing your homework should get you to your Joomla 3.3 - very secure and totally responsive - website.

We have prepared the CB 2.0 Tutorials - 39 - Joomla 2.5 to Joomla 3.3 migration video (subscribe to our channel) demonstrating a Joomla 2.5 / Community Builder 2.0 installation being upgraded to Joomla 3.3.6.