Файл templateDetails.xml
Файл templateDetails.xml имеет следующую структуру:
<?xml version="1.0" encoding="utf-8"?>
<install version="1.5" type="template">
<name>JDevelop</name>
<creationDate>Февраль 2007</creationDate>
<author>Николай С.</author>
<copyright>GPL</copyright>
<authorEmail>snikolai07@mail.ru</authorEmail>
<authorUrl>jdevelop.info</authorUrl>
<version>1.0</version>
<description>Шаблон для создания раскладки сайта</description>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<filename>params.ini</filename>
<filename>...</filename>
</files>
<languages>
<language tag="en-GB">en-GB.tpl_JDevelop.ini</language>
<language tag="ru-RU">ru-RU.tpl_JDevelop.ini</language>
</languages>
<positions>
<position>left</position>
</positions>
<params />
</install>
В секции files перечисляются все файлы шаблона.
CSS файл можно разбить на несколько файлов:
<filename>css/layout.css</filename>
<filename>css/modules.css</filename>
<filename>css/menus.css</filename>
<filename>css/template.css</filename>
<filename>css/editor.css</filename>
<filename>css/ie6only.css</filename>
<filename>css/ie7only.css</filename>
Файл layout для css структуры шаблона, modules и menus соответственно для модулей и меню, template для общего форматирования и компонент. Файл editor для размещения классов, которые будут использоваться при редактировании в визуальном редакторе.
В секции positions перечисляются позиции, определенные в шаблоне. Наличие этой секции удобно тем, что позицию можно выбрать из списка в свойствах модуля. Отсутствие этой секции не помешает прописывать нужные позиции для модулей, но придется тогда лезть в файл index, чтобы посмотреть какие позиции есть в шаблоне.
В params указываются параметры шаблона. Например:
<params>
<param name="iepng" type="radio" default="1" label="IE PNG" description="IE PNG DESC">
<option value="1">Yes</option>
<option value="0">No</option>
</param>
</params>
Если параметры в шаблоне не используются, то вместо того, что выше:
<params />
Значения параметров хранятся в файле params.ini
Использовать параметры в файле index можно, например, так:
<?php if($this->params->get( 'iepng', 1 )) : ?>
.iepng { behavior: url(<?php echo $tmpTools->templateurl(); ?>/iepngfix.htc) }
<?php endif; ?>
Если в файле index будут использоваться какие-то слова не латиницей, то можно файл index сохранить в формате utf-8 без BOM и вставлять текст в него напрямую.
Если оставить файл в формате ansi, то нужно будет использовать языковые ini файлы. Эти файлы добавляются в секции languages. Если используется первый вариант эту секцию можно пропустить.
CSS файлы ie6only.css и ie7only.css используются для корректировки нестандартного поведения браузера IE с помощью условных комментариев.