Joomla 2.5.28 released and what it means to you

The Joomla project has released Joomla 2.5.28 that has been tagged as the last release in the Joomla 2.5 series.

Officially, as of December 31, 2014, the Joomla 2.5 series will no longer be supported. This means that there are no new releases planned for Joomla 2.5, as the Joomla project is putting all its efforts in its Joomla 3.3 and upcoming 3.4 series

There are no security related fixes in the Joomla 2.5.28 release, so there is no real rush to upgrade. However as this is the last of the Joomla 2.5 series you should start planning to upgrade your Joomla 2.5 websites to the even more secure, feature rich and mobile ready Joomla 3.3.6 environment. From January 1st Joomla 3.X will be the only security maintained release.

Joomla have a mini-guide on the uprade process:

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+. (Please check with us if the server that runs your site now meets this requirement)
  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 (yes, 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.
  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.
  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.



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.


Article adapted from, Joomlapolis is the creator of Community Builder.