Joomla Template konvertieren 1.5 zu 1.6

Wie bereits beim Wechsel der Templates von 1.0 zu 1.5 können diese auch unter Joomla 1.6 nicht einfach so verwendet werden. Um die Vorgänger-Templates zum Laufen zu bekommen, sind mindestens die folgenden Code-Änderungen durchzuführen. Je nach Aufbau der html/css-Dateien sind noch individuelle Anpassungen der genutzen css-Klassen und/oder auch die Einstellungen bei den Menüs und Module notwendig.

Was ist mindestens zu ändern:

1. index.php
2. templateDetails.xml
3. template.css / template.css.php
4. error.php

Code in den jeweiligen Template index.php Dateien:

defined( '_JEXEC' ) or die( 'Restricted access' );
ändern in
defined( '_JEXEC' ) or die;

Weiter ist die Variablen $mainframe aus 1.5 zu ersetzten:

$app = JFactory::getApplication();

aus  z.B. $mainframe->getCfg('live_site');
wird $app->getCfg('live_site');

Weitere Anpassungen der Verlinkung zu Javascript und css-Dateien sind ggfls. zu modifizieren.

Codeändeurngen im Kopfbereich in der templateDetails.xml:

<!DOCTYPE install PUBLIC "-//Joomla! 1.5//DTD template 1.0//EN" 
"http://dev.joomla.org/xml/1.5/template-install.dtd">
<install version="1.5" type="template">

zu

<!DOCTYPE install PUBLIC "-//Joomla! 1.6//DTD template 1.0//EN"
"http://www.joomla.org/xml/dtd/1.6/template-install.dtd">
<install version="1.6" type="template">

Weiter hat sich die Methode der Parameter verändert im Stile von:

<params>
 <param name="templateTheme" type="list" default="theme1" 
label="Template Theme" description="Bitte Template Theme wählen">
 <option value="theme1">Theme 1</option>
 <option value="theme2">Theme 2</option>
 </param>
</params>

zu

<config>
 <fields name="params">
 <fieldset name="advanced">
 <field name="templateTheme" type="list" default="theme1"
label="Template Theme" description="Bitte Template Theme wählen">
 <option value="theme1">Theme 1</option>
 <option value="theme2">Theme 2</option>
 </field>
 </fieldset>
 </fields>
</config>

Weiter können Parameter jetzt mit fieldset, z. B. in basic und advanced, gruppiert werden.

CSS-Änderungen in template.css und template.css.php sind z.B.

.article_separator 
zu
.item-separator

oder

.blog_more
zu
.items-more

und für die Aktionsleiste "buttonheading" gilt nun <div class="actions">...</div> mit <ul> Listung.

Je nachdem welche weiteren Elemente (z.B. Menü Kategrie-Listing) verwendet wurden sind auch diese neuen Klassen anzupassen. Dazu ist der HTML/CSS-Code der Site im Detail zu prüfen und in der css-Datei anzupassen. Hilfreich hierbei ist z.B. der Firefox-Erweiteruing "firebug".

Code-Anpassungen in der error.php:

$this->error->code;
$this->error->message;
zu
$this->error->getCode();
$this->error->getMessage();

Je nach Einsatz ist es unter 1.6 nun auch einfacher möglich Sprachdateien zu verwenden, indem diese ins Template-Verzeichnis unter "language" abgelegt werden.

Die Anleitung wurde mit Hilfe der folgenden Quellen/Sites erstellt (Vielen Dank an die Autoren):

• Joomla 1.6 Templates: What Designers Should Know
• Joomla 1.5 to 1.6 Template Upgrade Tutorial (Part 1)