how to upgrade a 1.0.x template to a 1.5 template - tute and resources
Moderator: General Support Moderators
Forum rules
Forum Rules
Absolute Beginner's Guide to Joomla! <-- please read before posting, this means YOU.
Forum Rules
Absolute Beginner's Guide to Joomla! <-- please read before posting, this means YOU.
- rw1
- Joomla! Guru
- Posts: 958
- Joined: Sun Aug 28, 2005 11:23 am
- Location: New York
how to upgrade a 1.0.x template to a 1.5 template - tute and resources
hello,
i have a 1.0.x template template on a 1.0.x site and am wanting to upgrade to 1.5 - there is no 1.5 version of the template though.
can anybody tell me what things need to be changed to make it compatible with 1.5?
thank you,
rw1
Edit: Have upgraded my template successfully and documented my steps here.
i have a 1.0.x template template on a 1.0.x site and am wanting to upgrade to 1.5 - there is no 1.5 version of the template though.
can anybody tell me what things need to be changed to make it compatible with 1.5?
thank you,
rw1
Edit: Have upgraded my template successfully and documented my steps here.
Last edited by rw1 on Mon Jan 07, 2008 8:03 pm, edited 1 time in total.
- Jenny
- Joomla! Champion
- Posts: 6206
- Joined: Sun Aug 21, 2005 2:25 pm
- Contact:
Re: how to upgrade a 1.0.x template to a 1.5 template?
The best thing I can tell you is to look at the 1.5 template tutorials and blank template that are offered in this forum and do a comparison between the content calls that each makes.
Co-author of the Official Joomla! Book http://officialjoomlabook.com
Marpo Multimedia http://marpomultimedia.com
Marpo Multimedia http://marpomultimedia.com
- rw1
- Joomla! Guru
- Posts: 958
- Joined: Sun Aug 28, 2005 11:23 am
- Location: New York
Re: how to upgrade a 1.0.x template to a 1.5 template?
Thanks for your reply,
New Joomla! 1.5 Template Tutorial Documentation
Relates to "1.5 BETA tutorial [that] has a lot of good information but has NOT been updated for 1.5 RC1". So it doesn't appear there is documentation for RC4 yet.
I am looking at 'blank template' now, and am not sure what 'content calls' are...
Correct me if i'm wrong, but, looking at this skeleton template, it looks like there is a lot of new 'stuff' in a joomla 1.5 template, and so what i hoped would be possible (add a few lines of code to make it compatible with 1.5) looks like it is not really possible.
If anyone finds a tutorial explaining the changes somewhere it would be great if you could paste the link to it here.
Thanks,
rw1:)
New Joomla! 1.5 Template Tutorial Documentation
Relates to "1.5 BETA tutorial [that] has a lot of good information but has NOT been updated for 1.5 RC1". So it doesn't appear there is documentation for RC4 yet.
I am looking at 'blank template' now, and am not sure what 'content calls' are...
Correct me if i'm wrong, but, looking at this skeleton template, it looks like there is a lot of new 'stuff' in a joomla 1.5 template, and so what i hoped would be possible (add a few lines of code to make it compatible with 1.5) looks like it is not really possible.
If anyone finds a tutorial explaining the changes somewhere it would be great if you could paste the link to it here.
Thanks,
rw1:)
- Jenny
- Joomla! Champion
- Posts: 6206
- Joined: Sun Aug 21, 2005 2:25 pm
- Contact:
Re: how to upgrade a 1.0.x template to a 1.5 template?
I replied to your question in the other thread. Yes there has been updates. Please take a look at it.
One thing to note is you don't have to update your template at all most likely. Run 1.5 in legacy mode and your template should be just fine.
You can also check out HarryB's site and his 1.5 template primer. http://rc.hrpr.com/trunk/joomla-15-template-primer
One thing to note is you don't have to update your template at all most likely. Run 1.5 in legacy mode and your template should be just fine.
You can also check out HarryB's site and his 1.5 template primer. http://rc.hrpr.com/trunk/joomla-15-template-primer
Co-author of the Official Joomla! Book http://officialjoomlabook.com
Marpo Multimedia http://marpomultimedia.com
Marpo Multimedia http://marpomultimedia.com
- rw1
- Joomla! Guru
- Posts: 958
- Joined: Sun Aug 28, 2005 11:23 am
- Location: New York
Re: how to upgrade a 1.0.x template to a 1.5 template?
thank you for your reply
the template primer really asks the question 'What Has Changed?' - which is great!
just a related question - if i switch on legacy mode, does that mean extensions specifically made for 1.5 won't work?
thank you,
rw1
the template primer really asks the question 'What Has Changed?' - which is great!
just a related question - if i switch on legacy mode, does that mean extensions specifically made for 1.5 won't work?
thank you,
rw1
- Jenny
- Joomla! Champion
- Posts: 6206
- Joined: Sun Aug 21, 2005 2:25 pm
- Contact:
Re: how to upgrade a 1.0.x template to a 1.5 template?
Yes it does most likely, at least in my experience if you enable legacy mode it affects the whole, not just parts.
Co-author of the Official Joomla! Book http://officialjoomlabook.com
Marpo Multimedia http://marpomultimedia.com
Marpo Multimedia http://marpomultimedia.com
-
- Joomla! Ace
- Posts: 1618
- Joined: Sat Feb 10, 2007 8:26 pm
Re: how to upgrade a 1.0.x template to a 1.5 template?
Here is a guide to template conversion in general that may help: http://tutorials.rockettheme.com/joomla ... ative.html
-Matt H
http://ninjaforge.com
http://ninjaforge.com
- Jenny
- Joomla! Champion
- Posts: 6206
- Joined: Sun Aug 21, 2005 2:25 pm
- Contact:
Re: how to upgrade a 1.0.x template to a 1.5 template?
Awesome link Matt! I knew there was something out there, I just couldn't remember where...
Co-author of the Official Joomla! Book http://officialjoomlabook.com
Marpo Multimedia http://marpomultimedia.com
Marpo Multimedia http://marpomultimedia.com
- rw1
- Joomla! Guru
- Posts: 958
- Joined: Sun Aug 28, 2005 11:23 am
- Location: New York
Re: how to upgrade a 1.0.x template to a 1.5 template?
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:
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 :
RocketTheme points out:
with
and
with
and anything like
becomes
and
with
Now this is interesting...
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:
and it should have been
Mod edit: Harry B's Template Primer is offline currently. Link has been removed at this time. - MMMedia
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:
We are going to do number 2.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
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>
Still in Dreamweaver, use the Find and Replace function and change:Observe how becomes redundant and is dropped and getTemplate(); ?> is replaced with template ?> which is shorter and cleaner.
Code: Select all
<?php echo $mosConfig_live_site;?>
Code: Select all
<?php $this->url ?>
Code: Select all
'mosCount'
Code: Select all
'$this->count'
Code: Select all
<?php mosLoadModules ( 'right',-2 ); ?>
Code: Select all
<jdoc:include type="modules" name="right" style="xhtml" />
Code: Select all
<?php mosMainBody(); ?>
Code: Select all
<jdoc:include type="component" />
RocketThemeThe 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.
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" />
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
Last edited by Jenny on Fri Jan 25, 2008 7:22 pm, edited 1 time in total.
- Jenny
- Joomla! Champion
- Posts: 6206
- Joined: Sun Aug 21, 2005 2:25 pm
- Contact:
Re: how to upgrade a 1.0.x template to a 1.5 template - tute and resources
That is an awesome post! Thank you so much for sharing your experience and new found knowledge with everyone. I know this has been an often asked question on the both the 1.0 forums and the 1.5 forums. I am going to bring that post to the attention of the documentation team, and tips and trick forum mods so they can take a look.
Thank you again! Great work!
Thank you again! Great work!
Co-author of the Official Joomla! Book http://officialjoomlabook.com
Marpo Multimedia http://marpomultimedia.com
Marpo Multimedia http://marpomultimedia.com
- rw1
- Joomla! Guru
- Posts: 958
- Joined: Sun Aug 28, 2005 11:23 am
- Location: New York
Re: how to upgrade a 1.0.x template to a 1.5 template - tute and resources
You're very welcome MMMedia. Thanks for the feedback
- mcsmom
- Joomla! Exemplar
- Posts: 7897
- Joined: Thu Aug 18, 2005 8:43 pm
- Location: New York
- Contact:
Re: how to upgrade a 1.0.x template to a 1.5 template - tute and resources
rw1,
would you want to make a new copy of your post and post it over in Tips & Tricks?
I think we will be getting a lot of people looking for information like this.
would you want to make a new copy of your post and post it over in Tips & Tricks?
I think we will be getting a lot of people looking for information like this.
So we must fix our vision not merely on the negative expulsion of war, but upon the positive affirmation of peace. MLK 1964.
http://officialjoomlabook.com Get it at http://www.joomla.org/joomla-press-official-books.html Buy a book, support Joomla!.
http://officialjoomlabook.com Get it at http://www.joomla.org/joomla-press-official-books.html Buy a book, support Joomla!.
- Chris Davenport
- Joomla! Ace
- Posts: 1370
- Joined: Thu Aug 18, 2005 8:57 am
- Location: Shrewsbury, Shropshire, United Kingdom
Re: how to upgrade a 1.0.x template to a 1.5 template - tute and resources
What I'd really like is if you could put it into the 1.5 Template Tutorials page here: http://www.developer.joomla.org/wiki/Tu ... x_template
I'm planning to move this stuff to the new docs.joomla.org wiki soon, but if you'd like to update it before then I'll get write access for you.
Thanks,
Chris.
I'm planning to move this stuff to the new docs.joomla.org wiki soon, but if you'd like to update it before then I'll get write access for you.
Thanks,
Chris.
Chris Davenport
Davenport Technology Services http://www.davenporttechnology.com/
Lion Coppice http://www.lioncoppice.org/
Davenport Technology Services http://www.davenporttechnology.com/
Lion Coppice http://www.lioncoppice.org/
- rw1
- Joomla! Guru
- Posts: 958
- Joined: Sun Aug 28, 2005 11:23 am
- Location: New York
Re: how to upgrade a 1.0.x template to a 1.5 template - tute and resources
hey guys, sorry for the delay in responding, i've been busy in getting other extensions working in my new 1.5 site, please feel free to use the document as you wish - if u need me to place it somewhere specifically, please let me know. all the best, rw1
-
- Joomla! Apprentice
- Posts: 31
- Joined: Mon Feb 26, 2007 11:15 pm
Re: how to upgrade a 1.0.x template to a 1.5 template - tute and resources
hi everyone,
does anyone have another link to the joomla 1.5 template primer... the site is down (or a personal site with a webserver disconnected) can't access it anyone for a pdf of it ?)
cheers,
thanks for the tutorial and explanation btw
does anyone have another link to the joomla 1.5 template primer... the site is down (or a personal site with a webserver disconnected) can't access it anyone for a pdf of it ?)
cheers,
thanks for the tutorial and explanation btw
- Jenny
- Joomla! Champion
- Posts: 6206
- Joined: Sun Aug 21, 2005 2:25 pm
- Contact:
Re: how to upgrade a 1.0.x template to a 1.5 template - tute and resources
I think HarryB has moved it, as it was for testing of the RCs. I don't think a pdf of it was ever available. The other resources listed should have most all of the information contained in Harry's Primer. I will remove the link to the primer for now.
Co-author of the Official Joomla! Book http://officialjoomlabook.com
Marpo Multimedia http://marpomultimedia.com
Marpo Multimedia http://marpomultimedia.com
-
- Joomla! Apprentice
- Posts: 27
- Joined: Wed Dec 26, 2007 1:50 am
- Location: Serbia
- Contact:
Re: how to upgrade a 1.0.x template to a 1.5 template - tute and resources
The how-tos (both the one given here and the one on the external link) lack one important step:
should be changed to
should be changed to
- mihu
- Joomla! Guru
- Posts: 741
- Joined: Mon Mar 20, 2006 8:17 am
Re: how to upgrade a 1.0.x template to a 1.5 template - tute and resources
... this is my step by step tutorial ... http://forum.joomla.org/index.php/topic,180145.0.html
Once I verify the new version from my site, I will update this one.
Once I verify the new version from my site, I will update this one.
bento2go.com - We DO NOT sell bento !!
- HarryB
- Joomla! Guru
- Posts: 851
- Joined: Wed Aug 17, 2005 10:30 pm
- Location: Vienna, VA US
Re: how to upgrade a 1.0.x template to a 1.5 template - tute and resources
Harry's Primer has been moved to http://prophead.halfvast.com/2008/01/24 ... ate-primerMMMedia wrote: I think HarryB has moved it, as it was for testing of the RCs. I don't think a pdf of it was ever available. The other resources listed should have most all of the information contained in Harry's Primer. I will remove the link to the primer for now.
The site it was on was an unstable test site, so it was moved to a site that is stable and has much higher availability...and has also been updated a bit.
If you need a helping hand, use the one at the end of your own arm.
www.hrpr.com
www.hrpr.com
- WayneSmallman
- Joomla! Apprentice
- Posts: 13
- Joined: Thu Jul 19, 2007 1:15 pm
- Location: Barnsley, Yorkshire, England
- Contact:
Re: how to upgrade a 1.0.x template to a 1.5 template - tute and
I really appreciate all the work you guys are putting into the documentation, but this one post typifies what I've experienced over the past two years when working with the Joomla! CMS. For example:
I've been searching for over 4 hours — most of the time just going around in a vast circle — searching for a guide to upgrading a 1.0.x template to 1.5.x.
Sadly, this thread has only left me even more confused than I was when I started out.
Is it not possible for someone, or a group of people to centralize all of the documentation for template migrations / upgrades?
I've been onto the actual Wiki and found crucial pages with: "hhfhfhffhfffhhhhhhffhhffhh" in the description with no details whatsoever.... function and replace:
Big blank space, which should presumably contain something but actually doesn't!
with
Yet another big blank space!
[with a space under it]
And that will add spaces so it is easier to read
I've been searching for over 4 hours — most of the time just going around in a vast circle — searching for a guide to upgrading a 1.0.x template to 1.5.x.
Sadly, this thread has only left me even more confused than I was when I started out.
Is it not possible for someone, or a group of people to centralize all of the documentation for template migrations / upgrades?
- konczal
- Joomla! Explorer
- Posts: 271
- Joined: Mon Mar 13, 2006 9:35 pm
- Location: New Jersey, US
Re: how to upgrade a 1.0.x template to a 1.5 template - tute and
I tried to download the Joomla.Template.XML.Generator from the link specified about and would up on a foreign language page (German?). I wound up downloading something called "Artisteer 2" - not Joomla.Template.XML.Generator.
Does anyone have a correct link to Joomla.Template.XML.Generator?
Does anyone have a correct link to Joomla.Template.XML.Generator?
-
- Joomla! Explorer
- Posts: 314
- Joined: Sat Dec 27, 2008 6:16 am
- Location: LA
- Contact:
Re: how to upgrade a 1.0.x template to a 1.5 template - tute and
Rather than using the generator which finally end up with more editing that creating, better just copy the templateDetails.xml from the default templates, then edit as necessary.konczal wrote:I tried to download the Joomla.Template.XML.Generator from the link specified about and would up on a foreign language page (German?). I wound up downloading something called "Artisteer 2" - not Joomla.Template.XML.Generator.
Does anyone have a correct link to Joomla.Template.XML.Generator?
- HarryB
- Joomla! Guru
- Posts: 851
- Joined: Wed Aug 17, 2005 10:30 pm
- Location: Vienna, VA US
Re: how to upgrade a 1.0.x template to a 1.5 template - tute and
Harry's Primer is available at http://portal.hrpr.com/2009/02/16/how-c ... -joomla-15MMMedia wrote: I think HarryB has moved it, as it was for testing of the RCs. I don't think a pdf of it was ever available. The other resources listed should have most all of the information contained in Harry's Primer. I will remove the link to the primer for now.
If you need a helping hand, use the one at the end of your own arm.
www.hrpr.com
www.hrpr.com