Настройка

Чтобы обеспечить как можно больше гибкости, Warp Framework применяет специальный каскад файлов. Если Вы включаете какой-либо файл CSS, JS или файлы шаблона PHP, Warp ищет последовательно в определенных папках наличие этих файлов, и в этом случае первый найденный файл будет загружен. Это дает Вам полную гибкость, чтобы переопределить любой важную файл, свзяанный с шаблоном.
Мы объясним, что значит переопределение каскадом, немного далее. Если Вы просто хотите знать, как переопределить файлы шаблона, изучите примеры в статье.

Переопределение каскадом

Для примера, возьмем папку /layouts для изучения иерархии файлов Warp.

1. Styles папка

Папка /styles/STYLE-NAME/layouts Вашего шаблона наверху иерархии, и те модификации или дополнения, которые Вы делаете здесь, переопределят все другие файлы шаблона. Также эта папка будет сохранена во время обновлений, таким образом, это будет самое безопасное место, чтобы сделать Ваши модификации.

2. Папка шаблона

Папка шаблона /layouts - это место, где хранятся все файлы макета шаблона.

3. Systems folder

Папки /warp/systems/joomla/layouts или /warp/systems/wordpress/layouts обеспечивает отдельную систему реализации, чтобы интегрироваться с определенными CMS. Этот уровень заставляет Warp адаптироваться к определенной системе, чтобы сформировать непротиворечивый API для разработки шаблона.

4. Warp folder

Папка /warp/layouts папка содержит основные переопределения, сделанные ядром фреймворка. Каждая ядра универсальна и разработана, чтобы работать на каждой поддерживаемой системе. Каскад для папок /js, /css и /layouts определяется в файле шаблона config.php. Если вы хотите зарегистрировать другие папки, вы можете сделать так.

Переопределение макета

Чтобы настроить основной макет шаблона, Вы должны переопределить файл /layouts/theme.php. Для этого создайте папку /styles/STYLE-NAME/layouts, скопируйте файл в нее и начните добавлять свой собственный код PHP.
Таким образом, Вы можете также переопределить системные файлы. Например, просто возьмите макет статьи Joomla - файл /warp/systems/joomla/layouts/com_content/article/default.php и скопируйте его в свою папку стиля /styles/STYLE-NAME/layouts/com_content/article/default.php, затем измените его. Теперь Ваш измененный файл макета статьи будет использоваться вместо системного макета по умолчанию. То же самое касается файлов WordPress.

Добавление собственного CSS

Есть несколько способов добавить Ваш собственный CSS к шаблону Warp. Вы можете использовать Customizer, чтобы изменить большинство аспектов темы, не имея необходимости писать какой-либо код CSS. Следует иметь в виду, что Ваш стиль будет показан в Customizer только в том случае, если style.less файл будет размещен в папке стиля. Когда Вы будете использовать Customizer, изменения будут сохранены в файле style.less. Вместе с файлами LESS шаблона это будет скомпилировано в файл /css/theme.css и переопределит любые настройки, которые Вы, возможно, сделали.

Добавление своего CSS - 1 вариант

Вы можете использовать Customizer и также добавить Ваш собственный CSS, создав custom.css файл в папке /css для связанного стиля. Таким образом Ваш CSS не будет перезаписан, когда Вы сохраните изменения в Customizer.

Добавление CSS без использовани LESS и Customizer

Если Вы не планируете использовать Customizer вообще, просто скопируйте существующий стиль и удалите style.less файл. Теперь /css/theme.css больше не будет перезаписываться при компиляции LESSЕ. Вы можете внести изменения непосредственно в theme.css файл.

Добавление собственного JavaScript

Конфигурационный файл /layouts/theme.config.php инициализирует все классы PHP и загружает необходимый JavaScript. Если Вам нужно загрузить пользовательские файлы JavaScript, это - именно то место, чтобы сделать это. Включенное сжатие и URI Data будут применены автоматически ко всем файлам, которые Вы добавляете здесь.

1. Создайте новый файл /styles/STYLE-NAME/layouts/theme.config.php.
2. Загрузите исходный файл через PHP при помощи функции require.
3. Затем добавьте свой файл JavaScript к набору asset, таким образом, он будет добавлен автоматически к  шапке шаблона.
4. Вставьте свой собственный JavaScript файл в папку /styles/STYLE-NAME/js/MY-JS.js.

<?php
require(__DIR__.'/../../../layouts/theme.config.php');
// add script
$this['asset']->addFile('js','js:MY-JS.js');

Собственные файлы шаблона для WordPress

Вы можете использовать различные макеты для шаблонных файлов, например страницы, создавая файлы в Вашей папке шаблона с префиксом -page, сопровождаемом ID или page-slug.

• page-{id}.php
• page-{slug}.php

Скажем, вы хотите собственный контент для страницы с ID 80. Создайте файл в папке шаблона page-80.php с таким содержанием: <?php get_header();?> Put your content here... <?php get_footer();?>