Объяснение структуры папок
Это действительно удобно, так как все связанные с фреймворком файлы расположены в одном месте, в папке под названием warp. Эта папка находится непосредственно в каждом шаблоне. И здесь не существует никакой зависимости от других компонентов или плагинов. Ничего не нужно устанавливать или развивать отдельно.
Warp Framework разделяется на три уровня. Первый уровень - это ядро фреймворка, которое обеспечивает базу CSS стилей, библиотеки эффектов JavaScript и коллекции вспомгательных классов PHP. Каждая часть ядра фреймворка универсальна и предназначена для работы на каждой поддерживаемой системе. Второй уровень - зависит от системы; он обеспечивает индивидуальные системную реализацию, необходимую для интеграции с конкретной CMS. Этот уровень адаптирует Warp Framework к определенной системе с целью формирования соответствующего API (Интерфейс программирования приложений) для разработки шаблонов. Третий уровень - определяется шаблоном; это уровень, который располагает файлами, специфичными для каждого шаблона. Это "рабочая площадка", где хранятся все пользовательские файлы HTML,CSS,JavaScript, а также картинки для выбранного шаблона.
Чтобы обеспечить максимальную гибкость в Warp Framework был внедрена специальная последовательность файлов. Если вы включаете любой файл, например CSS,JS или PHP файлы шаблона, Warp Framework проведет поиск файлов в специальных папках и загрузит первый найденный файл. Далее представлена последовательность:
- папка шаблона
- специальная системная папка, например /warp/systems/joomla
- папка Warp Framework
Это дает вам полную свободу при переопределении любых важных файлов, связанных с работой шаблона. Далее будет представлен краткий обзор наиболее важных файлов, которые могут понадобиться вам при настройке шаблона, созданного на технологии Warp Framework.
Styles (стили)
Стили - это варианты дизайна основного шаблона, аналогичные концепции "дочерних" тем в Wordpress или подшаблонов в Drupal. Стили определяют уровень после основного шаблона и могут наследовать или переопределять ресурсы из "родительского" шаблона. Warp Framework производит последовательный поиск определенных файлов, до того момента, пока не найдет их. Это дает вам полную свободу в изменении любого файла основного шаблона. Каждый стиль расположен в собственной папке в каталоге /styles шаблона и может обеспечивать собственные HTML макеты, CSS, JavaScript и изображения. Урок о создании нового стиля объясняет то, как можно создать собственный стиль для шаблона.
Layouts (макеты)
Основной файл шаблона /layouts/template.php - это своеобразное "сердце" каждого шаблона, которое обеспечивает полную разметку для базового макета шаблона. Эта идея отличается от стандартных шаблонов Joomla и Wordpress, где основным файлом является index.php, расположенный в корневой папки шаблона. Второй по важности файл - это /layouts/template.config.php, который включает в себя некоторые расчеты формы макета и определяет все CSS и JavaScript файлы шаблона. Если обобщить:
- Файл шаблона: /layouts/template.php
- Файл конфигурации шаблона: /layouts/template.config.php
MODULES (модули)
Модули или виджеты могут отображаться в различных стилях с добавлением различных иконок и значков. Файл /layouts/module.php заботится об отображении всех вариантов модулей. В зависимости от выбранного стиля module.php загружает нужную HTML разметку из предустановленных тем модулей. Далее фреймворк поставляется с тремя широко используемыми макетами расположения модулей: equal (равное расположение), double (в зависмости от размеров) и stacked (один над другим), которые используются для расположения модулей рядом друг с другом или одних модулей над другими. В совокупности:
- Стили модулей: /layouts/module.php
- Макеты модулей: /warp/layouts/modules/layouts/
- Темы модулей: /warp/layouts/modules/templates/
Таблицы стилей (Stylesheets)
Файлы CSS практически как и сам фреймворк, делятся на три уровня и помещаются в соответствующие уровням папки: специфичные для шаблона /css, зависящие от системы /warp/systems/joomla/css и стили фреймворка /warp/css. Включить эти файлы на самом деле просто, так как Warp Framework также использует вспомогательные классы, для определения их места расположения в различных папках. Далее представлен обзор различных css файлов:
- base.css - Устанавливает базовые основы для снижения несоответствия отображения между браузерами
- layout.css - Обеспечивает разметочную сетку (grid) и вспомогательные классы для создания любых макетов.
- menus.css - Определяет базовые стили для выпадающего меню, линейного меню и меню типа аккордеон.
- modules.css - Определяет общий стиль модулей, заголовков, значков и иконок.
- tools.css - Определяет полезный набор CSS классов для контента, например стили для списков и блоков
- system.css - Определяет базовый стиль для системной HTML разметки Joomla и Wordpress
- rtl.css - используется для локализаций языков типа "справа-налево"
- print.css - используется при печати
- mobile.css - стили шаблона для отображения в мобильных телефонах
- ie.css, ie7.css, ie8.css - стили для загрузки определенными версиями браузера Internet Explorer
- style.css - Определяет основной вид шаблона, например цвет и бэкграунды (фон) в одном месте
- custom.css - Используется для создания стилей пользовательского контента. По умолчанию пуст.
JavaScript
Warp Framework также обеспечивает библиотеку эффектов JavaScript, используемую в выпадающем меню и меню типа аккордеон, в поиске, созданном на технологии AJAX и для мобильных телефонов. Файлы JavaScript также структурированы и располагаются в собственных папках: конкретных для каждого шаблона - /js, зависящих от системы - /warp/systems/joomla/js и скрипты фреймворка - /warp/js. Все скрипты настраиваются в одном файле - /js/template.js. Этот файл используется для включения или отключения эффектов, которые загружаются с шаблоном. Для обощения:
- JavaScript шаблона: /js/template.js
СИСТЕМНАЯ разметка
Каждая система имеет набор макетов, которые определяют HTML разметку для вывода ядра CMS. Для Joomla это, в первую очередь, переопределения HTML (overriders), которые используются шаблоном для отображения содержимого системных компонентов или модулей, таких как авторизация или поиск. Файлы Joomla 1.7 (пр. скорее всего и Joomla 2.5) расположены в /warp/systems/joomla/layouts. В Wordpress макеты обеспечивают HTML разметку для различных страниц, например главной страницы блога, архива или одиночного поста. Файлы Wordpress расположены в /warp/systems/wordpress/layouts. Чтобы не усложнять, Warp Framework в основном использует тот же HTML вывод для всех поддерживаемых систем. Независмо от того, что вы смотрите, статью категории в компоненте Joomla или пост из категории Wordpress, Warp Framework отображает HTML. Это позволяет создавать универсальные CSS правила, которые будут применимы для обеих CMS. Подводя итоги:
- Системные файлы Joomla 1.5: /warp/systems/joomla1.5/layouts
- Системные файлы Joomla 1.7/2.5: /warp/systems/joomla/layouts
- Системные файлы Wordpress: /warp/systems/wordpress/layouts