Aug 132013

Convert website from joomla 1.5 to joomla 2.5 Rev 2 shows you how simple it is to convert joomla 1.5 website to the latest version using jupgradepro.

Last Updated: December 7, 2019

Latest News: Fixed a broken link.


Latest News: I have fixed some broken links below.

Jupgrade has been upgraded to jUpgreadPRO. The jUpgrade version is the old generation version and it is advisable to install or upgrade to jUpgreadPRO version. Check out what’s new in the latest version of jUpgradePRO.

If you want to read about the latest Joomla version click on the following link latest-joomla-version.

Jupgrade is a great component that will help you convert your website to Joomla 2.5 or 3.1.5. Please read the following article Joomla Development Network to know more about Joomla’s life cycle.

Important: There are steps you need to take before you start upgrading and after you complete the upgrade to the latest Joomla version.

The following are the steps that I took to successfully convert a website.

1 ) Install jupgrade on your website following the instructions found in

2 ) Start working on your site, which is going to take some tweaking and editing depending on the template you use. My template is not compatible with IE 6, I have tweaked it a bit for IE 6 but I am not really concern as IE 6 is slowly been face out. I have installed an IE plugin to remind the visitor using an older version of IE, which may not display my website correctly. I will work a bit more on the code to get it to work a bit better for IE 6.

3 ) Make sure that all your plugins, modules and components are compatible with the new version of Joomla. I had to convert the code on one particular module for it to work properly. It took me some research and many hours but I was very happy to finally have it working :) It is better to delete a module, component or plugin that is not yet compatible with the latest Joomla version before upgrading. After I converted the website I had some issues trying to delete a file that did not exist or was not compatible with the latest version.

4 ) The following is a list of components installed that are compatible with Joomal 2.5. I have started to write some tutorials about the components listed below. This will be completed soon.

Admin Tools and Akeeba Backup are 2 components you should be running in your Joomla website. Akeeba Backup is the most easy and extremely useful component to have if you want to create backups.

5 ) Make sure that all links are working properly. There are many online sites that you can use to help you find those broken links. I have listed one 1) Link Diagnosis, and you can also download this excellent tool for windows 2) Xenu.

6 ) If you really want to know how well your site is doing check woorank, this tool will show the most common problems with your website and provide a guide to help you fix and repair some of the problems you are having that you might not even be aware. This is very important for better SEO optimization.

7 ) Make sure that you check and enable the banners that are not active. One of the reasons this occurs is because your previous version was using position left, right, banner etc and the new version comes with position-0, position-1, position-2 etc. Also when you activate your banners, check the type and select custom if you are using a custom code.

8 ) Once you are happy with your upgrade then follow the normal procedures to move your Joomla site from one folder to another folder as mentioned in step 1 from

9 ) Follow the steps carefully as illustrated below:

—-Move all the files and folders from your Joomla folder to the new directory. For example from public_html to public_html/oldjoomlasite

—-Move all the files and folders from jupgrade folder to public_html

—-Your site should be live with the new Joomla 1.7 look. To add more style to my site I changed the template with a Joomla 1.7 version template of the same style as I had with my previous version of Joomla 1.5. You might have to do the same with your template.

If you have any problems, one solution could be to check the following to make sure that the data is entered correctly.

Check your configuration.php file and make sure the following changes are set correctly:

From: var $log_path = ‘/home/user/public_html/jupgrade/logs’;

To: var $log_path = ‘/home/user/public_html/logs’;

From: var $tmp_path = ‘/home/user/public_html/jupgrade/tmp’;

To: var $tmp_path = ‘/home/user/public_html/tmp’;

From: var $ftp_root = ‘/public_html/jupgrade’;

To: var $ftp_root = ‘/public_html’;

From: var $live_site = ‘’;

To: var $live_site = ‘’;

You could also remove the content of the cache folder (public_html/cache in this example)

10 ) Very important, make a backup of both of your sites before you start working on the upgrade and before you move the new version mentioned on step 8, in case something goes wrong.

11 ) After you have moved the website to the root of your server if that is where you will be installing Joomla, delete the files from oldjoomlasite backup once you are happy with the new version. If anything goes wrong restore the the backup and find out where you weren’t wrong and try again. Remember there is no hurry so take your time and don’t rush.

12 ) Security is very important and I have added two plugins to secure Joomla. AdminExile which will protect your administration link, “remember admin tools mentioned above” also has some cool security level on the administration page. jHackGuard will prevent the most common attacks on your website.

Hopefully at this point everything is working ok and your site is live. Just keep checking especially on the backend to see if everything is working well. If you have any questions just post them here and I will be glad to help you.

I have come across this great component Art Adminer which will help you manage your database and remove any database tables that are obsolete plus much more. I have used it to remove old tables left behind from my Joomla 1.5 installation that I was not even aware that existed. Every time I noticed in Google webmasters tools some issues with my site and I did so many test and even installed some SEO plugins / components to fix some issues and I was not successful. Also every time I created a new module, I would see duplicate modules entries. I was ready to install and setup my website again but lucky that I am so persistent when it comes to searching for a solution and voila came across this great component. What a life saver :)

I hope this helps you to convert your website. I keep updating this tutorial, so keep coming back to read the updates.

Good luck :)

I have been working in IT since 1999 and I enjoy the challenges it brings me. I love developing websites with WordPress. I spend a lot of time helping out in forums. I have been writing tutorials since 2011. Now I am learning how to manage my own VPS "Virtual Private Server.

  37 Responses to “Convert Joomla 1.5 Website to Joomla 2.5 Rev 2”

  1. Hi, Neat post. There’s an issue together with your web site in web explorer, may check this? IE nonetheless is the market chief and a large element of people will pass over your wonderful writing because of this problem.

  2. Hai,
    I had download modules, templates,jform, etc.. in J1.5.23 . I upgraded to j1.7.3 . When i execute J1.7.3 , there is no downloaded modules, templates,jform .
    How can i move that ?

    • Hello Kalai, thank you for your question. Can you please explained what you mean by downloading templates, jform etc in Joomla 1.5.23?

      Did you make sure that all the modules on your Joomla 1.5.23 were updated and compatible with Joomla 1.7.3 and then installed jupgrade and followed my instructions here!!!

      Kind regards

  3. Hai,
    I download joomla template 31 , mod_aricloudcarousel , com_jupgrade 1.2.4 and Jform Component from browser .Then i create 5 to 6 article and i assign position also .Those are well work in Joomla 1.5.23 .
    I use com_jupgrade 1.2.4 for convert j1.5.23 to j1.7.3. I successfully upgrade to j1.7.3.

    http: //localhost/projects/public/   ---> J1.5.23
    http: //localhost/projects/public/jupgrade/  ---> j1.7.3

    But joomla template 31 , mod_aricloudcarousel , com_jupgrade 1.2.4 and Jform which are not j1.7.3.
    How can i fix that ?

    • Hello Kalai, let me get this right, you are saying that joomla template 31, mod_aricloudcarousel, com_jupgrade 1.2.4 and jform are not compatible with Joomla 1.7.3 or they are not showing in Joomla 1.7.3; is that what you mean?

      I also have noticed that you are running Joomla local on your computer from the link above. Unfortunately I cannot have a look at the links because they are local URL’s.

      If you are having problems with “joomla template 31, mod_aricloudcarousel, com_jupgrade 1.2.4 and jform”, may I suggest to install joomla 1.5.23 again on a different folder and only create a few articles then use jupgrade again and see what happens. It sounds like your local setup is not set up correctly. What are you using as a local server? Mamp, xamp or other?

      Kind regards

  4. Hai,
    Thank for information.I use xampp server . Yes , I create only 3 article and i install com_ jupgrade 1.2.4 . Then I choose 1.7 for navigation. I login to J1.7 page . I execute that , just it show the article pages. Is it possible to convert template 1.0 to 1.7 ?

    • Hello Kalai, you are welcome.

      First let me share with you that it would take a bit of tweaking a Joomla 1 template to make it into a Joomla 1.7.3 template. You should ask yourself is it worth it or not? I am sure there are many free Joomla 1.7.3 templates that can be formatted to look like the current template that you are using. I have a tutorial here in converting a html into a Joomla 1.5.23 template and it is a bit of work but NOT impossible.

      Now to your issue where you can only view the article pages. Joomla 1.7.3 works differently in some ways but the principle displaying of modules is still the same. You have to work with the modules just like you did with Joomla 1.5.23 and they have to point to the correct template. If you don’t associate the correct module and template then it will not display.

      Have a look at this tutorial about jupgrade and xamp
      This will provide you with some more information about your current situation.

      If you need some more information about how to display modules let me know.

      Kind regards

  5. Hi,

    JUpgrade has not worked for me since like 72hours now, I have been battling to upgrade my site from 1.5 to 1.7

    The Jugrade link doesn’t work at all.

    Pls help.


    • Hello Gax, thank you for your question. Have you followed my steps without missing any step? If you have can you please post here what the error message says if there are any error messages. Also can you tell me what do you mean by the jupgrade link not working?

      Kind regards

  6. Hai,
    I successfully migrate joomla 1.5 to joomla 1.7. I have a module named as ‘lefnav’ (type-> custom HTML). That is not display , when i execute that. This module will display as home page. Better execution in old version. Pls help

    • Hello Kalai, congratulations :). I am happy that finally you converted your old Joomla to the new Joomla version. Can you please explain a bit better what the problem is? This is what I understand, you have a module leftnav, which is a custom module? But it does not display anything is that correct? Have you had a look at the position that you are currently displaying your module? That could be the problem that you are having. If that is not the problem then have you tried to create another module “custom HTML” and copy and past the code from the module that does not work to the new module? Also if you decide to create a new module as per my previous example, make sure that you use a different module title.

      If you need more help just let me know.

  7. Hi there mates, its fantastic piece of writing concerning teachingand entirely defined, keep it up all the time.

  8. Hai,
    Thanks a Lot to help me.I did that changes . Now i have proper Output.Modules are properly displayed. Then my another confusion , jform is not displayed in new version.
    I copied com_jform from J1.5(Component>com_jform & Administrator>Component>com_jform) and i paste to J1.7.3.Then i choose ExtensionManager>Update>FindUpdate>Jform[J1.7.3]. Then i successfully install that component.After that jform is displayed in pop-up menu[Component>Jform]. When i click on jform I have the following Error

    Fatal error: Cannot pass parameter 2 by reference in C:\xampp\htdocs\projects\public\jupgrade\administrator\components\com_jforms\globals.php on line 31

    Jfrom Tables are occured in database.
    Can i have solution ?

  9. Magnificent goods from you, man. I have understand your stuff prior to and you’re simply extremely excellent. I actually like what you have obtained here, really like what you are stating and the way in which through which you assert it. You’re making it entertaining and you still care for to stay it smart. I can’t wait to read much more from you. This is really a great web site.

  10. Just desire to say your article is as surprising. The clearness on your submit is simply spectacular and that i could suppose you’re knowledgeable on this subject. Well together with your permission allow me to take hold of your feed to keep up to date with drawing close post. Thank you 1,000,000 and please carry on the enjoyable work.

  11. Outstanding post, I believe people should acquire a lot from this web blog its very user genial. So much great info on here :D.

  12. I am genuinely happy to glance at this weblog posts which includes lots of helpful facts, thanks for providing these information.

    • Thank you kindly for your comments about blog. I look forward to helping you with any questions that you might have in relations to Joomla.

  13. If you upgrade your site from 1.5 to 2.5 using the jUpgrade and making a backup beforehand, does it affect how the site appears in Google searches, ie how high it is on the list. Or if you upgrade, do you need to do all the work again and re-submit to the search engines?

    Basically is it just a cosmetic upgrade, or is it the same as deleting the old site and creating a new one?

    • Hello David, thank you for your question. If you upgrade from Joomla 1.5 to Joomla 2.5 it will not affect the search on Google. Google looks at the URL” domain name” and of course the content and other factors about a website which will appear in the search. You do not need to do all the work and resubmit it if you upgrade. It is not just a cosmetic upgrade, it has a new core design and better security. It has many new features that the old Joomla 1.5 was lacking and did not have or was never going to be implemented. It is also meeting with the latest standards on the market and has added many new features requested by the Joomla community. It it is a must to upgrade to Joomla 2.5 or else your site is likely to be hacked and it will become unstable as support for Joomla 1.5 will stop.

      I hope this helps you with your question.

      Kind regards

  14. Your tutorial saved my day. I had tried upgrading my Joomla website with jupgrade only to fail 12 times. I followed the steps mentioned above and voila it worked. Thanks again!

  15. Pretty nice post. I just stumbled upon your blog and wished to say
    that I have really enjoyed surfing around your blog posts.
    In any case I will be subscribing to your feed and I hope you write again very

    • Thank you for your comment. I hope you come back as I keep updating some of my post and of course I will be adding more post.

      Kind regards

  16. Nice blog here! Also your website loads up very fast!

    What web host are you using? Can I get your affiliate link to your host?
    I wish my website loaded up as quickly as yours lol

    • Thank you John for your comment. My host is Justhost, I have been with them for over 3 years now. If you need more information please let me know.

      Kind regards

  17. Not only your website was loading fast, but also your article was written very well.
    Don’t get me wrong, because I am using the Joomla 3.0 version and works well for me but I am also using Joomla for years and I can’t get enought of this super CMS!

    • Thank you Asad for your comment. I also love Joomla even though I spend most of the time using WordPress which I also love ;)

      Kind regards

  18. its useful and informative article

  19. Great post! a nice and helpful article! it will help in my future web development projects. thanks for sharing.

 Leave a Reply

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>



nineteen − 18 =