Файлы и папки шаблона, общая структура
рейтинг: 8.5/10, голосов: 22
если кратко, то выглядит это следующим образом
По умолчанию все шаблоны сайта должны ра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
