Inhaltsverzeichnis
die templateDetails.xml
<!DOCTYPE install PUBLIC "-//Joomla! 1.6//DTD template 1.0//EN" "http://www.joomla.org/xml/dtd/1.6/template-install.dtd">
<!-- MUSS Seit Joomla 1.6 ist der Installer universell. Also wichtig, version="1.6" type="template" client="site" angeben -->
<extension
version="1.6"
type="template"
client="site" >
<!-- SOLLTE Der Annzeige-Name in Joomla -->
<name>Test-Template</name>
<!--SOLLTE Erstellungsdatum -->
<creationDate>25.09.2011</creationDate>
<!-- SOLLTE Wer ist der Urheber -->
<author>Joomla-Templates</author>
<!-- SOLLTE für ausgelieferte Templates immer eine Kontakt-E-Mail-Adressse -->
<authorEmail>info ät joomla-templates.de</authorEmail>
<!-- SOLLTE klar, die Webseite gehört dazu -->
<authorUrl>http://www.joomla-templates.de</authorUrl>
<!-- SOLLTE die eigene Versionsnummer -->
<version>1.0.0</version>
<!-- SOLLTE Die Template-Beschreibung wird hier als Joomla language mit einem Platzhalter versehen.
In diesem Template-Ordner befindet sich die Sprachdatei in der TPL_TEST_TEMPLATE_XML_DESCRIPTION hinterlegt ist -->
<description>TPL_TEST_TEMPLATE_XML_DESCRIPTION</description>
<!-- MUSS der Files-Tag bezeichnet den Block mit den Dateien und Ordnern die mit installiert werden -->
<files>
<folder>html</folder>
<folder>css</folder>
<folder>images</folder>
<folder>js</folder>
<folder>language</folder>
<!-- MUSS die Dateien werden direkt im Test-Template ordner angelegt -->
<!-- MUSS die Hauptdatei für die Ausgabe des Templates -->
<filename>index.php</filename>
<!-- MUSS jeder Ordner in Joomla ist mit einer Dummy-Html ausgestattet,
so werden Server Fehlermeldungen verhindert, falls sich doch ein Webseitenbesucher in ein Verzeichnis verirrt -->
<filename>index.html</filename>
<!-- SOLLTE das Browser-Tab icon macht sich immer gut -->
<filename>favicon.ico</filename>
<!-- MUSS diese Datei muss natürlich mit installiert werden -->
<filename>templateDetails.xml</filename>
<!--SOLLTE Im Joomla Backend in der Template-Verwaltung wird dieses Bild vom Layout angezeigt.
Am besten einen Screenshot der Webseiten Vorlage einfügen oder wenn die Seite fertig ist ein Browser-Screeenshot -->
<filename>template_thumbnail.png</filename>
<!-- SOLLTE, gerade wenn über mootools die squeeze Box aufgerufen wird -->
<filename>component.php</filename>
<!-- SOLLTE die Fehlerseite -->
<filename>error.php</filename>
</files>
<!-- MUSS das sind letztendlich die Positionen an die die Module geschickt werden-->
<positions>
<position>meine-topposition</position>
<position>linke-position</position>
<position>brotkrumen</position>
<position>zu-guter-letzt</position>
<!-- <position>ich-kann-später-noch-weitere-positionen-einfügen </position> -->
</positions>
</extension>
der Kopfteil
Diese vielen Kommentare benötigen wir nur für diese Tutorial, sie können später ganz entfernt werden. Zu einem ordentlichen Template sollten die Tags von bis <name> bis </version> mit den persönlichen Daten gefüllt werden. Dieser Teil gehört zu "good practice".
der Installationsteil
Dann zu den Ordnern <files> plural
- html hier kommen die Template-Overrides hinein
- css klar hier kommen die css-Dateien hinein, auch die für den IE
- images die Bilder und Sprites, die wir ausschließlich für dieses Template benötigen
- language der Sprachordner für diese Template
- js wer Javascript verwendet sollte die .js Dateien hier einfügen
Bitte immer eine "leere" index.html in die Ordner einfügen auch wenn beispielsweise keine .js Datei sich im Ordner /js befindet.
Die einzelnen Dateien, die sich direkt in diesem Template-Ordner befinden, werden mit öffnendem und schließendem <filename> ... </filename> bezeichnet.
Im Gegensatz zum <folder>, in den man eine beliebige Anzahl von Dateien packen kann, müssen bei <filename> die Dateien auch wirklich existieren. Andernfalls würde Joomla dies bei der Installation mit einer Fehlermeldung "Datei konnte nicht gefunden werden" quittieren.
der Template-Positionsteil
Den eigentlichen Installationsbereich in der templateDetails.xml haben wir soweit abgeschlossen und das Template ist installierbar. Wir haben allerdings die Geschichte mit den <positions> nicht geklärt. Dazu komme ich ein wenig später.