In this tutorial, we will show how to convert a Joomla 1.5 template to Joomla 2.5 template. We will take default Joomla 1.5 template "rhuk_milkyway" as an example and convert it to Joomla 2.5 native compatible template.
Note:
This tutorial covers only the template conversion process, so it's assumed that you already have a Joomla 2.5 website installed, or converted from version 1.5.
There are 5 steps involved.
The first thing to do is to copy the whole theme folder from version 1.5 to version 2.5
Copy the whole template folder
Now, you need to edit the folder structure to make it compatible with Joomla 2.5
Edit folder structure to make it compatible
In version 1.5 this file used to store values of template parameters. But in version 2.5, all template parameters are stored in the database. So there is no need for file "params.ini".
Joomla 2.5 introduces new file "error.php" to contain layout of error pages. This file is simple and we can reuse the file from default theme "atomic".
Joomla 2.5 introduces new file "template_preview.png" to present a big preview image of the theme. You need to make a 640x480 screenshot of your theme and name it "template_preview.png".
Now, you need to edit file "templateDetails.xml" to make it compatible with version 2.5.
Old value |
New value |
<install version="1.5"... |
<extension version="2.5"... |
</install> |
</extension> |
This is very cool feature of Joomla 2.5. Now you don't need to declare all the files in some folder, you just need to declare that folder.
Add 2 following tags:
Old value |
New value |
<params> |
<config> |
<param... |
< field... |
</param> |
</ field> |
</params> |
</fieldset> |
After editing file "templateDetails.xml", you need to continue to edit file "index.php".
Add code string "JHtml::_('behavior.framework', true);" to the location as seen on the screenshot bellow.
Joomla 2.5 allows you to get the theme name directly from file "templateDetails.xml" file, so there is no need to declare the theme name as plain text.
Old Value |
New value |
rhuk_milkyway |
<?php echo $this->template ?> |
Now, the converted Joomla 2.5 template is presented in templates folder, but you won't see new theme in Template Manager, because it's not installed yet. Make following steps:
Select the item "rhuk_milkyway25" in the list and click button "Install"
We finished the Joomla template migration with template "rhuk_milkyway" for today. Do you have any other ways to convert your template from version 1.5 to version 2.5 ? Please share using comment form belows. Feel free to leave questions if you get trouble with this migration process.
By accepting you will be accessing a service provided by a third-party external to https://magazine.joomla.org/
Comments