This site uses a tool called Snap Shots that enhances its external links with visual previews of the destination site. Should you decide this is not for you, just position the cursor over the gear-shaped "Options" icon in the upper right corner of the snap shot window and choose the "Disable" entry.
Joomla! 1.5 Templates - TemplateDetails.xml
templateDetails.xml
What is This?
In simple terms, the templateDetails.xml file tells the template installer what to install, where to install it, and other advanced stuff such as what options will be available for managing the template once it is installed . The examples shown below illustrate the what and where. The more advanced control functions are beyond the scope of this discussion.
What Has Changed?
When modifying a Joomla!. 1.0.x template to function for use with Joomla! 1.5, the templateDetails.xml file requires some changes. I guess the best way to describe the basic changes is by example. In the examples below, red and green text highlight the major differences. I hope I haven't missed any! But if I have, feel free to let me know.
| Simple Joomla! 1.0.x Install File |
<?xml version="1.0" encoding="iso-8859-1" ?> <mosinstall type="template"> <name>hrpr_gray_hz</name> <creationDate>2005-10-16</creationDate> <author>John Doe</author> <copyright>John Doe</copyright> <authorEmail>jmdoe@some-domain.com</authorEmail> <authorUrl>www.some-domain.com</authorUrl> <version>1.0.x</version> <description>Joomla 1.0.x Sample templateDetails file</description> <files> <filename>index.php</filename> <filename>template_thumbnail.png</filename> <filename>scripts/digiclock.js</filename> <filename>scripts/hide.js</filename> </files> <images> <filename>images/comp010.jpg</filename> <filename>images/arrow3up.gif</filename> <filename>images/arrow3down.gif</filename> <filename>images/search.png</filename> <filename>images/thepoint2.png</filename> <filename>images/hrbanner1.png</filename> <filename>images/arrow.png</filename> <filename>images/arrowgray.png</filename> <filename>images/leftspacer.png</filename> <filename>images/homepage.png</filename> <filename>images/arrowright.png</filename> </images> <css> <filename>css/template_css.css</filename> </css> </mosinstall> |
| Simple Joomla! 1.5 Install File |
<?xml version="1.0" encoding="utf-8" ?> <install version="1.5" type="template"> <name>hrpr_gray_var</name> <author>Jane Doe</author> <copyright>Jane Doe</copyright> <authorEmail>jfdoe@some-domain.com</authorEmail> <authorUrl>www.some-domain.com</authorUrl> <license>GNU/GPL</license> <version>1.5</version> <description>Joomla 1.5! sample templateDetails file</description> <files> <filename>index.php</filename> <filename>templateDetails.xml</filename> <filename>template_thumbnail.png</filename> <filename>scripts/index.html</filename> <filename>scripts/digiclock.js</filename> <filename>images/index.html</filename> <filename>images/comp010.jpg</filename> <filename>images/arrow3up.gif</filename> <filename>images/arrow3down.gif</filename> <filename>images/search.png</filename> <filename>images/thepoint2.png</filename> <filename>images/hrbanner1.png</filename> <filename>images/arrow.png</filename> <filename>images/arrowgray.png</filename> <filename>images/leftspacer.png</filename> <filename>images/homepage.png</filename> <filename>images/arrowright.png</filename> <filename>images/smdsmall.png</filename> <filename>css/index.html</filename> <filename>css/template_css.css</filename> </files> <positons> <position>top</position> <position>left</position> <position>right</position> <position>bottom</position> <position>advert1</position> <position>syndicate</position> <position>footer</position> <position>user1</position> <position>user2</position> <position>user3</position> <position>user4</position> <position>user5</position> <position>user6</position> <position>user7</position> <position>user8</position> <position>user9</position> <position>user10</position> </positions> </install> |
Note the addition of the <positions> section and <position> directives. This is a major change from Joomla! 1.0.,x to Joomla 1.5. The temlplate's module positions are now defined in the templateDetails.xml file rather than in the Joomla! administrator interface. Also, the administrator interface no longer supports the "Preview with Module Positions" function included in Joomla! 1.0.x. To see a preview with the module positions included, use the following url syntax:
- http://your-domain-name.your-domain-suffix/index.php?tp=1
