The Joomla! Forum ™



Forum rules


Forum Rules
Absolute Beginner's Guide to Joomla! <-- please read before posting, this means YOU.



Post new topic Reply to topic  [ 23 posts ] 
Author Message
PostPosted: Wed Jan 02, 2008 5:37 pm 
User avatar
Joomla! Guru
Joomla! Guru

Joined: Sun Aug 28, 2005 11:23 am
Posts: 958
Location: New York
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.


Last edited by rw1 on Mon Jan 07, 2008 8:03 pm, edited 1 time in total.

Top
 Profile  
 
PostPosted: Wed Jan 02, 2008 6:58 pm 
User avatar
Joomla! Champion
Joomla! Champion

Joined: Sun Aug 21, 2005 2:25 pm
Posts: 6217
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


Top
 Profile  
 
PostPosted: Wed Jan 02, 2008 7:37 pm 
User avatar
Joomla! Guru
Joomla! Guru

Joined: Sun Aug 28, 2005 11:23 am
Posts: 958
Location: New York
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:)


Top
 Profile  
 
PostPosted: Wed Jan 02, 2008 7:41 pm 
User avatar
Joomla! Champion
Joomla! Champion

Joined: Sun Aug 21, 2005 2:25 pm
Posts: 6217
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

_________________
Co-author of the Official Joomla! Book http://officialjoomlabook.com
Marpo Multimedia http://marpomultimedia.com


Top
 Profile  
 
PostPosted: Wed Jan 02, 2008 10:59 pm 
User avatar
Joomla! Guru
Joomla! Guru

Joined: Sun Aug 28, 2005 11:23 am
Posts: 958
Location: New York
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 :)


Top
 Profile  
 
PostPosted: Thu Jan 03, 2008 2:25 am 
User avatar
Joomla! Champion
Joomla! Champion

Joined: Sun Aug 21, 2005 2:25 pm
Posts: 6217
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


Top
 Profile  
 
PostPosted: Thu Jan 03, 2008 2:30 am 
Joomla! Ace
Joomla! Ace

Joined: Sat Feb 10, 2007 8:26 pm
Posts: 1618
Here is a guide to template conversion in general that may help: http://tutorials.rockettheme.com/joomla ... ative.html

_________________
-Matt H
http://ninjaforge.com


Top
 Profile  
 
PostPosted: Thu Jan 03, 2008 3:00 am 
User avatar
Joomla! Champion
Joomla! Champion

Joined: Sun Aug 21, 2005 2:25 pm
Posts: 6217
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


Top
 Profile  
 
PostPosted: Mon Jan 07, 2008 7:02 pm 
User avatar
Joomla! Guru
Joomla! Guru

Joined: Sun Aug 28, 2005 11:23 am
Posts: 958
Location: New York
I did it - woo hoo!! ;D

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:
Quote:
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:
<?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:

Quote:
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:
<?php echo $mosConfig_live_site;?>

with
Code:
<?php $this->url ?>


and
Code:
'mosCount'

with
Code:
'$this->count'


and anything like
Code:
<?php mosLoadModules ( 'right',-2 ); ?>

becomes
Code:
<jdoc:include type="modules" name="right" style="xhtml" />


and
Code:
<?php mosMainBody(); ?>

with
Code:
<jdoc:include type="component" />


Now this is interesting...

Quote:
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:
<?php } ?>
<?php <jdoc:include type="component" />; ?>
<jdoc:include type="modules" name="gallery" style="xhtml" />

and it should have been
Code:
<?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.

Top
 Profile  
 
PostPosted: Mon Jan 07, 2008 8:27 pm 
User avatar
Joomla! Champion
Joomla! Champion

Joined: Sun Aug 21, 2005 2:25 pm
Posts: 6217
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!  :)

_________________
Co-author of the Official Joomla! Book http://officialjoomlabook.com
Marpo Multimedia http://marpomultimedia.com


Top
 Profile  
 
PostPosted: Mon Jan 07, 2008 8:30 pm 
User avatar
Joomla! Guru
Joomla! Guru

Joined: Sun Aug 28, 2005 11:23 am
Posts: 958
Location: New York
You're very welcome MMMedia. Thanks for the feedback :)


Top
 Profile  
 
PostPosted: Tue Jan 08, 2008 1:51 am 
User avatar
Joomla! Exemplar
Joomla! Exemplar

Joined: Thu Aug 18, 2005 8:43 pm
Posts: 7986
Location: New York
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.

_________________
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!.


Top
 Profile  
 
PostPosted: Sun Jan 13, 2008 1:11 pm 
User avatar
Joomla! Ace
Joomla! Ace
Online

Joined: Thu Aug 18, 2005 8:57 am
Posts: 1381
Location: Shrewsbury, Shropshire, United Kingdom
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/Tutorial:Upgrading_a_Joomla%21_1.0.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.

_________________
Chris Davenport - Joomla Production Leadership Team

Lion Coppice http://www.lioncoppice.org/
Davenport Technology Services http://www.davenporttechnology.com/


Top
 Profile  
 
PostPosted: Sun Jan 13, 2008 8:02 pm 
User avatar
Joomla! Guru
Joomla! Guru

Joined: Sun Aug 28, 2005 11:23 am
Posts: 958
Location: New York
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 :)


Top
 Profile  
 
PostPosted: Fri Jan 25, 2008 7:07 pm 
Joomla! Apprentice
Joomla! Apprentice

Joined: Mon Feb 26, 2007 11:15 pm
Posts: 31
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 :)

_________________
Olivier Borgognon
TDI - EFR - PADI Diving Instructor
http://www.hippocampes.com


Top
 Profile  
 
PostPosted: Fri Jan 25, 2008 7:17 pm 
User avatar
Joomla! Champion
Joomla! Champion

Joined: Sun Aug 21, 2005 2:25 pm
Posts: 6217
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


Top
 Profile  
 
PostPosted: Tue Jan 29, 2008 12:57 am 
Joomla! Apprentice
Joomla! Apprentice

Joined: Wed Dec 26, 2007 1:50 am
Posts: 27
Location: Serbia
The how-tos (both the one given here and the one on the external link) lack one important step:



should be changed to



Top
 Profile  
 
PostPosted: Sun Feb 10, 2008 11:56 pm 
User avatar
Joomla! Guru
Joomla! Guru

Joined: Mon Mar 20, 2006 8:17 am
Posts: 741
:-[ ... 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.

_________________
bento2go.com - We DO NOT sell bento !!


Top
 Profile  
 
PostPosted: Mon Feb 11, 2008 10:07 pm 
User avatar
Joomla! Guru
Joomla! Guru

Joined: Wed Aug 17, 2005 10:30 pm
Posts: 853
Location: Vienna, VA US
MMMedia 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.
Harry's Primer has been moved to http://prophead.halfvast.com/2008/01/24 ... ate-primer

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


Top
 Profile  
 
PostPosted: Fri Apr 25, 2008 12:24 pm 
User avatar
Joomla! Apprentice
Joomla! Apprentice

Joined: Thu Jul 19, 2007 1:15 pm
Posts: 13
Location: Barnsley, Yorkshire, England
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:
Quote:
... 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 onto the actual Wiki and found crucial pages with: "hhfhfhffhfffhhhhhhffhhffhh" in the description with no details whatsoever.

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?


Top
 Profile  
 
PostPosted: Tue May 19, 2009 7:17 pm 
User avatar
Joomla! Enthusiast
Joomla! Enthusiast

Joined: Mon Mar 13, 2006 9:35 pm
Posts: 192
Location: New Jersey, US
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?


Top
 Profile  
 
PostPosted: Tue May 19, 2009 10:26 pm 
Joomla! Explorer
Joomla! Explorer

Joined: Sat Dec 27, 2008 6:16 am
Posts: 314
Location: LA
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?


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.

_________________
Joomla Templates & VirtueMart Themes

http://www.vjtemplates.com


Top
 Profile  
 
PostPosted: Sat May 23, 2009 12:42 pm 
User avatar
Joomla! Guru
Joomla! Guru

Joined: Wed Aug 17, 2005 10:30 pm
Posts: 853
Location: Vienna, VA US
MMMedia 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.

Harry's Primer is available at http://portal.hrpr.com/2009/02/16/how-c ... -joomla-15

_________________
If you need a helping hand, use the one at the end of your own arm.
www.hrpr.com


Top
 Profile  
 
Display posts from previous:  Sort by  
Post new topic Reply to topic  [ 23 posts ] 



Who is online

Users browsing this forum: No registered users and 21 guests


You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot post attachments in this forum

Jump to:  
Powered by phpBB® Forum Software © phpBB Group