Печать

Файлы и папки шаблона, общая структура

По умолчанию все шаблоны сайта должны раcполагаются в директории "/templates", которая находится в корне. Допустим наш шаблон будет называться "my_template", тогда струтктура типичного шаблона, будет следующая. Для примера назовем наш шаблон "my_template". Начиная с директории

  • /templates/my_template/
    • css/ - различные файлы стилей для шаблона (например reset.css, styles.css, ie.css и т. д.)
    • html/- папка, в которой лежат переназначеные шаблоны для модулей и компонентов системы
      • modules.php - собственные chrome-функции
      • pagination.php - шаблон для постраничной навигации
      • com_content
      • com_search
      • mod_breadcrumbs
      • mod_search
      • ... и т. д.
    • js/ - файлы сценариев JavaScript (jquery.js, mootools.js, scripts.js)
    • images/ - картинки, необходимые для правильного отображения дизайна сайта
    • php/ - дополнительные файлы php
    • component.php - шаблон версии для печати
    • error.php - шаблон вывода фатальных ошибок
    • index.html - заглушка
    • *index.php - основной шаблон с разметкой всех блоков
    • offline.php - шаблон для отключенного сайта
    • params.ini - файл с текущими настройками (только для J!1.5)
    • raw.php - пустой шаблон, необходим для ajax
    • template_thumbnail.png - миниатюрный скриншот шаблона
    • *templateDetails.xml - метаданые шаблона (название, настройки, лицензия, авторство, описание и т. д.)

Элементы отмеченые звездочкой (*) обязательны для работы шаблона (для его минимального функционала).

а теперь обо всем подробно и по порядку

Шаблон должен быть сохранен в определенной структуре каталогов:

/templates/<имя_шаблона>/
/templates/<имя_шаблона>/css/
/templates/<имя_шаблона>/images/
/templates/<имя_шаблона>/js/
/templates/<имя_шаблона>/html/

Имя шаблона не может содержать пробелов и других специальных символов. Рекомендуем называть шаблон строчными латинскими буквами. В зависимости от операционной системы, экзотические комбинации символов могут стать главной причиной массы проблем. В добавок имя должно быть осмысленным. Здесь в качестве имени шаблона выбрано "my_template".

В каталогах шаблона должны быть представлены различные файлы с предопределенными именами. Вот основные из них:

Основной файл разметки. Это HTML-файл

/templates/my_template/index.php

Он должен заканчиваться на ".php", поскольку элементы динамического модуля Joomla должны интерпретироваться РНР. 

Изображение предварительного просмотра. Файл картинки

/templates/my_template/template_thumbnail.png

содержит изображение предварительного просмотра вашего шаблона, которое предназначено для предпросмотра в менеджере шаблонов. Изображения предварительного просмотра имеют тип-png размером примерно 200x150 пикселей. Вы можете создать этот файл позднее, когда увидите готовый шаблон. 

Метаданные шаблона.

/templates/my_template/templateDetails.xml

Файл представляет техническое руководство для инсталлятора шаблонов и содержит инсталляции для выбора шаблона в диспетчере шаблонов. Здесь вы специфицируете место, куда должны копироваться файлы, кто их автор, а также дополнительные метаданные о шаблоне. Во время последующей инсталляции этого файла инсталлятором Joomla, РНР читает его и копирует файлы в места, специфицированные XML-файлом. Для каждого файла, который применяется в шаблоне, соответствующий контейнер XML должен быть наполнен именем файла и корректным путем. 

CSS-файлы. Для разрабатываемого шаблона можно использовать несколько CSS-файлов. Какое имя вы дадите файлу CSS, и как создадите его — дело ваше. Однако для разных элементов CSS предусмотрены разные каталоги. Для первой попытки вам понадобится CSS-файл по имени /templates/my_template/css/template.css. 

Графика, изображения, флеш. Здесь можно ввести определенные пользователем файлы изображений, которые понадобятся в шаблоне для дизайна. Инсталлятор затем скопирует эти файлы в папку images. Имя файла выглядит как

/templates/my_template/images/[определенный_пользователем_файл_изображения]

Версия для печати. Шаблон версии для печати для компонента.

/templates/my_template/component.php

Файл хранения настроек шаблона. (только для J!1.5) Через файл templateDetails.xml можно указать свои настройки. После сохранения настроек через Менеджер шаблонов, в папке появится файл

/templates/my_template/params.ini

Шаблон offline-страницы. Если сайт отключен через панель управления, то отобразиться именно этот шаблон.

/templates/my_template/offline.php
Интересная статья? Поделись ей с другими: