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

если кратко, то выглядит это следующим образом

По умолчанию все шаблоны сайта должны ра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

• Описание шаблона через templateDetails.xml
• Создание своего стиля сhrome для модулей
• Как добавить новую позицию в шаблон?
• Чистый шаблон для Joomla 1.5, 1.7
• Условия в шаблонах c помощью countModules
• Создание шаблона