Объяснение структуры папок

Warp Framework имеет вспомогательные классы HTML, CSS, JavaScript и PHP, чтобы охватить все аспекты разработки шаблонов

Это действительно удобно, так как все связанные с фреймворком файлы расположены в одном месте, в папке под названием 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
  • Среда, 30 мая 2012

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

Вы комментируете как Гость.

beget