2. Home
  3. Rhye Smile

Migrating from Joomla!

Migrating from Joomla! 2.5 to Joomla! 3.3

The release of Joomla! 2.5.28 marks the last planned released of the Joomla! 2.5 series as its support was scheduled to end on December 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.

It’s time to start migrating from Joomla! 2.5 to Joomla! 3.3

Although there are many great 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!, we have compiled our own guide based on an article posted on Joomlapolis.com. Without any component specific instructions or sales bias.

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

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:

  • Joomla! 3.3 uses Bootstrap, where Joomla! 2.5 does not. The Bootstrap mark-up gives your Joomla! website the ability to become responsive, which means that your Joomla! website should look great in all viewing devices (desktop, tablets and mobile phones)
  • Joomla! 3.3 uses jQuery, where Joomla! 2.5 does not.
  • Joomla! 3.3 needs PHP 5.3.10+, but Joomla! 2.5 will work on PHP 5.2.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:

  • Extension compatibility (in case you have installed some third-party extensions on your Joomla! 2.5 site that are not Joomla! 3.3 compatible)
  • 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 extensions 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 the various extension provider’s website’s 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 – we then suggest that you clone your Joomla! 2.5 website to a development server or sub-domain/folder and complete the upgrade process. Then move the upgraded site from the development location to your live site.
  2. Working on the cloned site; 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 cloned 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 cloned 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. Visit your Joomla! 3.3 Extensions Manager → and select Discover. Then click the Discover button in the top right corner. Then select the discovered item and click the ‘Install’ button in the top right.
  3. Visit your Joomla! 3.3 Extensions Manager → and select Database. This will confirm your Joomla! 3.3 database structure is up to date.
  4. 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.
  5. Install your new Joomla! 3.3 compatible template from your template provide and/or make any changes to your existing template.
  6. 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.

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.

If you have any questions about upgrading, feel free to contact us via online form, Facebook, Twitter, G-mail, e-mail, Skype or phone; all details can be found on our Contact page.

Sources

Click here to see the original article from Joomlapolis.com