I did it - woo hoo!!
Here are the steps i took, and the resources i used, to successfully upgrade my template.
Target Audience
For people with:
- Some experience in making Joomla 1.0.x templates who want to upgrade one of their templates to be compatible with 1.5RC4 +.
- Dreamweaver (optional - if u dont have it you can improvise with what u do have)
- Windows .NET 2.0 Framework. (optional - ditto above)
Like a Samurai!
Lets do this as quickly and painlessly as possible, don't start surfing tangents, checking facebook, researching or anything, just do as instructed and it will be over quicker!
What are we doing?
According to this
very helpful document by RocketTheme, there are two ways to convert a 1.0.x template to a 1.5 template:
1. Full conversion:
Convert a Joomla! template for the 1.0x series and make it compatible with Joomla! 1.5 and also take advantage of all the new features available with Joomla! 1.5.
2. Native conversion:
Convert a Joomla! template for the 1.0x series and make it compatible with Joomla! 1.5 but not take an advantage of the new features of Joomla! 1.5
We are going to do number 2.
Download these:
Joomla.Template.XML.Generator
Joomla! 1.5 templatebuilder for Dreamweaver
What has changed in 1.5 templating?
" Just about everything!"
[url=http://]Joomla 1.5 Template Primer[/url]
Let's go:
Make a copy on your computer of your existing template including all files and folders and then:
- Open the Joomla Template XML Generator.
- Fill in the info
- Leave 'Parameters' blank (for now)
- Set compatibility to 1.5
- 'Open Directory' of your copied template
- Create XML-file.
You have your xml file - don't rest on your laurels yet, let's keep going:
- Open Dreamweaver
- Install Joomla! 1.5 templatebuilder for Dreamweaver like so:
-Commands>Manage Extensions>Click 'Install New Extension' icon.
- Restart Dreamweaver
- Open your copy of your templates index.php
- Insert this right at the top replacing everything before :
Code: Select all
<?php defined( '_JEXEC' ) or die( 'Restricted index access' );?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="<?php echo $this->language; ?>" lang="<?php echo $this->language; ?>" >
<head>
<jdoc:include type="head" />
<link rel="stylesheet" href="templates/_system/css/general.css" type="text/css" />
<link rel="stylesheet" href="templates/<?php echo $this->template ?>/css/template.css" type="text/css" />
</head>
RocketTheme points out:
Observe how becomes redundant and is dropped and getTemplate(); ?> is replaced with template ?> which is shorter and cleaner.
Still in Dreamweaver, use the Find and Replace function and change:
Code: Select all
<?php echo $mosConfig_live_site;?>
with
and
with
and anything like
Code: Select all
<?php mosLoadModules ( 'right',-2 ); ?>
becomes
Code: Select all
<jdoc:include type="modules" name="right" style="xhtml" />
and
with
Now this is interesting...
The module syntax change is probably the most dramatic. The normal loader for a module in the Joomla! 1.0x series is with the name of the module between the ' ' tags followed by a number which is either -3,-2,-1,0 or 1. Joomla! 1.5 takes a differnt approach with using again, there are 5 default options, rounded(-3), xhtml(-2), raw(-1), table(0) and horiz(1). Therefore, we need to change all instances of to the Joomla! 1.5 syntax.
RocketTheme
Save your index.php.
Open your new templateDetails.xml file
For some reason the xml generator doesn't put line spaces or formatting to the xml file, so for the first bit (author details etc) you will have to add spaces by hand but for the file lists use the 'Find and Replace' function and replace:
with
[with a space under it]
And that will add spaces so it is easier to read
Also, the xml generator does not output case sensitive file names, which the template installer needs, so u manually have to change any letters that should be capital in the file names within the templateDetails.xml file.
Nearly There
Still in the xml file, remove which was automatically created by the xml generator.
Search for name= in your index.php and where it refers to a module position, make sure that the module position name is included in your xml file right before like this:
gallery
banner
left
right
user1
user2
user3
user5
user8
user11
user12
user13
user14
user15
user16
user17
user18
And that should be it!
Zip your new folder and install it as per usuual.
Please PM me with corrections or suggestions on ways to improve this tutorial.
All the best,
rw1
Disclaimer - This is what i did to upgrade my 1.0.x template to a 1.5RC4 compatible one and it worked, it might not work in all cases in which case the forum is here to help. Also, here is also a list of other 1.5 template upgrading tutes and resources:
[url=http://]Joomla! 1.5 Template Primer[/url]
Joomla! 1.5 Native?
Tutorial: Upgrading a Joomla! 1.0.x template
Joomla! 1.5 Template Tutorials
Also if things aren't working out i found this php checker:
http://www.meandeviation.com/tutorials/ ... tax-check/
it helped me when i had:
Code: Select all
<?php } ?>
<?php <jdoc:include type="component" />; ?>
<jdoc:include type="modules" name="gallery" style="xhtml" />
and it should have been
Code: Select all
<?php } ?>
<jdoc:include type="component" />
Mod edit: Harry B's Template Primer is offline currently. Link has been removed at this time. - MMMedia