RSS   Twitter   Copiny   Copiny
Нашел ошибку? 

Выдели фрагмент текста с ошибкой или неточностью и нажми Ctrl+Enter!

Описание шаблона через templateDetails.xml

Разберем основные возможности и опции шаблонов Joomla, которые открываются нам с помощью файла "templateDetails.xml".

Для примера возьмем реальный файл из стандартного шаблона - "Beez". По умолчанию файл выглядит примерно так, как представлено ниже, за исключением того что мы укоротили список файлов (раздел "<files>...</files>")

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE install PUBLIC "-//Joomla! 1.5//DTD template 1.0//EN" "http://www.joomla.org/xml/dtd/1.5/template-install.dtd">
<install version="1.5" type="template">
    <name>beez</name>
    <creationDate>19 February 2007</creationDate>
    <author>Angie Radtke/Robert Deutz</author>
    <authorEmail>mail</authorEmail>
    <authorUrl>http://www.run-digital.com</authorUrl>
    <copyright></copyright>
    <license>GNU/GPL</license>
    <version>1.0.0</version>
    <description>Accessible template for Joomla 1.5</description>
    <files>
        <filename>params.ini</filename>
        <filename>templateDetails.xml</filename>
        <filename>template_thumbnail.png</filename>
        <filename>favicon.ico</filename>
        <filename>component.php</filename>
        <filename>css/layout.css</filename>
        <filename>html/com_contact/category/default.php</filename>
        <filename>html/index.html</filename>
        <filename>index.html</filename>
        <filename>index.php</filename>
        <filename>javascript/md_stylechanger.js</filename>
    </files>
    <languages>
        <language tag="en-GB">en-GB.tpl_beez.ini</language>
    </languages>
    <administration>
        <languages folder="admin">
            <language tag="en-GB">en-GB.tpl_beez.ini</language>
        </languages>
    </administration>
    <positions>
        <position>left</position>
        <position>right</position>
        <position>top</position>
        <position>breadcrumb</position>
        <position>user1</position>
        <position>user2</position>
        <position>user3</position>
        <position>user4</position>
        <position>debug</position>
        <position>syndicate</position>
    </positions>
    <params/>
</install>



Несколько общих замечаний:

  • Файл должен иметь имя "templateDetails.xml" (регистр букв важен!).
  • Должен быть сохранен в кодировке UTF, желательно без BOM (специальные невидимые символы).
  • Находиться файл должен в корне каталога шаблона, например для шаблона Beez адрес файла будет
    /templates/beez/templateDetails.xml.

 

Описание параметров XML:

* name - имя шаблона, никак не связано с названием директории. в которой расположен шаблон, применяется в основном для отображения в панели управления в "Менеджере шаблонов".

creationDate - дата создания шаблона, можно писать в произвольном формате, используется для панели управления.

author - автор шаблона, в произвольной форме, используется для панели управления.

authorEmail - email автора, для обратной связи, используется для панели управления.

authorUrl - домашняя страница автора.

copyright - копирайты автора.

license - лицензия, под которой распространяется шаблона Joomla (свободное ПО распространяется обычно под "GNU/GPL").

version - версия шаблона.

description - краткое текстовое описание шаблона, можно использовать html-код.

files - внутри перечисляются все файлы шаблона, каждый файл должен быть описан индивидуально, так как показано в примере и прописаны пути, где должен находиться этот файл. Используется этот список во время установки шаблона - встроенный установщик будет искать файлы в zip-архиве именно по тем путям которые прописаны в тегах "filename" и затем копировать к себе в директорию templates с указанными адресами.

languages - файлы локализаций, в атрибуте "tag" - вписываем краткое название языка (например, en-GB - английский, ru-RU - русский, и.т.д.), название файла должно быть в следующем формате:
"<краткое названия языка>.tpl_<название каталога шаблона>.ini" - например русский язык для стандартного шаблона "rhuk_milkyway" будет выглядеть так - "ru-RU.tpl_rhuk_milkyway.ini".

positions - список явно определенных позиций шаблона.


* - параметры с обязательным заполнением

Смотрите также:
Комментарии (6) Добавить комментарий
  • антигерой
    антигерой
    16 Июня 2011, 13:01
     ↑  0  ↓     ответ

    Может кто подскажет, как выводить в шаблоне отдельно тег DESCRIPTION ???

    TITLE понятно, вот так: <title><?php echo $mainframe->getPageTitle(); ?></title>

    А вот именно DESCRIPTION с названием статьи - так и не нашёл.

    • smet.denis
      smet.denis (админ)
      16 Июня 2011, 13:41
       ↑  +2  ↓     ответ

      В этом XML title и description - имеют совершенно другое значение. Это название ШАБЛОНА, а не страницы.

      К тому же использовать $mainframe->getPageTitle() - не правильно! Это устаревшее API. Нужно делать так

      $document = & JFactory::getDocument();

      $document->getTitle();

  • emil
    emil
    01 Августа 2011, 15:22
     ↑  -3  ↓     ответ

    что то никак не могу понять назначение директивы <positions>

    как оно работает на примере кто подскажет?

  • aYo_11
    aYo_11
    09 Ноября 2012, 20:45
     ↑  0  ↓     ответ

    Да, действительно, есть такие люди, которые не знают, как использовать <positions>. Напишите, пожалуйста, где об этом можно узнать подробнее. Спасибо!

  • Johar
    Johar
    18 Марта 2013, 00:25
     ↑  0  ↓     ответ

    А если в positions не указать все позиции прописанные DIVами, то их все равно можно будет использовать в шаблоне?

  • Планшетный пк
    Планшетный пк
    05 Августа 2013, 19:08
     ↑  0  ↓     ответ

    position это позиции вывода модулей и плагинов в шаблоне, так мне видиться

Оставить комментарий




* обязательно для заполнения

1 введенный почтовый адрес используется только для обратной связи при ответах в комментариях и сервиса gravatar.com
.