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 - список явно определенных позиций шаблона.


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

Смотрите также:
Комментарии (7) Добавить комментарий
  • антигерой
    антигерой
    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 это позиции вывода модулей и плагинов в шаблоне, так мне видиться

  • Ссылка на источник
    Ссылка на источник
    16 Апреля 2017, 18:00
     ↑  0  ↓     ответ

    I would like to use the opportunity of saying thanks to you for that professional suggestions I have continually enjoyed visiting your site.

    We are looking forward to the particular commencement of my school research and the overall groundwork

    would never have been complete without surfing your website.

    If I can be of any assistance to others, I will be ready to help as a result of what I

    have gained from here.

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




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

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